Sessions
Browse individual visitor sessions in Clics: landing and exit pages, duration, bounce, referrer, and the full page journey.
Sessions is the row-per-visit explorer in the dashboard. Open a project → Sessions to browse visits, then open one for the full journey.
What you see
- Title: Sessions, with a short note on browsing and filtering visits
- Filter and date range: same date picker as Overview
- Active filter chips: clear one-by-one or Clear Filters (Escape)
- Sessions table: sortable columns, infinite scroll (100 rows per page)
Click a row to open Session Details. There is no side panel: detail is a full page.
Table columns
| Column | Meaning |
|---|---|
| Started At | When the session began (default sort: newest first) |
| Referrer | Landing referrer domain; empty → Direct / none |
| Duration | Time from first to last hit (Xh Ym Zs) |
| Pageviews | Number of hits in the session |
| Bounce | Yes or No |
| Country | Visitor country |
| Device | Desktop, Mobile, or Tablet |
| Browser | Browser name |
| OS | Operating system |
| Landing Page | First path in the session |
| Exit Page | Last path in the session |
Empty state: No sessions match your current filters.
Session details
From a row:
- Back to sessions (keeps your current date range and filters)
- KPI cards: Duration, Pages Visited, Bounce
- Metadata: Session ID (click to copy), last seen, date, country, browser, OS, device, referrer, landing/exit pages, UTM fields
- Activity: timeline of pageviews and custom events for that visit
Activity timeline
- Pageview: pathname for each page load
- Custom events: event name, pathname, and properties (first few shown, then Show N more)
Missing session: Session not found / no match for project, environment, or date range.
API, SDK, CLI, and MCP
The same session data is available outside the UI:
| Surface | How |
|---|---|
| REST | GET /v1/projects/{project_id}/sessions, …/sessions/{session_id}, …/events |
| SDK | clics.sessions: listSessions, getSession, listSessionEvents |
| CLI | clics sessions list|get|events. See CLI |
| MCP | list_sessions, get_session, list_session_events. See MCP |
The public API supports period presets and domain scoping with cursor pagination. Rich dimensional filters (country, device, entry/exit, …) remain dashboard-only for now.
Bounce and duration
| Concept | Definition |
|---|---|
| Duration | Seconds between the first and last hit in the session |
| Bounce | First and last hit are the same moment, typically one pageview and 0s duration |
| Engaged | Visitor continued to other pages after the first view |
These match the bounce rate and session duration KPIs on Overview, shown here per visit instead of as aggregates.
Date range and filters
Date presets match Overview: Last 24 hours, Last 7 days (default), Last 30 days, Last 3 / 12 months, Month / Quarter / Year to Date, All Time, or custom range.
Available filters:
| Filter | Applies to |
|---|---|
| Country | Session country |
| Device | Device type |
| Browser | Browser |
| OS | Operating system |
| Page Entry | Landing pathname only |
| Page Exit | Exit pathname only |
| Referrer | Landing referrer (Direct / none for empty) |
Operators: is / is not. Multi-value.
Not available (Overview has them): any-page path, Hostname chip, Event, UTM fields, Goal. Environment still scopes production vs development (localhost) like the rest of the project.
Sessions vs Overview
| Overview | Sessions | |
|---|---|---|
| Focus | Aggregates (KPIs, charts, cards) | Individual visits |
| Bounce / duration | Rates and averages | Per-session Yes/No and seconds |
| Page filter | Any page | Entry or exit only |
| Drill-down | Cards and charts | Full Activity timeline |
Use cases
- See which referrers drive engaged (non-bounce) visits
- Find landing or exit pages where people leave quickly
- Inspect one conversion path: landing → pages → events → exit