# Plausible Analytics v3.0.0 - Product: Plausible Analytics (https://whatsnew.fyi/product/plausible) - Vendor: Plausible - Date: 2025-04-11 - Version: v3.0.0 - Original notes: https://github.com/plausible/analytics/releases/tag/v3.0.0 - Permalink: https://whatsnew.fyi/product/plausible/releases/v3.0.0 What's New is an index, not a publisher: every entry below links to the vendor's own release notes, which are the authoritative source. Entries are labelled where they are hand-curated sample data, pre-releases, or drawn from a secondary source such as a developer blog. Reuse: the summaries, labels and curation here are © What's New. Quote freely with attribution and a link back; wholesale republication of the corpus is not permitted — terms: https://whatsnew.fyi/terms. The vendors' own release notes remain their publishers'. --- - **added** — Ability to create teams and manage users and permissions - **added** — Average scroll depth metric - **added** — Scroll Depth goals - **added** — Dashboard shows comparisons for all reports - **added** — Two new shorthand time periods 28d and 91d available on both dashboard and in public API - **added** — UTM Medium report and API shows (gclid) and (msclkid) for paid searches when no explicit utm medium present - **added** — Support for case_sensitive: false modifiers in Stats API V2 filters for case-insensitive searches - **added** — Add text version to emails - **added** — Acquisition channels report - **added** — Filter is not for goals in dashboard - **added** — Segments feature to group filters into persistent, named presets - **added** — Support ["is", "segment", []] filter in Stats API - **added** — Time on page metric is now sortable in reports - **added** — Plausible tracker script reports maximum scroll depth reached and time engaged with the site in an engagement event with sd and e integer parameters - **added** — Plausible tracker script reports the version of the script in the v parameter sent with each request - **added** — Support behavioral filters has_done and has_not_done on the Stats API to allow filtering sessions by other events - **added** — Introduce billing team role for users - **added** — Introduce editor role with permissions greater than viewer but lesser than admin - **changed** — Default period for brand new sites is now today rather than last 28 days - **changed** — Increase decimal precision of the Exit rate metric from 0 to 1 decimal place > [!WARNING] > Please use [3.0.1 patch](https://github.com/plausible/analytics/releases/tag/v3.0.1) that contains fix for https://github.com/plausible/analytics/issues/5319 The highlights of this release are: - Create teams, manage users and permissions - Scroll depth, engagement time and (reworked) time on page metrics - Segments feature: group filters into persistent, named presets ##### Upgrade Update the image used for `plausible` compose.yml ```diff diff --git a/compose.yml b/compose.yml index f5a0a7e..3e03415 100644 --- a/compose.yml +++ b/compose.yml @@ -11,7 +11,7 @@ services: start_period: 1m plausible_events_db: - image: clickhouse/clickhouse-server:24.3.3.102-alpine + image: clickhouse/clickhouse-server:24.12-alpine restart: always volumes: - event-data:/var/lib/clickhouse @@ -27,12 +27,14 @@ services: nofile: soft: 262144 hard: 262144 + environment: + - CLICKHOUSE_SKIP_USER_SETUP=1 healthcheck: test: ["CMD-SHELL", "wget --no-verbose --tries=1 -O - http://127.0.0.1:8123/ping || exit 1"] start_period: 1m plausible: - image: ghcr.io/plausible/community-edition:v2.1.5 + image: ghcr.io/plausible/community-edition:v3.0.0 restart: always command: sh -c "/entrypoint.sh db createdb && /entrypoint.sh db migrate && /entrypoint.sh run" depends_on: ``` and restart the containers console ```console $ docker compose up -d ``` This will boot up the new version of the app. ##### Changelog The following [changes](https://github.com/plausible/analytics/compare/v2.1.5...v3.0.0) have been made since 2.1.5: ###### Added - Ability to sort by and compare the `exit_rate` metric in the dashboard Exit Pages > Details report - Add top 3 pages into the traffic spike email - Two new shorthand time periods `28d` and `91d` available on both dashboard and in public API - Average scroll depth metric - Scroll Depth goals - Dashboard shows comparisons for all reports - UTM Medium report and API shows (gclid) and (msclkid) for paid searches when no explicit utm medium present. - Support for `case_sensitive: false` modifiers in Stats API V2 filters for case-insensitive searches. - Add text version to emails plausible/analytics#4674 - Add acquisition channels report - Add filter `is not` for goals in dashboard plausible/analytics#4983 - Add Segments feature - Support `["is", "segment", []]` filter in Stats API - Time on page metric is now sortable in reports - Plausible tracker script now reports maximum scroll depth reached and time engaged with the site in an `engagement` event. These are reported as `sd` and `e` integer parameters to /api/event endpoint respectively. If you're using a custom proxy for plausible script, please ensure that these parameters are being passed forward. - Plausible tracker script now reports the version of the script in the `v` parameter sent with each request. - Add support for creating and managing teams owning multiple sites - Introduce "billing" team role for users - Introduce "editor" role with permissions greater than "viewer" but lesser than "admin" - Support behavioral filters `has_done` and `has_not_done` on the Stats API to allow filtering sessions by other events that have been completed. - `time_on_page` metric is now graphable, sortable on the dashboard, and available in the Stats API and CSV and GA4 exports/imports ###### Removed - Internal stats API routes no longer support legacy dashboard filter format. - Dashboard no longer shows "Unique visitors" in top stats when filtering by a goal which used to count all users including ones who didn't complete the goal. "Unique conversions" shows the number of unique visitors who completed the goal. ###### Changed - Default period for brand new sites is now `today` rather than `last 28 days`. On _[Truncated at 4000 characters — full notes: https://github.com/plausible/analytics/releases/tag/v3.0.0]_