# Events explorer

> Query raw events in ClickClacks: pick an event and filters, choose columns, read feature adoption, inspect a row, follow a live tail, export CSV and move with keyboard shortcuts.

- Canonical URL: https://clickclacks.io/docs/guides/events
- Section: Product guides
- Last updated: 2026-09-26

Events is the raw stream: every event your sources sent, newest first. Use it to check what is really being tracked, find specific events, and see how widely a feature is used.

## When to use it {#when}

- “Is `Invoice paid` firing, and with which properties?”
- “How many people used export this week, and how often?”
- “Show me every click on the Upgrade button yesterday.”

## Query events {#query}

1. Open **Events** under Data.
2. Under **Select event**, keep **All events** or pick one.
3. Click **Add** next to _where_ to filter by a property. It works like the [report filter builder](https://clickclacks.io/docs/guides/filters.md#property-filters), with the same operators.
4. Set the date range, source, segment and Compare in the filter bar.

**Hide filter** folds the query builder away when you want more room for the table.

## Feature adoption {#adoption}

Once you pick an event, **Feature adoption** appears above the table. It charts **Occurrences**, **Unique people** and **Uses per person**, grouped by Day or Week, with changes against the previous period. **Break down by** splits it by a [property](https://clickclacks.io/docs/glossary.md#term-property) and shows the top 10 values. Click a bar or a row to see those events.

## The table {#table}

- Columns are the event, up to three property columns you choose with **Edit columns**, the person and the time.
- Hover a person to see a card with their events, sessions and when they were last seen. Press `P` or click to open them.
- Click a row to expand it. Tabs show **Your properties**, **ClickClacks properties** (what the tracker adds) and **JSON**. Buttons take you to **View session**, **View profile** or **Filter by this event**.
- Click a property value to filter to it, see the people with it, or copy it.
- **Search this page** filters only the 50 rows on screen. For everything, use the query builder.

## Live tail {#live}

Click **Live tail** to add new events to the top as they arrive, following your filters. The button reads _Live_ while it is connected. It keeps the newest 50. For a full live view with who is on your site, use [Realtime](https://clickclacks.io/docs/guides/realtime.md).

## Save, share and export {#save}

- **Save view** › **Copy link** copies a link with your event, filters and columns.
- **Save view** › **Add to board** puts an event table on a board.
- **Export** downloads the matching events as a CSV, using the current filters.

## Keyboard shortcuts {#keys}

| Key | What it does |
| --- | --- |
| `J / K` | Move through rows |
| `Enter` | Expand or collapse the row |
| `P` | Open the person |
| `/` | Focus search |
| `F` | Add a condition |
| `?` | Show keyboard shortcuts |
| `Esc` | Close the top layer |

## Tips and gotchas {#tips}

- **New events appear within seconds** of being sent.
- **No match?** When nothing matches an event name, the page suggests the closest event names you do send. A typo such as `Signed Up` against `Signed up` is common.
- **Widen to 12 months** when looking for a rare event.

## Recipes {#recipes}

### Is my new event firing with the right properties?

1. Pick the event under **Select event** and set the dates to **Today**.
2. Expand a row and read **Your properties**.
3. Turn on **Live tail** and trigger the event again to watch it arrive.

### How widely is the export feature used?

1. Pick `Export created` and set the dates to **Last 30 days**.
2. Read **Feature adoption**: unique people and uses per person, week by week.
3. Choose **Break down by** and a property the event carries, such as `plan`, to see who uses it most.

### Every click on the Upgrade button yesterday.

1. Pick the click event (`$click`) and set the dates to **Yesterday**.
2. Add a filter: **Clicked text** _contains_ `Upgrade`.
3. Click **Edit columns** and add **Page**.

## Related {#related}

- [Realtime](https://clickclacks.io/docs/guides/realtime.md)
- [Lexicon](https://clickclacks.io/docs/guides/lexicon.md): Describe and tidy event names.
- [Events and identify](https://clickclacks.io/docs/events.md): Send your own events.
- [People and profiles](https://clickclacks.io/docs/guides/people.md)