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

# Sessions & Stickiness

> Session volume, unique sessions, and engagement ratios — DAU/MAU and WAU/MAU.

Sessions tell you how often people come back. Stickiness tells you what fraction of your monthly audience is active on any given day or week — a direct measure of engagement.

## Quick start

```bash theme={null}
# Session volume over the last 30 days
tell metrics sessions --range 30d

# Daily stickiness (DAU/MAU ratio)
tell metrics stickiness --range 30d --type daily
```

## Session metrics

**Session volume** — total session count over time. Each session record counts as one.

**Unique sessions** — distinct session IDs per time bucket. Filters out duplicate records for the same session.

```bash theme={null}
# Unique sessions, weekly buckets
tell metrics sessions --range 90d --granularity weekly --type unique
```

Via the API:

```bash theme={null}
# Session volume
curl "https://your-tell-server/api/v1/metrics/sessions?range=30d" \
  -H "Authorization: Bearer $TOKEN"

# Unique sessions
curl "https://your-tell-server/api/v1/metrics/sessions/unique?range=30d" \
  -H "Authorization: Bearer $TOKEN"
```

## Top sessions

See which device types, countries, or operating systems generate the most sessions:

```bash theme={null}
# Top 10 device types by session count
curl "https://your-tell-server/api/v1/metrics/sessions/top?range=30d&property=device_type&limit=10" \
  -H "Authorization: Bearer $TOKEN"
```

Available groupings: `device_type`, `country`, `operating_system`, or any field in the context table.

## Stickiness

Stickiness measures what proportion of your user base is active in a shorter window. Higher stickiness means better engagement.

**Daily stickiness** = DAU / MAU. A value of 50% means half your monthly users visit every day.

**Weekly stickiness** = WAU / MAU. A value of 80% means most monthly users visit at least once a week.

```bash theme={null}
# Daily stickiness with weekly granularity
tell metrics stickiness --range 90d --type daily --granularity weekly

# Weekly stickiness
tell metrics stickiness --range 90d --type weekly
```

Via the API:

```bash theme={null}
curl "https://your-tell-server/api/v1/metrics/stickiness/daily?range=30d" \
  -H "Authorization: Bearer $TOKEN"
```

## Breakdowns and comparison

Session metrics support the same [filtering and breakdowns](/analytics/filtering) as all other metrics — split by any field, compare to the previous period, and control time granularity.

```bash theme={null}
# Sessions by country, compared to previous period
tell metrics sessions --range 30d --breakdown country --compare previous
```