# Plausible Analytics v3.1.0-rc.0
- Product: Plausible Analytics (https://whatsnew.fyi/product/plausible)
- Vendor: Plausible
- Date: 2025-11-03
- Version: v3.1.0-rc.0
- Original notes: https://github.com/plausible/analytics/releases/tag/v3.1.0-rc.0
- Permalink: https://whatsnew.fyi/product/plausible/releases/v3.1.0-rc.0
- Labels: Pre-release
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** — Custom events can now be marked as non-interactive in events API and tracker script, with non-interactive events not counted towards bounce rate
- **added** — Ability to leave team via Team Settings > Leave Team
- **added** — Stats APIv2 now supports include.trim_relative_date_range option to trim empty values after current time for day, month and year date_range values
- **added** — Properties are now included in full site exports done via Site Settings > Imports & Exports
- **added** — Google Search Console integration settings now allow properties to be dynamically sought
- **added** — Weekly and monthly email reports now contain top goal conversions
- **added** — Newly created sites are offered a new dynamic tracking script and snippet specific to the site
- **added** — Sites in Review installation flow are offered the new script and snippet along with a migration guide from legacy snippets
- **added** — New tracker script allows configuring transformRequest function to change event payloads before they are sent
- **added** — New tracker script allows configuring customProperties function hook to derive custom props for events on the fly
- **added** — New tracker script supports tracking form submissions if enabled
- **added** — New tracker script automatically updates to respect site domain if changed in Change domain flow
- **added** — New tracker script automatically updates to respect configuration options for tracking outbound links, file downloads, and form submissions
- **added** — New tracker script allows overriding options by changing the snippet with plausible.init() function for page-by-page customization
- **added** — New @plausible-analytics/tracker ESM module available on NPM with near-identical configuration API and identical tracking logic
- **changed** — A session is now marked as a bounce if it has less than 2 pageviews and no interactive custom events
- **changed** — All dropmenus on dashboard are navigable with Tab and no two dropmenus can be open at once
- **changed** — Special path-based events like 404 do not need event.props.path to be explicitly defined when tracking
- **changed** — Main graph no longer shows empty values after current time for day, month and year periods
- **changed** — Include bounce_rate metric in Entry Pages breakdown
This release
- Introduces the new dynamic and more configurable tracking snippet and script (legacy scripts and snippets will still continue to work). See [this doc](https://plausible.io/docs/script-update-guide) for more details
- Supports a new optional property on events: `interactive`. See [this doc](https://plausible.io/docs/events-api#request-body-json-parameters:~:text=interactive%20optional) for more details.
- Revamps dark theme
- ...other fixes and improvements listed below
##### Upgrade
Update the image used for `plausible`
compose.yml
```diff
plausible:
- image: ghcr.io/plausible/community-edition:v3.0.1
+ image: ghcr.io/plausible/community-edition:v3.1.0-rc.0
```
and restart the containers
console
```console
$ docker compose up -d
```
This will boot up the new version of the app.
##### Changelog
###### Added
- Custom events can now be marked as non-interactive in events API and tracker script: events marked as non-interactive are not counted towards bounce rate
- Ability to leave team via Team Settings > Leave Team
- Stats APIv2 now supports `include.trim_relative_date_range` - this option allows trimming empty values after current time for `day`, `month` and `year` date_range values
- Properties are now included in full site exports done via Site Settings > Imports & Exports
- Google Search Console integration settings: properties can be dynamically sought
- Weekly/monthly e-mail reports now contain top goal conversions
- Newly created sites are offered a new dynamic tracking script and snippet that's specific to the site
- Old sites that go to "Review installation" flow are offered the new script and snippet, along with a migration guide from legacy snippets, legacy snippets continue to function as before
- The new tracker script allows configuring `transformRequest` function to change event payloads before they're sent
- The new tracker script allows configuring `customProperties` function hook to derive custom props for events on the fly
- The new tracker script supports tracking form submissions if enabled
- The new tracker script automatically updates to respect site domain if it's changed in "Change domain" flow
- The new tracker script automatically updates to respect the following configuration options available in "New site" flows and "Review installation" flows: whether to track outbound links, file downloads, form submissions
- The new tracker script allows overriding almost all options by changing the snippet on the website, with the function `plausible.init({ ...your overrides... })` - this can be unique page-by-page
- A new `@plausible-analytics/tracker` ESM module is available on NPM - it has near-identical configuration API and identical tracking logic as the script and it receives bugfixes and updates concurrently with the new tracker script
###### Removed
###### Changed
- A session is now marked as a bounce if it has less than 2 pageviews and no interactive custom events
- All dropmenus on dashboard are navigable with Tab (used to be a mix between tab and arrow keys), and no two dropmenus can be open at once on the dashboard
- Special path-based events like "404" don't need `event.props.path` to be explicitly defined when tracking: it is set to be the same as `event.pathname` in event ingestion; if it is explicitly defined, it is not overridden for backwards compatibility
- Main graph no longer shows empty values after current time for `day`, `month` and `year` periods
- Include `bounce_rate` metric in Entry Pages breakdown
- Dark mode theme has been refined with darker color scheme and better visual hierarchy
###### Fixed
- Make clicking Compare / Disable Comparison in period picker menu close the menu
- Do not log page views for hidden pages (prerendered pages and new tabs), until pages are viewed
- Password-authenticated shared links now carry over dashboard params properly
_[Truncated at 4000 characters — full notes: https://github.com/plausible/analytics/releases/tag/v3.1.0-rc.0]_