> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lantern.is/llms.txt
> Use this file to discover all available pages before exploring further.

# activity_feed

> Access the customer's recent activity and engagement events.

## Syntax

<Tabs>
  <Tab title="Liquid">
    ```liquid theme={null}
    customer.metafields.lantern.activity_feed
    ```
  </Tab>
</Tabs>

## Description

The `activity_feed` metafield contains the customer's recent activity events for display in customer dashboards or activity summaries. This includes metrics-tracked events like purchases, referrals, and other engagement activities.

<Info>
  The activity feed metafield contains JSON data that must be parsed using Liquid's `parse_json` filter before accessing individual properties.
</Info>

## Properties

**Type:** `JSON Object`
**Namespace:** `lantern`

## Return Values

| Scenario                     | Value                                 | Type        |
| ---------------------------- | ------------------------------------- | ----------- |
| Customer has activity events | Activity feed object                  | JSON Object |
| Customer has no activity     | `{"events": []}` (empty events array) | JSON Object |
| Logged out                   | `null`                                | null        |

## Activity Feed Structure

* `events` (array): list of recent customer activity events.

### Event Object Structure

Each event in the `events` array contains:

| Field           | Type   | Description                   |
| --------------- | ------ | ----------------------------- |
| `id`            | string | Unique event identifier       |
| `data`          | object | Event-specific data payload   |
| `timestamp`     | string | Event timestamp in ISO format |
| `metric.id`     | string | Metric identifier             |
| `metric.name`   | string | Human-readable metric name    |
| `metric.handle` | string | Metric handle/slug            |

## Examples

### Basic Activity Display

```liquid theme={null}
{% assign activity_data = customer.metafields.lantern.activity_feed %}
{% if activity_data %}
  {% assign activity = activity_data | parse_json %}
  
  {% if activity.events.size > 0 %}
    <div class="activity-feed">
      <h3>Recent Activity</h3>
      {% for event in activity.events %}
        <div class="activity-item">
          <h4>{{ event.metric.name }}</h4>
          <p>{{ event.timestamp | date: '%B %d, %Y' }}</p>
        </div>
      {% endfor %}
    </div>
  {% endif %}
{% endif %}
```