Versions

Audience: Customer — this page documents version history and changelog.

The versions page (/dashboard/versions) compares metrics across different application versions to track the impact of releases.

URL

/dashboard/versions

Access

Enterprise only. Feature gate: versions_page.

Wrapped in <FeatureGate featureKey="versions_page">.

Overview

The versions page enables side-by-side comparison of two application versions, showing how key metrics changed between releases. This helps teams understand whether new versions improve or regress performance, engagement, and error rates.

Version Comparison Selector

Two dropdowns at the top of the page:

Selector	Purpose
Compare Version	The version to evaluate (usually the current/newer version)
Against Version	The baseline version to compare against

The currently deployed version is marked with "(current)" in the dropdown.

AI Insights

Automatic analysis of the comparison generates insights:

Type	Condition	Example
Improvement	Engagement increased >5%	"Engagement improved 12% in v1.2.3"
Improvement	Error rate decreased >20%	"Error rate reduced 50% in v1.2.3"
Regression	Error rate increased >20%	"Error rate increased 30% in v1.2.3"

Insights appear in a purple-bordered card with color-coded text (green for improvements, red for regressions).

Comparison Table

The VersionComparison component shows a side-by-side metrics table:

Metric	Description
Sessions	Total sessions on each version
Engagement Score	User engagement metric (0-100)
Bounce Rate	Percentage of single-page visits
Avg Duration	Average session duration
Error Rate	Percentage of sessions with errors
LCP	Largest Contentful Paint (ms)
Conversion Rate	Percentage of converting sessions

Each metric shows the value for both versions and a delta indicator (green for improvement, red for regression).

Metrics Over Time

A placeholder for a timeline chart that will show how metrics trend over time with version markers. Currently shows a visual placeholder.

All Versions Grid

Grid of VersionCard components showing all tracked versions:

Field	Description
Version	Semantic version number
Commit	Git commit hash (linked to GitHub)
Sessions	Total session count
Engagement Score	Engagement metric
Error Rate	Error percentage
First/Last Seen	Date range of version activity
Current badge	Marks the currently deployed version

Clicking a version card selects it for comparison (sets it as "Compare Version" and moves the previous selection to "Against Version").