# Immich: what changed from 2 to 3
- Product: Immich (https://whatsnew.fyi/product/immich)
- Vendor: Immich
- Range: changelog entries numbered after v2.7.5 up to and including v3.1.0, stable releases only
- Entries below: 5 releases (newest first)
- Resolved: 2 is v2.7.5 and 3 is v3.1.0, the newest stable release of each major we track
- Carrying security changes: 0 · CVEs mentioned: 0 · Mentioning breaking changes: 2 · Removing or deprecating something: 2
- Page: https://whatsnew.fyi/product/immich/compare/2...3
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'.
## What changed (68 changes, grouped by kind)
### Added
#### v3.1.0 (2026-07-29)
- Add --visibility flag to immich CLI upload subcommand
- Custom date range for map on mobile
- Add wake lock when uploading assets on web
- Undo archive from toast notification
- Filter workflow assets by upload path
- Add maintenance link to command palette
- Add album asset event handling
- Add EXIF metadata workflow filter
- Add option to invalidate sessions when resetting password via admin-cli
#### v3.0.3 (2026-07-15)
- Publish app releases to FUTO F-Droid repo
#### v3.0.2 (2026-07-09)
- HLS variant configuration
- User agnostic database restore
- Date workflow filter
#### v3.0.1 (2026-07-02)
- Add recently added link in sidebar on web
#### v3.0.0 (2026-07-02)
- Mobile non-destructive editing with cropping, rotating, and adjusting images without modifying the original file
- Workflows preview feature to automate actions in your library by chaining triggers, filters, and actions together with a drag-and-drop builder
- Recently added page
- Integrity checks
- Slideshow on mobile app
- HLS and real-time video transcoding in preview
- New video player for web
- Open photo in Immich as gallery on Android
- OCR on mobile app
- Upload asset directly to album on the mobile app
- Option to select image size when sharing on the mobile app
### Changed
#### v3.1.0 (2026-07-29)
- Keep show more open on duplicates
- Re-evaluate OIDC role claim on every login and support array values
#### v3.0.3 (2026-07-15)
- F-Droid users should pull the application from https://app.futo.org/fdroid/repo instead of the standard F-Droid repository
#### v3.0.0 (2026-07-02)
- Background backup improvement
- Timeline performance improvement for browsing a large amount of assets in a single month
### Fixed
#### v3.1.0 (2026-07-29)
- Add trigger for external libraries AssetCreate in workflows
- Improve slideshow controls visibility on bright backgrounds
- Apply EXIF orientation to remote raw photos on Android
- Hide stack thumbnail tray in slideshow mode
#### v3.0.3 (2026-07-15)
- Issue where LivePhotos upload from the background isn't showing up
- Closing plugin method picker selects unknown method on web
- Unauthorized album owner update
- System appbar icon color has incorrect color in asset viewer
- Locked visibility in search random endpoint
- Send a full datetime from the Android memories widget
- Memory search date validation
- Set hvc1 tag when using hwa
- Clear zoom state when swapping assets on mobile
- Ken Burns effect on sliver app bar jittery on Android
- Correct person age singular pluralization in mobile translations
#### v3.0.2 (2026-07-09)
- Re-add gCastEnabled negation
- Downmix audio to stereo to fix broken channel layout
- Live transcoding when viewing from a link share
- Web search timeline visibility
- Missing i18n strings
- Chinese browser locales recognition
- 10-bit heic and avif colors on Android
- Mobile scroll to top and tabbar scroll behavior
- Wrap migrations in transaction
- OAuth account linking
- Incorrect grouping of recently added assets
- Integrity checks checksum pagination
- Missing crop options and rotation scaling on mobile
- Properly handle live photos locally on mobile
- Integrity checks dto validation
- HTTP request handling after isolate death on mobile
#### v3.0.1 (2026-07-02)
- Fix albums broken on v2 mobile clients
- Fix setting input field description spacing for description snippet
### Removed
#### v3.1.0 (2026-07-29)
- Drop support for iOS 14
#### v3.0.0 (2026-07-02)
- Recoloring photos from mobile editing
- Editing live photos on mobile
- Editing local assets on mobile
- Support for pgvecto.rs
## Release notes
### v3.1.0
- Date: 2026-07-29
- Version: v3.1.0
- Original notes: https://github.com/immich-app/immich/releases/tag/v3.1.0
- Permalink: https://whatsnew.fyi/product/immich/releases/v3.1.0
- **removed** — Drop support for iOS 14
- **added** — Add --visibility flag to immich CLI upload subcommand
- **added** — Custom date range for map on mobile
- **changed** — Keep show more open on duplicates
- **fixed** — Add trigger for external libraries AssetCreate in workflows
- **added** — Add wake lock when uploading assets on web
- **added** — Undo archive from toast notification
- **added** — Filter workflow assets by upload path
- **added** — Add maintenance link to command palette
- **added** — Add album asset event handling
- **fixed** — Improve slideshow controls visibility on bright backgrounds
- **changed** — Re-evaluate OIDC role claim on every login and support array values
- **added** — Add EXIF metadata workflow filter
- **added** — Add option to invalidate sessions when resetting password via admin-cli
- **fixed** — Apply EXIF orientation to remote raw photos on Android
- **fixed** — Hide stack thumbnail tray in slideshow mode
Welcome to Immich `v3.1.0`!
This release includes several quality of life improvements and another round of bug fixes. Keep reading below for the complete highlights.
##### Highlights
- Upload wakelock (web)
- Undo archive (web)
- Filter assets by server filepath (workflows)
- Quick navigate to maintenance page (web)
- Better slideshow button accessibility (web)
- OIDC role claim sync improvements (OAuth)
- Invalidate sessions on password reset (admin-cli)
###### Upload wakelock (web)
Similar to mobile, the web application will now automatically acquire a wakelock to prevent the screen from dimming while uploads are happening. This feature will require an HTTPS connection.
###### Undo archive (web)
After archiving assets, the success notification now has an “undo” button to undo the action.
###### Filter assets by server filepath (workflows)
The asset file filter has a new option “Use path”. When set to true, it will filter based on the actual path on the server rather than the original file name.
###### Filter assets by EXIF metadata (workflows)
A new workflow filter has been added that allows you to filter assets based on their EXIF metadata fields. For now it only supports string comparisons, with numerical comparisons expected to come soon.
###### Quick navigate to maintenance page (web)
The command palette (`CTRL+K` or `/`) now includes an item for the maintenance page.
###### Better slideshow button visibility (web)
The slideshow buttons on the web are now wrapped in a container with a backdrop blur, making them easier to view when the current asset is very light.
###### OIDC role claim sync improvements (OAuth)
The OAuth integration in Immich supports setting an initial `isAdmin` value for new users via a role claim. This same process has been updated to now _sync_ `isAdmin` on subsequent logins. Additionally, the role claim now supports both single values (`immich_role: 'admin'`) in addition to lists of values ( `immich_role: ["admin", "user"]`), making in more flexible.
###### Invalidate sessions on password reset (admin-cli)
When using the admin command line interface to reset a password, there is now a new option to invalidate existing sessions.
```none
immich-admin reset-admin-password
Found Admin:
- ID=e65e6f88-2a30-4dbe-8dd9-1885f4889b53
- OAuth ID=
- Email=admin@example.com
- Name=Immich Admin
? Please choose a new password (optional) immich-is-cool
? Invalidate existing sessions? Yes
The admin password has been updated.
```
###### Date range for map (mobile)
Similar to web, mobile now also supports filtering the map for assets within a given date range.
---
##### What's Changed
###### 🚨 Breaking Changes
- chore(mobile): drop support for iOS 14 by @agg23 in
###### 🚀 Features
- feat(cli): Add --visibil
_[Truncated at 4000 characters — full notes: https://github.com/immich-app/immich/releases/tag/v3.1.0]_
### v3.0.3
- Date: 2026-07-15
- Version: v3.0.3
- Original notes: https://github.com/immich-app/immich/releases/tag/v3.0.3
- Permalink: https://whatsnew.fyi/product/immich/releases/v3.0.3
- **added** — Publish app releases to FUTO F-Droid repo
- **changed** — F-Droid users should pull the application from https://app.futo.org/fdroid/repo instead of the standard F-Droid repository
- **fixed** — Issue where LivePhotos upload from the background isn't showing up
- **fixed** — Closing plugin method picker selects unknown method on web
- **fixed** — Unauthorized album owner update
- **fixed** — System appbar icon color has incorrect color in asset viewer
- **fixed** — Locked visibility in search random endpoint
- **fixed** — Send a full datetime from the Android memories widget
- **fixed** — Memory search date validation
- **fixed** — Set hvc1 tag when using hwa
- **fixed** — Clear zoom state when swapping assets on mobile
- **fixed** — Ken Burns effect on sliver app bar jittery on Android
- **fixed** — Correct person age singular pluralization in mobile translations
#### v3.0.3
- various bug fixes
- we push to our own F-Droid repo at https://app.futo.org/fdroid/repo now. If you're using F-Droid, please pull the application from there from now on
- fixes an issue where LivePhotos upload from the background isn't showing up.
> [!Note]
> In some specific circumstances, newly uploaded Live Photos could have broken thumbnails. If you see any such cases, please run the "missing" job for thumbnails or wait for the respective nightly job to clear it up.
##### What's Changed
###### 🚀 Features
* feat: publish app releases to FUTO F-Droid repo by @bo0tzz in https://github.com/immich-app/immich/pull/29804
###### 🐛 Bug fixes
* fix(web): closing plugin method picker selects "unknown" method by @benbeckford in https://github.com/immich-app/immich/pull/29784
* fix: unauthorized album owner update by @danieldietzler in https://github.com/immich-app/immich/pull/29883
* fix: still part of live photo hidden on bg upload by @shenlong-tanwen in https://github.com/immich-app/immich/pull/29884
* fix: system appbar icon color has incorrect color in asset viewer by @alextran1502 in https://github.com/immich-app/immich/pull/29885
* fix: locked visibility in search random endpoint by @danieldietzler in https://github.com/immich-app/immich/pull/29887
* fix(mobile): send a full datetime from the android memories widget by @santoshakil in https://github.com/immich-app/immich/pull/29689
* fix: memory search date validation by @danieldietzler in https://github.com/immich-app/immich/pull/29907
* fix(server): set hvc1 tag when using hwa by @mertalev in https://github.com/immich-app/immich/pull/29908
* fix(mobile): clear zoom state when swapping assets by @agg23 in https://github.com/immich-app/immich/pull/29909
* fix: Ken Burns effect on sliver app bar jittery on Android by @alextran1502 in https://github.com/immich-app/immich/pull/29890
###### 📚 Documentation
* fix(docs): update fdroid link by @mmomjian in https://github.com/immich-app/immich/pull/29797
* feat: system integrity docs by @danieldietzler in https://github.com/immich-app/immich/pull/29911
###### 🌐 Translations
* chore(web): update translations by @weblate in https://github.com/immich-app/immich/pull/29774
* fix(mobile): correct person age singular pluralization by @tech00exploere in https://github.com/immich-app/immich/pull/29868
##### New Contributors
* @tech00exploere made their first contribution in https://github.com/immich-app/immich/pull/29868
**Full Changelog**: https://github.com/immich-app/immich/compare/v3.0.2...v3.0.3
### v3.0.2
- Date: 2026-07-09
- Version: v3.0.2
- Original notes: https://github.com/immich-app/immich/releases/tag/v3.0.2
- Permalink: https://whatsnew.fyi/product/immich/releases/v3.0.2
- **added** — HLS variant configuration
- **added** — User agnostic database restore
- **added** — Date workflow filter
- **fixed** — Re-add gCastEnabled negation
- **fixed** — Downmix audio to stereo to fix broken channel layout
- **fixed** — Live transcoding when viewing from a link share
- **fixed** — Web search timeline visibility
- **fixed** — Missing i18n strings
- **fixed** — Chinese browser locales recognition
- **fixed** — 10-bit heic and avif colors on Android
- **fixed** — Mobile scroll to top and tabbar scroll behavior
- **fixed** — Wrap migrations in transaction
- **fixed** — OAuth account linking
- **fixed** — Incorrect grouping of recently added assets
- **fixed** — Integrity checks checksum pagination
- **fixed** — Missing crop options and rotation scaling on mobile
- **fixed** — Properly handle live photos locally on mobile
- **fixed** — Integrity checks dto validation
- **fixed** — HTTP request handling after isolate death on mobile
#### v3.0.2
This patch release addresses various bugs from v3 release and adds an additional filter to workflows
##### What's Changed
###### 🌟 Enhancements
* fix(web): add ARIA label to ServerStatisticsCard by @tjhorner in https://github.com/immich-app/immich/pull/29497
* feat(server): hls variant configuration by @mertalev in https://github.com/immich-app/immich/pull/29613
* feat: user agnostic database restore by @danieldietzler in https://github.com/immich-app/immich/pull/29512
* feat(server): date workflow filter by @benbeckford in https://github.com/immich-app/immich/pull/29040
###### 🐛 Bug fixes
* fix: re-add gCastEnabled negation by @bo0tzz in https://github.com/immich-app/immich/pull/29499
* fix: downmix audio to stereo to fix broken channel layout by @lukasdotcom in https://github.com/immich-app/immich/pull/29485
* fix: live transcoding when viewing from a link share by @lukasdotcom in https://github.com/immich-app/immich/pull/29471
* fix: web search timeline visibility by @danieldietzler in https://github.com/immich-app/immich/pull/29518
* fix(web): missing i18n strings by @wonsukchoi in https://github.com/immich-app/immich/pull/29612
* fix: chinese browser locales recognition by @danieldietzler in https://github.com/immich-app/immich/pull/29622
* chore: improve added to album messages by @danieldietzler in https://github.com/immich-app/immich/pull/29641
* fix(mobile): fix 10-bit heic and avif colors on android by @santoshakil in https://github.com/immich-app/immich/pull/29631
* fix(mobile): match iOS scroll to top and tabbar scroll (#28469) by @agg23 in https://github.com/immich-app/immich/pull/29705
* fix: wrap migrations in transaction by @shenlong-tanwen in https://github.com/immich-app/immich/pull/29664
* fix: oauth account linking by @danieldietzler in https://github.com/immich-app/immich/pull/29624
* fix: incorrect grouping of recently added assets by @benbeckford in https://github.com/immich-app/immich/pull/29666
* fix: integrity checks checksum pagination by @danieldietzler in https://github.com/immich-app/immich/pull/29516
* fix(mobile): missing crop options and rotation scaling by @bwees in https://github.com/immich-app/immich/pull/29645
* fix(mobile): properly handle live photos locally by @agg23 in https://github.com/immich-app/immich/pull/29462
* fix: integrity checks dto validation by @danieldietzler in https://github.com/immich-app/immich/pull/29621
* fix(mobile): http request handling after isolate death by @mertalev in https://github.com/immich-app/immich/pull/29714
* fix: do not log out on automatic url switch by @shenlong-tanwen in https://github.com/immich-app/immich/pull/29715
* fix(server): stream ffprobe packets by @mertalev in https://github.com/immich-app/immich/pull/29723
* fix: search metadata for album shared links by @danieldietzler in https://github.com/immich-app/immich/pull/29742
* fix(web): clear asset selection when search context changes by @khanguyen74 in https://github.com/immich-app/immich/pull/29738
* fix(mobile): update timeline args on layout constraint changes by @santoshakil in https://github.com/immich-app/immich/pull/29653
* fix: iso date parsing for three digit years by @danieldietzler in https://github.com/immich-app/immich/pull/29739
* fix: missing files integrity checks by @danieldietzler in https://github.com/immich-app/immich/pull/29737
* fix(mobile): play videos from search results and folder view by @santoshakil in https://github.com/immich-app/immich/pull/29693
* fix(web): recursively unnest class arrays by @meesfrensel in https://github.com/immich-app/immich/pull/29755
* fix: emit album update event when uploading assets through shared link by @danieldietzler in https://github.com/immich-app/immich/pull/29757
* fix(web): always initialize language manager to set lang and dir by @meesfrensel in https://github.com/immich-app/immich/pul
_[Truncated at 4000 characters — full notes: https://github.com/immich-app/immich/releases/tag/v3.0.2]_
### v3.0.1
- Date: 2026-07-02
- Version: v3.0.1
- Original notes: https://github.com/immich-app/immich/releases/tag/v3.0.1
- Permalink: https://whatsnew.fyi/product/immich/releases/v3.0.1
- **added** — Add recently added link in sidebar on web
- **fixed** — Fix albums broken on v2 mobile clients
- **fixed** — Fix setting input field description spacing for description snippet
#### v3.0.1
- Fixes a bug that causes albums don't show up in the mobile app
##### What's Changed
###### 🚀 Features
* feat(web): recently added link in sidebar by @benbeckford in https://github.com/immich-app/immich/pull/29039
###### 🐛 Bug fixes
* fix: albums broken on v2 mobile clients by @shenlong-tanwen in https://github.com/immich-app/immich/pull/29446
* fix: setting input field description spacing for description snippet by @danieldietzler in https://github.com/immich-app/immich/pull/29433
###### 🌐 Translations
* chore(web): update translations by @weblate in https://github.com/immich-app/immich/pull/29410
**Full Changelog**: https://github.com/immich-app/immich/compare/v3.0.0...v3.0.1
### v3.0.0
- Date: 2026-07-02
- Version: v3.0.0
- Original notes: https://github.com/immich-app/immich/releases/tag/v3.0.0
- Permalink: https://whatsnew.fyi/product/immich/releases/v3.0.0
- **added** — Mobile non-destructive editing with cropping, rotating, and adjusting images without modifying the original file
- **added** — Workflows preview feature to automate actions in your library by chaining triggers, filters, and actions together with a drag-and-drop builder
- **added** — Recently added page
- **added** — Integrity checks
- **added** — Slideshow on mobile app
- **added** — HLS and real-time video transcoding in preview
- **added** — New video player for web
- **added** — Open photo in Immich as gallery on Android
- **added** — OCR on mobile app
- **added** — Upload asset directly to album on the mobile app
- **added** — Option to select image size when sharing on the mobile app
- **changed** — Background backup improvement
- **changed** — Timeline performance improvement for browsing a large amount of assets in a single month
- **removed** — Recoloring photos from mobile editing
- **removed** — Editing live photos on mobile
- **removed** — Editing local assets on mobile
- **removed** — Support for pgvecto.rs
#### v3.0.0
Welcome to Immich `v3.0.0`!
After months of hard work from the team and our amazing contributors, we're thrilled to announce the next major version of Immich: `v3.0.0`! 🎉
##### Breaking changes
This release includes several breaking changes; read the full migration guide [here](https://immich.app/blog/v3-migration). *It's worth mentioning that many of the breaking changes are updates to API endpoints and affect only **third-party tools** that integrate with Immich's API*. For the vast majority of users, updating works exactly as it always has.
##### How to update
> [!WARNING]
> `v3.0.0` drops support for pgvecto.rs. If you run Immich before `v1.133.0` and haven't done the migration step yet, see the migration guide here. https://docs.immich.app/install/upgrading/#migrating-to-vectorchord
First, update the `IMMICH_VERSION` in your `.env` file to `v3`:
```diff
- IMMICH_VERSION=v2
+ IMMICH_VERSION=v3
```
Then run the usual update commands:
```bash
docker compose pull && docker compose up -d
```
##### Release candidates
If you missed it, `v3.0.0` was the first time we used release candidates, also known as prereleases. Release candidates are tested but not yet official releases of Immich, and they allow us to find and fix any outstanding bugs before a final release. If you would like to be notified about release candidates directly through Immich, you can change the release channel from "Stable" to "Release candidate" in the `Admin settings > Version check` options ([here](https://my.immich.app/admin/system-settings?isOpen=version-check)).
##### New Merch
As part of this release, we're happy to announce we also have some new swag for you!
* Kids clothing: For those who are likely the reason for your Immich library's size
* Colored embroidery: We now have clothes with a full color embroidered Immich logo
Check it out now at [https://immich.store](https://immich.store/collections/immich-3-0)!
##### Highlights
Now, let's get right into all the new features in this release:
* Mobile non-destructive editing
* Workflows (preview)
* Background backup improvement
* Recently added page
* Integrity checks
* Slideshow on mobile app
* HLS and real-time video transcoding (preview)
* New video player for web
* Open photo in Immich as gallery on Android
* OCR on mobile app
* Upload asset directly to album on the mobile app
* Option to select image size when sharing on the mobile app
* Timeline performance improvement for browsing a large amount of assets in a single month
###### Mobile non-destructive editing
This is a follow-up to Image Editing on the web, which was released in `v2.5.0`. This feature allows you to make non-destructive edits to your photos inside of Immich. Until now, the mobile editor used a completely different system that created new assets instead of editing the photo in place.
With this update, we bring a new, easier-to-use editor to mobile devices that has the same features as the web version. You can now edit photos directly in the mobile app, including cropping, rotating, and adjusting your images without ever touching the original file. Similar to the web, edits are non-destructive, so you can revisit or revert them at any time. You can even make edits on mobile and then adjust them on the web later!
Some features from the previous mobile editing implementation have been removed including:
* Recoloring photos
* Edit
_[Truncated at 4000 characters — full notes: https://github.com/immich-app/immich/releases/tag/v3.0.0]_