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

# Event Analytics

> Analyze custom event names and properties, follow their trends, and inspect a live searchable log of the events arriving from your site.

The Events explorer shows the custom events your site sends, ranked by how often they fire. Expand any event to see a breakdown of the properties recorded on it — the keys and values you passed, with a count for each. It's how you turn `event('purchase', { plan: 'pro' })` calls into answers about what people do.

## Which events appear in the list?

The main view lists each custom event by name with its total count, most frequent first. These are the events you send with [`event()`](/docs/custom-event-tracking) — `signup`, `purchase`, `newsletter_signup`, and so on. Pageviews aren't listed here; they have their own reports.

## How do I break an event down by property?

Expand an event to sample its properties. For each property key, you see the values that appeared and how many times — so `purchase` expands to show the split across `plan` values like `pro` and `free`, or `billing` values like `monthly` and `annual`. This is where event properties pay off: send the things that vary as properties, and break them down here.

## How do I read the Events page?

The **Events** page in your site's sidebar pairs a trend chart with a live log of individual events, for when you need to watch events arrive rather than read them in aggregate.

The chart has two tabs. **Custom Events** plots one line per event name; **Event Types** plots one line per event type, fixed at the 9 biggest. On the Custom Events tab, a **Top** select chooses how many event names to plot — 1, 3, 5, 8, or 10, defaulting to **Top 5**. A second select sets the bucket width: **Hour**, **Day**, **Week**, or **Month**, offering only the buckets your date range is wide enough to fill.

Each line has a chip in the legend showing its color, name, and total. **Click a chip to hide that series** and read the rest without it; click again to bring it back. Hidden series reset whenever you switch tabs, change the Top count, or change the date range.

## How do I watch events as they happen?

Below the chart, the **event log** lists individual events newest-first, 100 at a time, loading more as you scroll toward the bottom.

<Note>
  **Realtime is on by default**, refreshing the log every 5 seconds. The **Realtime** toggle above the log turns it off when you'd rather hold a stable view.
</Note>

Scrolling into older events pauses the live stream automatically, so new arrivals can't shift the rows out from under you. A banner reads **"Live updates paused while browsing older events"** with a **Back to live** button that returns you to the top and resumes refreshing.

The search box filters the log as you type, matching event names, page paths, user IDs, and the traits of [identified users](/docs/user-identification-analytics).

<Warning>
  Search filters only the events **already loaded** into the log, not your full history. If you're looking for something older, scroll to load more events first, or narrow your date range and [filters](/docs/analytics-filters) instead.
</Warning>

## What does tinyanalytics capture automatically?

Alongside the events you send, tinyanalytics records interactions automatically — outbound link clicks, file downloads, button clicks, text copies, and form submissions. Each has its own type, so you can look at them separately from your custom events. See [what the script tracks out of the box](/docs/install-tinyanalytics-tracking-script#what-the-script-tracks-out-of-the-box).

Open the **Autocapture** dialog on the Events page to browse these by value: pick a type — outbound links, button clicks, form submissions, or copies — and see each distinct value with its count, its share of that type, and when it was last seen. It's the fastest way to find the exact link or button text before building an [autocapture goal or funnel](/docs/autocapture-analytics-events#which-autocaptured-events-can-i-build-goals-and-funnels-on) on it.

## Common workflows

* **Measure a key action.** Send a custom event for it, then track its count over time here.
* **Compare variants.** Break an event down by a property to compare plans, sources, or options.
* **Turn events into goals and funnels.** Once an event is firing, use it in [Goals](/docs/conversion-goal-tracking) and [Funnels](/docs/funnel-analytics).

## Frequently asked questions

<AccordionGroup>
  <Accordion title="Why don't pageviews show up in the Events explorer?">
    The tinyanalytics Events explorer lists only the custom events you send with [`event()`](/docs/custom-event-tracking), such as `signup` or `purchase`. Pageviews are excluded because they have their own reports — see [Pages](/docs/page-analytics) and the [Dashboard overview](/docs/web-analytics-dashboard).
  </Accordion>

  <Accordion title="How do I compare the values of an event property?">
    Expand the event in the tinyanalytics Events explorer. For each property key you see the values that appeared and how many times, so a `purchase` event expands to show the split across `plan` values like `pro` and `free`. Send the things that vary as properties so they break down here.
  </Accordion>

  <Accordion title="Why does the event log stop updating when I scroll down?">
    Scrolling into older events pauses the live stream on purpose, so incoming events can't shift rows while you're reading. A banner reads "Live updates paused while browsing older events" — click **Back to live** to return to the top and resume the 5-second refresh.
  </Accordion>

  <Accordion title="Why can't I find an older event with the log's search box?">
    Search matches only the events already loaded into the log, which starts at the newest 100 and grows as you scroll. It isn't a search over your full history. Scroll down to load more events, or narrow your date range and [filters](/docs/analytics-filters) to bring the event you want into range.
  </Accordion>

  <Accordion title="Which interactions does tinyanalytics track without any code?">
    tinyanalytics records outbound link clicks, file downloads, button clicks, text copies, and form submissions automatically, alongside the custom events you send. Each has its own type, so you can look at them separately. See [what the script tracks out of the box](/docs/install-tinyanalytics-tracking-script#what-the-script-tracks-out-of-the-box).
  </Accordion>
</AccordionGroup>

## Related

<Columns cols={2}>
  <Card title="Track custom events" icon="hand-pointer" href="/docs/custom-event-tracking">
    Send named events and properties from your site.
  </Card>

  <Card title="Goals" icon="bullseye" href="/docs/conversion-goal-tracking">
    Turn an event or page into a conversion goal.
  </Card>

  <Card title="Funnels" icon="filter-circle-dollar" href="/docs/funnel-analytics">
    Measure a sequence of events end to end.
  </Card>

  <Card title="Filter your data" icon="filter" href="/docs/analytics-filters">
    Narrow reports by event or property.
  </Card>
</Columns>


## Related topics

- [Autocapture Analytics Events](/docs/autocapture-analytics-events.md)
- [Custom Event Tracking](/docs/custom-event-tracking.md)
- [Track Events API](/docs/api-reference/track-events-api.md)