activity_feed

Syntax

Liquid

customer.metafields.lantern.activity_feed

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.

The activity feed metafield contains JSON data that must be parsed using Liquid’s parse_json filter before accessing individual properties.

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

{% 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 %}

Overview

Liquid API

Window API

REST API

Syntax

Description

Properties

Return Values

Activity Feed Structure

Event Object Structure

Examples

Basic Activity Display

​Syntax

​Description

​Properties

​Return Values

​Activity Feed Structure

​Event Object Structure

​Examples

​Basic Activity Display

Syntax

Description

Properties

Return Values

Activity Feed Structure

Event Object Structure

Examples

Basic Activity Display