v3.2.0

plausible/analyticsv3.2.0Jan 26, 2026by apata

AI Summary

This release focuses on enhancing shared link management and fixing critical ClickHouse configuration issues. It introduces segment-based filtering for shared links and improves visitor reporting accuracy.

Key Highlights

  • Shared links can now be limited to specific data segments
  • Visitor percentage breakdowns are now shown on all reports
  • Fix for ClickHouse low-memory settings not being applied
  • Fix for tracker script requests failing in v3.1.0

Breaking Changes

  • Requires checking out the `plausible/community-edition:v3.2.0` branch due to ClickHouse profile changes
  • Segment filters are now visible to anyone viewing dashboards, including personal segments on public dashboards

New Features

  • Shared link segmentation
  • Visitor percentage breakdowns
  • Enhanced shared link authentication for internal stats API

Full Release Notes

This release 

- adds "[Limit to segment](https://plausible.io/docs/shared-links#limit-to-segment)" feature for shared links
- fixes a bug requesting tracker scripts in v3.1.0 ([issue 5901](https://github.com/plausible/analytics/issues/5901))
- fixes Clickhouse low-memory settings that weren't actually applied (https://github.com/plausible/community-edition/pull/265)
- ...contains a few other fixes and changes, full details below

## Upgrade

Checkout the branch `plausible/community-edition:v3.2.0`. Needed because Clickhouse profile settings in the [community-edition](https://github.com/plausible/community-edition) repository have changed.

<sub><kbd>console</kbd></sub>
```console
$ git fetch origin v3.2.0:v3.2.0
$ git checkout v3.2.0
```

Re-apply any local changes to tracked files in the repository. If all configuration changes were in `.env` and `compose.override.yml`, this step isn't necessary. 

<sub><kbd>console</kbd></sub>
```console
$ docker compose up -d
```

This will boot up the new version of the app.

## Changelog

### Added

- A visitor percentage breakdown is now shown on all reports, both on the dashboard and in the detailed breakdown
- Shared links can now be limited to a particular segment of the data

### Changed

- Segment filters are visible to anyone who can view the dashboard with that segment applied, including personal segments on public dashboards

### Fixed

- To make internal stats API requests for password-protected shared links, shared link auth cookie must be set in the requests
- Fixed issue with site guests in Editor role and team members in Editor role not being able to change the domain of site
- Fixed direct dashboard links that use legacy dashboard filters containing URL encoded special characters (e.g. character `ê` in the legacy filter `?page=%C3%AA`)
- Fix bug with tracker script config cache that made requests for certain cached scripts give error 500