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

# Activity feed

> View a real-time event stream of user actions including page views, wallet connects, signatures, and transactions to understand product usage.

Track every user interaction with powerful real-time event analytics. Formo automatically captures page views, wallet connects, signatures, and transactions on your app.
You can also track [custom events](/features/product-analytics/custom-events) and [contract events](/features/product-analytics/contract-events).

<Frame caption="The activity feed shows you what users are doing in real-time.">
  <img src="https://mintcdn.com/formo/cbQmDchGZwlIhnW1/images/dapp-analytics-activity-1.png?fit=max&auto=format&n=cbQmDchGZwlIhnW1&q=85&s=3308dea50b7a6b38dd3c30a03d4f54c3" alt="Product Analytics Activity" width="1491" height="758" data-path="images/dapp-analytics-activity-1.png" />
</Frame>

Get full visibility on key touchpoints in the user lifecycle to identify drop-off points and boost retention. You can see what users do, full event properties, and other data without sampling.

## Filter by event properties

Filter the activity feed by event properties to focus on specific user actions or behaviors.

<Frame caption="Filter by any property to understand what users are doing.">
  <img src="https://mintcdn.com/formo/5S3MPZWP8GYgbzVs/images/filter-properties.png?fit=max&auto=format&n=5S3MPZWP8GYgbzVs&q=85&s=09a2d5a89c442ca214ca5a4be7ba8857" alt="Product Analytics Activity" width="520" height="474" data-path="images/filter-properties.png" />
</Frame>

Use filters to narrow down events by any property, making it easy to investigate specific user journeys or troubleshoot issues.

***

## How to use the activity feed

The Activity Feed is your real-time view into what users are doing on your app. This guide shows you how to use it for investigation and user research.

### Step 1: Open the Activity Feed

<Steps>
  <Step title="Go to the Formo Dashboard">
    Open [app.formo.so](https://app.formo.so).
  </Step>

  <Step title="Select your project" />

  <Step title="Click Activity in the left navigation" />
</Steps>

You'll see a chronological stream of all events on your app.

### Step 2: Understand event types

Each event has a structured schema and type based on the [event specs](/data/events/overview):

| Event Type    | What it captures        |
| ------------- | ----------------------- |
| `page`        | Page view with URL path |
| `connect`     | Wallet connection       |
| `disconnect`  | Wallet disconnection    |
| `signature`   | Message signing         |
| `transaction` | Onchain transaction     |
| `track`       | Custom events           |
| `decoded_log` | Smart contract events   |

Click any event to expand and see all properties.

<Frame caption="Each event has full properties and metadata available for deeper analysis.">
  <img src="https://mintcdn.com/formo/cbQmDchGZwlIhnW1/images/activity-expand.png?fit=max&auto=format&n=cbQmDchGZwlIhnW1&q=85&s=491cc16f82bc1b3b690e0bd4056c9821" alt="Product Analytics Event Properties" width="1139" height="637" data-path="images/activity-expand.png" />
</Frame>

### Step 3: Filter to find specific events

Use filters to narrow down the feed:

<Steps>
  <Step title="Click Filter" />

  <Step title="Choose a property to filter by" />

  <Step title="Set the condition and value" />
</Steps>

**Common filter combinations:**

| Goal                             | Filters                                   |
| -------------------------------- | ----------------------------------------- |
| Connects from Twitter            | type = connect, referrer contains twitter |
| Visitors from marketing campaign | utm\_source = newsletter                  |
| Events from mobile devices       | device = mobile                           |
| Failed transactions              | type = transaction, status = failed       |
| Wallet connects from Twitter     | type = connect, referrer contains twitter |
| Specific user's activity         | address = 0x...                           |
| Events on a specific page        | path = /swap                              |
| High-value transactions          | type = transaction, value > 1000          |

<Frame caption="Filter by any property to focus your investigation.">
  <img src="https://mintcdn.com/formo/5S3MPZWP8GYgbzVs/images/filter-properties.png?fit=max&auto=format&n=5S3MPZWP8GYgbzVs&q=85&s=09a2d5a89c442ca214ca5a4be7ba8857" alt="Activity Filters" width="520" height="474" data-path="images/filter-properties.png" />
</Frame>

### Step 4: Investigate a user's journey

To see everything a specific user did:

<Steps>
  <Step title="Find any event from that user" />

  <Step title="Click the wallet address" />

  <Step title="View their complete Wallet Profile">
    See [Wallet Profiles](/features/wallet-intelligence/wallet-profiles) for more details.
  </Step>
</Steps>

<Frame caption="View a user's activity feed.">
  <img src="https://mintcdn.com/formo/N-uk5SnfJVeheQMa/images/screenshots/wallet-profile-activity.png?fit=max&auto=format&n=N-uk5SnfJVeheQMa&q=85&s=a1074cf9ad94c7e5f8efa784cc9a382b" alt="Wallet Profile Activity Feed" width="2418" height="1512" data-path="images/screenshots/wallet-profile-activity.png" />
</Frame>

Or filter the Activity Feed:

<Steps>
  <Step title="Add filter: address = [wallet address]" />

  <Step title="See all events from this user in chronological order" />
</Steps>

### Step 5: Investigate issues

When users report problems, use the Activity Feed to investigate:

**Investigating a failed transaction:**

<Steps>
  <Step title="Filter by type = transaction and status = failed" />

  <Step title="Find the user's transaction" />

  <Step title="Click to expand and see error details" />

  <Step title="Check the preceding events for context" />
</Steps>

**Investigating a drop-off:**

<Steps>
  <Step title="Filter by the user's address" />

  <Step title="Look at their event sequence" />

  <Step title="Identify where they stopped (last event before leaving)" />

  <Step title="Check for errors or unusual patterns" />

  <Step title="Use Funnels to measure drop-off rates at each step">
    See [Funnels](/features/product-analytics/funnels) for more details.
  </Step>
</Steps>

**Investigating a flow issue:**

<Steps>
  <Step title="Filter by a specific page path" />

  <Step title="Look at what users do after visiting that page" />

  <Step title="Identify unexpected patterns" />

  <Step title="Use Flows to visualize common paths users take">
    See [Flows](/features/product-analytics/flows) for more details.
  </Step>
</Steps>

### Common investigation patterns

**"Why are users bouncing from our swap page?"**

<Steps>
  <Step title="Filter: path = /swap" />

  <Step title="Look at events that follow page views" />

  <Step title="Count how many lead to connect vs. leaving" />

  <Step title="Check for errors or unusual device/browser patterns" />
</Steps>

**"Which transactions are failing?"**

<Steps>
  <Step title="Filter: type = transaction, status = failed" />

  <Step title="Group by error message or contract" />

  <Step title="Identify the most common failure reasons" />

  <Step title="Check if failures correlate with specific flows" />
</Steps>

**"What do our best users do differently?"**

<Steps>
  <Step title="Identify a power user from the Users list" />

  <Step title="Filter Activity by their address" />

  <Step title="Study their event sequence" />

  <Step title="Compare to average user patterns" />
</Steps>

**"Is our new feature being used?"**

<Steps>
  <Step title="Filter by your custom event or page path" />

  <Step title="See adoption over time" />

  <Step title="Check which user segments are using it" />

  <Step title="Look at the referrer to see how users find it" />
</Steps>

### Next Steps

<CardGroup cols={2}>
  <Card title="Live View" icon="globe" href="/features/product-analytics/live-view">
    Real-time activity on a globe
  </Card>

  <Card title="Wallet Profiles" icon="user" href="/features/wallet-intelligence/wallet-profiles">
    Drill into individual users
  </Card>

  <Card title="Custom Events" icon="bolt" href="/features/product-analytics/custom-events">
    Track more actions in the feed
  </Card>

  <Card title="Alerts" icon="bell" href="/features/product-analytics/alerts">
    Get notified of important events
  </Card>
</CardGroup>
