# Umami v3.1.0
- Product: Umami (https://whatsnew.fyi/product/umami)
- Vendor: Umami Software
- Date: 2026-04-16
- Version: v3.1.0
- Original notes: https://github.com/umami-software/umami/releases/tag/v3.1.0
- Permalink: https://whatsnew.fyi/product/umami/releases/v3.1.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** — Create custom dashboards with Boards feature including row/column layout editor, per-component website binding, TextBlock components, board sharing and duplication, and dashboard-wide date range and filter controls
- **added** — Session Replay feature to watch real user sessions replayed in the browser with configurable masking levels, per-visit recording, filterable replays table, and replay modal with mobile-friendly playback
- **added** — Web Vitals performance tracking for Core Web Vitals (LCP, INP, CLS, FCP, TTFB) with industry-standard calculations and rating badges
- **changed** — Redesigned share page with full mobile support, collapsible sidenav, per-share display options, ability to name share links, choose visible sections, and apply filtered navigation
- **added** — OR logic across filters, segments, and cohorts
- **added** — Regex operators for filter matching
- **added** — Multiselect on equals and not-equals operators
- **added** — UTM filters and fields exposed throughout the app
- **added** — Exclude bounces toggle with filter-form integration
- **added** — Per-step event property filters in funnel creation and overview
- **added** — Wildcard support in the goals report
- **added** — Custom slug support for Links
- **added** — Pixel and Link detail pages with sharing
- **added** — MetricsBar added to the Events page
- **added** — Event type filter on Journeys
- **added** — Time unit selector (hour/day/month)
- **added** — Distinct ID available as a filter and metric dimension
- **added** — Cache-control headers on GET responses
- **added** — SKIP_BUILD_GEO environment variable to skip geo database build
- **changed** — Migrated from react-intl to next-intl with all 51 locale files translated
Umami `v3.1.0` is here with a ton of new features, including the much-anticipated **Boards** and **Session Replay**. This release also brings Web Vitals performance tracking, a redesigned share page, and hundreds of fixes and improvements.
##### New features
###### Boards
Boards are here! Create your own custom dashboards by composing components on a flexible row/column canvas. Pick from charts, tables, and metric components, bind them to any website, and share the finished board with your team.
- Row/column layout editor with resize, reorder, and remove controls
- Per-component website binding and live preview
- Free-form `TextBlock` components for notes and section headers
- Board sharing, duplication, and table-level edit/delete actions
- Dashboard-wide date range and filter controls
###### Session Replay
Watch real user sessions replayed in the browser. Session Replay is built on [rrweb](https://www.rrweb.io/) and works alongside your existing tracker.
- Configurable masking levels for privacy (defaults to *moderate*)
- Per-visit recording so replays stay short and focused
- Filterable replays table with event-level filtering
- Replay modal with mobile-friendly playback
###### Web Vitals performance tracking
Track Core Web Vitals (LCP, INP, CLS, FCP, TTFB) from your visitors' browsers. The redesigned Performance page shows industry-standard calculations with rating badges for each metric.
###### Redesigned share page
Share pages have a fresh look with full mobile support, a collapsible sidenav, and per-share display options. You can now:
- Name each share link
- Choose which sections visitors can see (overview, events, etc.)
- Apply filtered navigation so visitors only see what you want
###### Filters, segments, and cohorts
- **OR logic** across filters, segments, and cohorts
- **Regex operators** for more powerful matching
- **Multiselect** on equals/not-equals operators
- UTM filters and fields exposed throughout the app
- **Exclude bounces** toggle with filter-form integration
###### Funnels
- Per-step event property filters in both funnel creation and overview
- Wildcard support in the goals report
###### Other improvements
- Custom slug support for Links
- Pixel and Link detail pages with sharing
- `MetricsBar` added to the Events page
- Event type filter on Journeys
- Time unit selector (hour/day/month)
- Distinct ID available as a filter and metric dimension
- Cache-control headers on `GET` responses
- `SKIP_BUILD_GEO` env variable to skip geo DB build
- Configurable salt rotation period via env vars
- EdgeOne geolocation headers
- Version endpoint and settings display
- Download for breakdown reports
- Pagination limit on event charts, metrics tables, and UTM reports
###### Admin & internationalization
- Migrated from `react-intl` to `next-intl` with all 51 locale files translated
- Adopted the [`react-zen`](https://zen.umami.is) design system across the app
- Consolidated top navigation with embedded selectors for websites, boards, links, and pixels
- Team validation and redirect for invalid teams
- Team-gated feature resolution via Redis
##### Security
- Fixed IDOR vulnerabilities in reports and segments
- Blocked share tokens from all editing permissions and API modifications
- Restricted `x-umami-client-*` headers to cloud mode
- Various dependency vulnerability fixes (tar, ajv, jws, brace-expansion, next)
##### Migrations
This release includ
_[Truncated at 4000 characters — full notes: https://github.com/umami-software/umami/releases/tag/v3.1.0]_