v3.1.0

[danieldietzler]

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.

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 chore(mobile): drop support for iOS 14 #29780

🚀 Features

• feat(cli): Add --visibility flag to immich CLI upload subcommand by @yuxincs in feat(cli): Add --visibility flag to immich CLI upload subcommand #29614
• feat(mobile): custom date range for map by @YarosMallorca in feat(mobile): custom date range for map #26205

🌟 Enhancements

• feat(web): Keep show more open on duplicates by @MontejoJorge in feat(web): Keep show more open on duplicates #29734
• fix(server/workflow): add trigger for external libraries AssetCreate by @cratoo in fix(server/workflow): add trigger for external libraries AssetCreate #29597
• chore(seo): remove redundant twitter metadata tags by @cevdetta in chore(seo): remove redundant twitter metadata tags #29801
• feat(web): add wake lock when uploading assets by @diogotcorreia in feat(web): add wake lock when uploading assets #29820
• feat(web): undo archive from toast by @YarosMallorca in feat(web): undo archive from toast #27061
• feat: workflow filter assets by upload path by @benbeckford in feat: workflow filter assets by upload path #30000
• feat(web): add maintenance link to command palette by @yamishi13 in feat(web): add maintenance link to command palette #30016
• feat: add album asset event handling by @timonrieger in feat: add album asset event handling #29008
• fix(web): improve slideshow controls visibility on bright backgrounds by @tech00exploere in fix(web): improve slideshow controls visibility on bright backgrounds #29950
• fix: re-evaluate OIDC role claim on every login and support array values by @ImperatorRuscal in fix: re-evaluate OIDC role claim on every login and support array values #29991
• feat: exif metadata workflow filter by @benbeckford in feat: exif metadata workflow filter #29295
• feat: password invalidate sessions by @jrasm91 in feat: password invalidate sessions #30125

🐛 Bug fixes

• fix(mobile): apply exif orientation to remote raw photos on android by @santoshakil in fix(mobile): apply exif orientation to remote raw photos on android #29906
• fix(web): hide stack thumbnail tray in slideshow mode by @tech00exploere in fix(web): hide stack thumbnail tray in slideshow mode #29918
• fix(web): use Container component for responsive admin maintenance la… by @tech00exploere in fix(web): use Container component for responsive admin maintenance la… #29917
• fix(server): updated default CSP config to support videos from V3 player by @l0ll098 in fix(server): updated default CSP config to support videos from V3 player #29830
• fix(server): workflow date filter, make end date inclusive by @kigrup in fix(server): workflow date filter, make end date inclusive #29876
• fix(web): URI encode slug and reduce confusion for users by @meesfrensel in fix(web): URI encode slug and reduce confusion for users #29796
• fix(web): clear birth date by @danieldietzler in fix(web): clear birth date #29959
• fix(server): disable heif security limit by @mertalev in fix(server): disable heif security limit #29954
• fix: zero byte image uploads by @rrrockey in fix: zero byte image uploads #29426
• fix(server): return workflow steps in ascending order by @benbeckford in fix(server): return workflow steps in ascending order #29999
• fix(mobile): update album creation to use user-defined name from dialog by @LeLunZ in fix(mobile): update album creation to use user-defined name from dialog #30002
• fix: long press share quality override preference settings by @alextran1502 in fix: long press share quality override preference settings #30030
• fix(web): align ContextMenu z-index with design-system token by @tech00exploere in fix(web): align ContextMenu z-index with design-system token #30015
• fix(web): refresh folder view after asset deletion by @tech00exploere in fix(web): refresh folder view after asset deletion #29899
• fix: do not show the whats new page on fresh login by @shenlong-tanwen in fix: do not show the whats new page on fresh login #30072
• fix(mobile): prevent crash on video widget dispose by @agg23 in fix(mobile): prevent crash on video widget dispose #30078
• fix(web): attach file picker input to DOM so iOS Safari fires change … by @mrxder in fix(web): attach file picker input to DOM so iOS Safari fires change … #29660
• fix: timebuckets locked permissions by @danieldietzler in fix: timebuckets locked permissions #30066
• fix: search statistics locked folder permissions by @danieldietzler in fix: search statistics locked folder permissions #30063
• fix(web): fix Country/State filters when set to Unknown by @compscitwilight in fix(web): fix Country/State filters when set to Unknown  #30026
• fix(server): file uploads for files with extension only filenames by @compscitwilight in fix(server): file uploads for files with extension only filenames #30024
• fix(mobile): stop double close animation when dismissing an asset by @santoshakil in fix(mobile): stop double close animation when dismissing an asset #29413
• fix(mobile): back up files moved into a watched folder on android by @santoshakil in fix(mobile): back up files moved into a watched folder on android #29872
• fix(web): lens model search by @jrasm91 in fix(web): lens model search #30088
• fix(mobile): add album picker to the partner view bottom sheet by @santoshakil in fix(mobile): add album picker to the partner view bottom sheet #30099
• fix(mobile): prevent duplicate album creation during submission by @LeLunZ in fix(mobile): prevent duplicate album creation during submission #30003
• fix(mobile): properly group download tasks for Live Photos by @agg23 in fix(mobile): properly group download tasks for Live Photos #29952
• fix(mobile): show real error when an asset can't be added to an album by @santoshakil in fix(mobile): show real error when an asset can't be added to an album #29754
• fix(mobile): treat wired ethernet as unmetered on ios by @santoshakil in fix(mobile): treat wired ethernet as unmetered on ios #29351
• fix(server): send id_token_hint on OIDC logout by @lorypota in fix(server): send id_token_hint on OIDC logout #29720
• fix(mobile): refresh asset stack after deleting viewer item by @PeterOmbodi in fix(mobile): refresh asset stack after deleting viewer item #28164
• fix: limit ocr overlay to images by @YarosMallorca in fix: limit ocr overlay to images #30116
• fix: disable slideshow crossfade on reduced motion by @YarosMallorca in fix: disable slideshow crossfade on reduced motion #29826
• fix(mobile): map unresponsive after viewing asset by @YarosMallorca in fix(mobile): map unresponsive after viewing asset #27036
• fix(mobile): send date-only value for memories query param by @ajuijas in fix(mobile): send date-only value for memories query param #30049
• fix: admin user details responsive layout by @YarosMallorca in fix: admin user details responsive layout #30114
• fix: backup delay translation key parsing by @YarosMallorca in fix: backup delay translation key parsing #30112
• fix(web): use correct date field for shift-click range in Recently Added by @okxint in fix(web): use correct date field for shift-click range in Recently Added #30071
• fix(server): dissolve stack when its non-primary assets are deleted by @justadityaraj in fix(server): dissolve stack when its non-primary assets are deleted #29354
• fix: always set extension from provided file by @bo0tzz in fix: always set extension from provided file #29839
• fix: locked view and asset view provider by @shenlong-tanwen in fix: locked view and asset view provider #30136
• fix(mobile): birthday picker date order follows locale by @santoshakil in fix(mobile): birthday picker date order follows locale #29419
• fix(web): restore correct back route when opening person asset via direct URL by @okxint in fix(web): restore correct back route when opening person asset via direct URL #30129
• fix(web): mirror asset viewer navigation icons in RTL by @noboike in fix(web): mirror asset viewer navigation icons in RTL #30151
• fix(mobile): allow URL validation to pass when scheme is not provided by @agg23 in fix(mobile): allow URL validation to pass when scheme is not provided #30142
• fix: run background tasks in root isolate by @shenlong-tanwen in fix: run background tasks in root isolate #30101
• fix(web): mirror onboarding navigation icons in RTL by @noboike in fix(web): mirror onboarding navigation icons in RTL #30158
• fix: min faces user preference by @jrasm91 in fix: min faces user preference #30177
• fix(web): use RTL transform origin in AdaptiveImage by @noboike in fix(web): use RTL transform origin in AdaptiveImage #30182
• fix: don't skip person thumbnail generation if ML is disabled by @bo0tzz in fix: don't skip person thumbnail generation if ML is disabled #30194
• fix: shared by user detail panel by @danieldietzler in fix: shared by user detail panel #30187
• fix(mobile): prevent timeline scroll to top on unrelated pages by @agg23 in fix(mobile): prevent timeline scroll to top on unrelated pages #30281

📚 Documentation

• chore(security.txt): bump expired Expires field (RFC 9116) by @kobihikri in chore(security.txt): bump expired Expires field (RFC 9116) #29932
• fix(docs): remove ref to synology channel by @mmomjian in fix(docs): remove ref to synology channel  #30051
• fix: hypertext link to example docker-compose.rootless.yml by @upmcplanetracker in fix: hypertext link to example docker-compose.rootless.yml #30155

🌐 Translations

• feat(docs): add bulgarian readme by @nedevski in feat(docs): add bulgarian readme #29427
• chore(web): update translations by @weblate in chore(web): update translations #29781

New Contributors

• @kobihikri made their first contribution in chore(security.txt): bump expired Expires field (RFC 9116) #29932
• @kigrup made their first contribution in fix(server): workflow date filter, make end date inclusive #29876
• @yuxincs made their first contribution in feat(cli): Add --visibility flag to immich CLI upload subcommand #29614
• @cevdetta made their first contribution in chore(seo): remove redundant twitter metadata tags #29801
• @mrxder made their first contribution in fix(web): attach file picker input to DOM so iOS Safari fires change … #29660
• @compscitwilight made their first contribution in fix(web): fix Country/State filters when set to Unknown  #30026
• @nedevski made their first contribution in feat(docs): add bulgarian readme #29427
• @yamishi13 made their first contribution in feat(web): add maintenance link to command palette #30016
• @lorypota made their first contribution in fix(server): send id_token_hint on OIDC logout #29720
• @ImperatorRuscal made their first contribution in fix: re-evaluate OIDC role claim on every login and support array values #29991
• @ajuijas made their first contribution in fix(mobile): send date-only value for memories query param #30049
• @justadityaraj made their first contribution in fix(server): dissolve stack when its non-primary assets are deleted #29354
• @pavel-miniutka made their first contribution in chore(mobile): Adds Belarusian language option in settings on mobile #29939
• @noboike made their first contribution in fix(web): mirror asset viewer navigation icons in RTL #30151
• @upmcplanetracker made their first contribution in fix: hypertext link to example docker-compose.rootless.yml #30155

Full Changelog: v3.0.3...v3.1.0

---

This discussion was created from the release v3.1.0.

[jreyes138]

It looks like it broke backup in Android. Message "Sync failed. Cannot process backup.

[alextran1502]

This indicates there is something going on with the server so the app cannot communicate with it. Please check the server logs

[jreyes138]

It wanted a log out and login to discard stale sync state. Thank you.

[adamkovacs2000]

Hello!
With the new path/filename regex matcher is it somehow possible to create capture groups and create albums based on them?
Like the path is .../images/holidays/2020 Italy --->>> Then create an album named "2020 Italy"

This is the basic json, but i dont know how to incorporate capture groups?

{
  "name": "dsa",
  "description": "dsa",
  "enabled": true,
  "trigger": "AssetCreate",
  "steps": [
    {
      "method": "immich-plugin-core#assetFileFilter",
      "config": {
        "pattern": "dsa",
        "matchType": "regex",
        "usePath": true,
        "caseSensitive": true
      },
      "enabled": true
    },
    {
      "method": "immich-plugin-core#assetAddToAlbums",
      "config": {
        "albumIds": [],
        "albumName": "dsa"
      },
      "enabled": true
    }
  ]
}

[danieldietzler]

That's not possible currently. We don't support passing additional data from one method to another at the moment

[adamkovacs2000]

Thanks!
I think that would be a great addition, which would solve many use cases.

[danieldietzler]

Yeah agreed, it's just kinda hard to do. Feel free to bring it up in #29167 if it hasn't been mentioned there yet

[Solarunit]

I noticed recently that android app is doing something in the background (checking new assets I guess).
I don't have any automatic backup options enabled. Please add option to disable this.

[Solarunit]

If you'd like to stop it, restrict battery usage in background, and similar settings to prevent the OS from kicking it off in the background frequently.

I want to disable it within the app completely, not limit it somehow or use workarounds

[upmcplanetracker]

Few times a day I see icon and notification, something like "checking for new assets". I dislike this. I want it to do nothing in the background, just like my other gallery app.

The question is is your other gallery app not checking these things in the background or does it just not tell you when it's checking for them?

[Solarunit]

It's Fossify Gallery, I don't think it does.

[bo0tzz]

I had a brief look at Fossify's code, it does similar work in the background as well (except for the sync with a server of course, because it doesn't have one).

[Solarunit]

never noticed this behavior in Fossify Gallery

[DaniCool21]

Im using immich as docker and its not pulling the new version
this is my docker image
image: ghcr.io/immich-app/immich-server:${IMMICH_VERSION:-release}

[alextran1502]

Can you try again? docker compose pull

[DaniCool21]

i did it
still no new version

[bo0tzz]

Also make sure the IMMICH_VERSION you've set in your .env (if any) covers v3.1.0

[DaniCool21]

its IMMICH_VERSION=v2

[DaniCool21]

i got it now
i changed to V3

[upmcplanetracker]

That coming up as 404. Check your link.

…

On Wed, Jul 29, 2026, 2:42 PM Daniel Lanbourg ***@***.***> wrote: Im using immich as docker and its not pulling the new version this is my docker image image: ghcr.io/immich-app/immich-server:${IMMICH_VERSION:-release} <http://ghcr.io/immich-app/immich-server:$%7BIMMICH_VERSION:-release%7D> — Reply to this email directly, view it on GitHub <#30359?email_source=notifications&email_token=BUKFPFFVEELLDVHURL3UMVT5HJASFA5CNFSNUABIM5UWIORPF5TWS5BNNB2WEL2ENFZWG5LTONUW63SDN5WW2ZLOOQXTCNZYGMYTEOBXUZZGKYLTN5XKOY3PNVWWK3TUUVSXMZLOOSWGM33PORSXEX3DNRUWG2Y#discussioncomment-17831287>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/BUKFPFHOLEI4GHBJSAH7X4D5HJASFAVCNFSNUABIKJSXA33TNF2G64TZHM2DKNJSGI4TCNRYHNCGS43DOVZXG2LPNY5TCMBVGE4DQMRXUF3AE> . Triage notifications, keep track of coding agent tasks and review pull requests on the go with GitHub Mobile for iOS <https://github.com/notifications/mobile/ios/BUKFPFBEKKRRAOZM3FEPQQL5HJASFA5CNFSNUABIM5UWIORPF5TWS5BNNB2WEL2ENFZWG5LTONUW63SDN5WW2ZLOOQXTCNZYGMYTEOBXUZZGKYLTN5XKOY3PNVWWK3TUUVSXMZLOOSVGM33PORSXEX3JN5ZQ> and Android <https://github.com/notifications/mobile/android/BUKFPFFFBWCAMN2YUO5QMMT5HJASFA5CNFSNUABIM5UWIORPF5TWS5BNNB2WEL2ENFZWG5LTONUW63SDN5WW2ZLOOQXTCNZYGMYTEOBXUZZGKYLTN5XKOY3PNVWWK3TUUVSXMZLOOSXGM33PORSXEX3BNZSHE33JMQ>. Download it today! You are receiving this because you commented.Message ID: ***@***.***>

[Pzdrs]

Love the OIDC change, have been waiting for it!