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

# Page scroll depth

> Clarity average scroll depth per canonical page.

| Contract           | Value                       |
| ------------------ | --------------------------- |
| Metric key         | `clarity.page_scroll_depth` |
| Source             | Microsoft Clarity           |
| Status             | active                      |
| Type               | source                      |
| Semantic version   | 1                           |
| Catalog visibility | Picker-eligible             |

## How it's calculated

```text theme={null}
value = session-weighted AVG(averageScrollDepth) across URL aliases for one snapshot.
```

### Built from

* `URL report ScrollDepth.averageScrollDepth`
* `Traffic.totalSessionCount`

## Known caveats

* Page Click Behavior session-weights snapshot averages and returns unavailable when weights are absent or known windows overlap.

## Where this appears

* Page Click Maps

<AccordionGroup>
  <Accordion title="Grain and identity" icon="ruler">
    page\_daily; entity: page; same-day fold: sum; additivity: non\_additive.

    **Join and identity keys**

    * projectId
    * snapshotDate
    * page\_url
  </Accordion>

  <Accordion title="Filters and boundaries" icon="filter">
    * Organization, store, and Clarity project are resolved server-side.
    * Reads use a half-open interval: recorded\_at >= start and recorded\_at \< end.
    * Page publication is limited to the top 100 canonical pages by sessions per snapshot.
  </Accordion>

  <Accordion title="Timezone, currency, and freshness" icon="clock">
    **Timezone.** Aloftly stamps Clarity snapshots to the previous UTC day. Initial multi-day provider windows can overlap later one-day snapshots.

    **Currency.** Not applicable.

    **Freshness.** Clarity daily sync.
  </Accordion>

  <Accordion title="Version history" icon="clock-rotate-left">
    | Date       | Change                                                         |
    | ---------- | -------------------------------------------------------------- |
    | 2026-08-03 | Bound the metric to the executable certified semantic release. |
    | 2026-07-27 | Registered Clarity behavior contracts in the semantic catalog. |
  </Accordion>
</AccordionGroup>