v2.3.0

[alextran1502]

v2.3.0

Loa loa loa, the stock is running low on Retro DVD 📀! If you want to get one for yourself, you still can, but once this batch is gone, we won’t be making any more, EVER! So get one while you can from immich.store!

Important

We will start the work on removing the old mobile timeline soon. If you are still using the old timeline, please make sure to switch to the new timeline. If this message does not make sense to you, you can ignore it as you are already on the new timeline

Highlights

Welcome to the release v2.3.0 of Immich. This version comes with enhancements to the OCR feature and many bug fixes. This release also introduces foundational support for workflows and an application restore mechanism directly in the web UI. Let’s dive into some of the highlights below

• OCR Improvements
• Add/move action in mobile app
• Delete synchronization - Android
• Notable fixes: app freezes on resume on iOS
• Sneak peek: Maintenance mode and workflow

Add/move action in mobile app

The asset viewer in the mobile app now includes an “Add to” button that lets you quickly add an asset to an album, the locked folder, or the archive. Thanks @happychriss!

OCR Improvement

This release includes several enhancements to the OCR feature. There are now language-specific OCR model variants, extending support to Greek, Korean, Russian, Belarusian, Ukrainian, Thai, and languages using the Latin script. All variants (including the existing models) support English as well. There is also an English-only model that performs better for libraries where multilingual support is not needed.

To switch to one of these models, you can navigate to the OCR settings, choose the relevant model, save, then re-run OCR on all assets through the Job Status page.

The OCR information can now be viewed by toggling a button in the web viewer. You can hover the mouse over the text and copy it.

Delete synchronization on Android.

This release restores the previous mechanism for synchronizing the deletion action between the web and the mobile app. In addition to putting the asset in Immich’s trash bin, the mechanism also puts the deleted asset in the device’s trash system when the app opens. The mechanism has been reworked to align with the new data sync mechanism in the mobile app. You can enable the mechanism in the App Settings > Advanced > Sync Remote Deletions

Notable fixes: app freezes on resume on iOS

Previously, iOS background tasks, such as local or remote data sync and background uploads, could abruptly terminate database operations when the iOS’s background time expires, leaving the database lock unreleased. It leads to an annoying symptom: the app appears to freeze when opening from the background, requiring a hard restart (swipe up to close, then reopen) to regain access to the database. The bug happened sporadically and was incredibly hard to track down. Thanks to the relentless pursuit of the bug, we believe it has been caught through our extensive testing. Please let us know if you are still getting “bugged” by this one in the new version.

Sneak peek: Maintenance mode and workflow

We can’t contain the excitement to share two exciting items in the work, which have some portions already merged into the server, and are ready to be built upon

Maintenance mode

This mode will allow the admin to put the server into a state where no one can access it without entirely shutting it down. This paves the way for restoring the server from a previous point in time directly from the web UI, no more fidgeting with the terminal.

2025-11-14_11-55-02.mp4

Workflow

The foundation of workflows and plugins also made its way to the server; the UI is being worked on. This feature will enable many more custom use cases that are not available in the core application. The community can write custom plugins and share them. We are very excited to see this happening faster than anticipated. Below is a screenshot of how the feature could look.

What's Changed

🚀 Features

• feat: Add random memories resource by @jpg0 in feat: Add random memories resource #20025
• feat(mobile): Quick date picker in the search page by @exelix11 in feat(mobile): Quick date picker in the search page #22653
• feat: workflow foundation by @alextran1502 in feat: workflow foundation #23621
• feat(mobile): add to album from asset viewer by @happychriss in feat(mobile): add to album from asset viewer #23608
• feat: maintenance mode by @insertish in feat: maintenance mode #23431
• feat(mobile): location edit from asset viewer by @bwees in feat(mobile): location edit from asset viewer #23925
• feat: timeline e2e tests by @midzelis in feat: timeline e2e tests #23895
• feat: show OCR bounding box by @alextran1502 in feat: show OCR bounding box #23717

🌟 Enhancements

• fix(web): add URLs to results in large files utility by @Snowknight26 in fix(web): add URLs to results in large files utility #23617
• feat(ml): add preload and fp16 settings for ocr by @mertalev in feat(ml): add preload and fp16 settings for ocr #23576
• feat(ml): multilingual ocr by @mertalev in feat(ml): multilingual ocr #23527
• feat(mobile): Show lens model information in the asset viewer detail panel by @fabianbees in feat(mobile): Show lens model information in the asset viewer detail panel  #23601
• feat: lazy load thumbnails on people and place list by @lukashass in feat: lazy load thumbnails on people and place list #23682
• feat: make memories slideshow duration configurable by @meesfrensel in feat: make memories slideshow duration configurable #22783
• feat(mobile): chat-style for asset activity view by @idubnori in feat(mobile): chat-style for asset activity view #23347
• feat: show update version info by @alextran1502 in feat: show update version info #23698
• feat(mobile): album activity deep link by @idubnori in feat(mobile): album activity deep link #23737
• feat(web): animate gifs on hover by @meesfrensel in feat(web): animate gifs on hover #23198
• feat(web): disable searching by disabled features by @meesfrensel in feat(web): disable searching by disabled features #23798
• feat: library details page by @danieldietzler in feat: library details page #23908
• feat(web): always view original of animated images by @meesfrensel in feat(web): always view original of animated images #23842
• feat: add originalPath for external library assets in dedupe by @kprkpr in feat: add originalPath for external library assets in dedupe #23710

🐛 Bug fixes

• feat: exif medium tests by @jrasm91 in feat: exif medium tests #23561
• fix(web): fix timezone dropdown for timestamps lacking milliseconds by @skatsubo in fix(web): fix timezone dropdown for timestamps lacking milliseconds #23615
• fix(web): "select all" button in trash and permanently deleted count by @Yonyc in fix(web): "select all" button in trash and permanently deleted count #23594
• fix: fully sync local library on app restart by @alextran1502 in fix: fully sync local library on app restart #23323
• fix: check if unmetered instead of wifi by @shenlong-tanwen in fix: check if unmetered instead of wifi #23380
• fix(mobile): Add fade-in to asset viewer transition by @goalie2002 in fix(mobile): Add fade-in to asset viewer transition #23692
• fix(web): i18n for admin>users>sessions by @meesfrensel in fix(web): i18n for admin>users>sessions #23756
• feat: opt-in sync of deletes and restores from web to Android (beta timeline) by @PeterOmbodi in feat: opt-in sync of deletes and restores from web to Android (beta timeline) #20473
• fix(mobile): Set dynamic height of actions row in BottomSheet by @vitoksmile in fix(mobile): Set dynamic height of actions row in BottomSheet #23755
• fix(mobile): Hide download button in asset viewer "immersive mode" by @goalie2002 in fix(mobile): Hide download button in asset viewer "immersive mode" #23720
• fix(mobile): sync album and asset activity state when add/remove asset level activity by @idubnori in fix(mobile): sync album and asset activity state when add/remove asset level activity #23484
• fix(server): properly handle HEAD requests to SSR paths by @dav-wolff in fix(server): properly handle HEAD requests to SSR paths #23788
• fix(web): make sliding window cover all visible space to show small number of assets by @meesfrensel in fix(web): make sliding window cover all visible space to show small number of assets #23796
• refactor: shared links modals by @danieldietzler in refactor: shared links modals #23803
• chore: bump background_downloader by @shenlong-tanwen in chore: bump background_downloader #23839
• fix(server): include the previous year in memories for January 1, 2, 3 by @skatsubo in fix(server): include the previous year in memories for January 1, 2, 3 #23832
• fix: timeline scroll after navigate by @danieldietzler in fix: timeline scroll after navigate #23664
• fix: prefer filename from body over path in mime validation by @shenlong-tanwen in fix: prefer filename from body over path in mime validation #23810
• fix(web): keep album timeline when selecting cover by @roadev in fix(web): keep album timeline when selecting cover #23819
• fix: word wrap on custom link preview by @100daysummer in fix: word wrap on custom link preview #23942
• fix(mobile): delete from device warning shows incorrectly by @YarosMallorca in fix(mobile): delete from device warning shows incorrectly #23935
• fix: deep link to last asset by @midzelis in fix: deep link to last asset #23920
• fix: null dereference when canceling bucket in album by @midzelis in fix: null dereference when canceling bucket in album #23924
• fix: incorrect header height calculation in estimated month height by @midzelis in fix: incorrect header height calculation in estimated month height #23923
• chore: update drift by @alextran1502 in chore: update drift #23877
• chore: reset remote sync on app update by @shenlong-tanwen in chore: reset remote sync on app update #23969
• fix(server): copy relevant panorama tags to preview image by @meesfrensel in fix(server): copy relevant panorama tags to preview image #23953
• fix: unarchive action doesn't update archive page by @midzelis in fix: unarchive action doesn't update archive page #23987

📚 Documentation

• chore: update config.json example by @bo0tzz in chore: update config.json example #23471
• fix(docs): bump docs for PG versions by @mmomjian in fix(docs): bump docs for PG versions #23714
• feat: endpoint descriptions by @jrasm91 in feat: endpoint descriptions #23813
• feat: endpoint versioning by @jrasm91 in feat: endpoint versioning #23858
• chore: include link to discord server when referencing contribution channel by @Hritik14 in chore: include link to discord server when referencing contribution channel #23728
• fix(docs): update Readme links by @mmomjian in fix(docs): update Readme links #23959

🌐 Translations

• chore(web): update translations by @weblate in chore(web): update translations #23449

New Contributors

• @FreeWind6 made their first contribution in docs: sync ru docs with main README.md #23627
• @Yonyc made their first contribution in fix(web): "select all" button in trash and permanently deleted count #23594
• @fabianbees made their first contribution in feat(mobile): Show lens model information in the asset viewer detail panel  #23601
• @exelix11 made their first contribution in feat(mobile): Quick date picker in the search page #22653
• @AlexanderS made their first contribution in fix: Update module name for rapidocr DownloadFile #23838
• @Hritik14 made their first contribution in chore: include link to discord server when referencing contribution channel #23728
• @roadev made their first contribution in fix(web): keep album timeline when selecting cover #23819
• @zebrapurring made their first contribution in chore: build bcrypt dependency from source #22145
• @happychriss made their first contribution in feat(mobile): add to album from asset viewer #23608
• @insertish made their first contribution in fix: devcontainer server not starting due to missing plugins mount #23948
• @100daysummer made their first contribution in fix: word wrap on custom link preview #23942
• @kprkpr made their first contribution in feat: add originalPath for external library assets in dedupe #23710

Full Changelog: v2.2.3...v2.3.0

---

This discussion was created from the release v2.3.0.

[SandiyosDev]

Nice, Workflows is going to be awesome 😎
Great work, Immich team!!!

[Thedougler]

I am so incredibly excited for the workflow update !! Nicely done

[OverStyleFR]

Nice work !

But can you fix the mobile app on android too please. Specially on Samsung device, I've seen a lot of people like me with a Samsung Galaxy S23 Ultra have trouble with the Immich android application.
Many crash, slow upload (specially with large size).

[alextran1502]

There is also improvement in that regard, please let me know if the new app version help fix the crash issue on Android when uploading asset

[OverStyleFR]

It's actually happen the most of the time on the initial upload.
When you choose to move on Immich for the first time. Normally you don't upload several dozen or even hundreds of files at once.

So i can't tell you if it's happen again. BUT!
I have talk to my friend on this application to an alternative to Google photo or something like, to backup back up these photos and videos from your phone. So when I go to her to explain how this is works, I will be back to tell you if there still the problem.
(she as the same phone as me).

There is also improvement in that regard, please let me know if the new app version help fix the crash issue on Android when uploading asset

[DX37]

Wow, thanks for the new OCR languages!

[rithask]

would love to see OCR as a trigger for workflow

[DevilLnC]

Please add Year View in the Photo Grid - Group By option.

[ppskj178]

OCR support for other languages is here! Thank you so much.

The Workflow feature looks very promising, though it seems like it might take some time to fully mature and support a wide range of functionalities.

Do you happen to have any plans to support Webhooks in the meantime? While I understand that native, internal integration is more user-friendly for general users, reaching a high level of versatility will likely require significant development time. If Webhooks were supported alongside the current API, we could easily and quickly set up automation using external tools like n8n right away.

[nkrabben]

Is there a discussion thread about the planned features for workflows? I've been picking it up from other threads, but haven't seen an overall plan.

[varun-raj]

Please bring webhook support for the workflows and I'll add more extensions in Immich Power tools 🥳

[bo0tzz]

The filters and actions will be backed by WASM plugins, which we'll eventually open up so anyone can make custom ones to do whatever! But the core actions are likely to include a webhook call option eventually as well.