v3.3.1

umami-software/umamiv3.3.1Aug 20, 2026by mikecao

AI Summary

A maintenance release focused on safer upgrades, tracking correctness, analytics accuracy, and UI fixes.

Key Highlights

  • Hardened two-factor authentication enforcement
  • Fixed event property filtering to respect selected event names
  • Improved expanded metrics query performance
  • Improved handling of username conflicts involving deleted users
  • Added broader coverage for 2FA status and flows

New Features

  • Safer 2FA configuration and feedback
  • Root path preservation with REMOVE_TRAILING_SLASH enabled
  • Zero and false value preservation in website value responses
  • Missing 2FA translations and Traditional Chinese 2FA copy polish

Full Release Notes

Umami `v3.3.1` is a maintenance release focused on safer upgrades, tracking correctness, analytics accuracy, and UI fixes.

## Updates

- Hardened two-factor authentication when **TWO_FACTOR_ENCRYPTION_KEY** is missing or invalid, with safer API enforcement and clearer configuration feedback. #4443
- Preserved the root path when **REMOVE_TRAILING_SLASH** is enabled and reset tracker visit state when a session drifts. #4152
- Fixed event property filtering so fields and values respect the selected event name. #4461
- Preserved events without matching session records and stabilized relational event pagination. #4462
- Improved expanded metrics query performance and fixed funnel steps containing null event values.
- Preserved zero and false values in website value responses.
- Improved handling of username conflicts involving deleted users.
- Added broader coverage for 2FA status, setup, verification, disable, admin, team, and login flows.
- Preserved menu item actions in admin dropdowns. #4453
- Fixed expanded-menu spacing and realtime search bar styling.
- Added missing 2FA translations and polished Traditional Chinese 2FA copy.

## Migrations

- Added prisma/migrations/24_lowercase_username to normalize usernames from pre-3.2 installations while safely handling conflicts with soft-deleted accounts.

## Thanks

@nrps9909 @tomazic89 @NoiceHax

**Full Changelog**: https://github.com/umami-software/umami/compare/v3.3.0...v3.3.1