Release v3.0.0

June 9, 2026

— Immich Team

Release notes for v3.0.0 — new merch, release candidates, mobile editing, workflows, recently added, and more!

Release

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! 🎉

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).

New release channel option in version check settings
New release channel option in version check settings

Breaking changes

This release includes several breaking changes; read the full migration guide here. 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.

Migration guide

How to update

First, update the IMMICH_VERSION in your .env file to v3:

- IMMICH_VERSION=v2
+ IMMICH_VERSION=v3

Then run the usual update commands:

docker compose pull && docker compose up -d

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
  • Slideshow on mobile app
  • HLS and real-time video transcoding (preview)
  • 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
  • Perf: 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!

Workflows (preview)

The first preview of Workflows is here! Workflows let you automate actions in your library by chaining triggers, filters, and actions together with a drag-and-drop builder. This is the foundation for many exciting automations to come, and we'd love your feedback as we continue building on it.

You can access the feature from Utilities > Workflows on the web.

Workflows link on the utilities page
Workflows link on the utilities page

From there, you can either create a new blank workflow or browse the premade templates to get a basic understanding of how workflows can be used.

Example workflow templates
Example workflow templates

Workflows editor

Workflow editor with an example workflow
Workflow editor with an example workflow

In the workflows editor, you can switch between the Visual or JSON editor. The visual editor is nice for building out the workflow; the JSON editor is nice for sharing and receiving workflow content from others.

In each workflow, there is a trigger and a sequence of steps.

  • Trigger: this is the entry point of each workflow; when the trigger happens, the steps will be evaluated.
  • Steps: they include Filters (conditions) and Actions (effect), they can be combined to produce the desired effect of the use case you aim for.

List of available workflow steps
List of available workflow steps

Sharing a workflow

You can share the workflow you made with others in two ways; text and JSON. Text is nice for sharing on forum, for show-and-tell. JSON is nice for others to make an exact copy of your workflow's configuration.

Your can copy the text in the workflows summary panel on the lower right of the screen

Workflows summary in text
Workflows summary in text

You can share the JSON content from the copy workflows button in the app bar, switch to the JSON editor, or use the Show schema button in the context menu in the workflows list

JSON Editor
JSON Editor

Show workflow schema
Show workflow schema

We are looking for extensive feedback and looking forward to receiving them from you all.

Background backup improvements

Background backup on Android is now significantly more reliable. The app uses a new periodic task scheduler that plays nicer with Android's background execution limits, properly cleans up tasks, and warns you when battery optimization and notification settings might interfere with backups.

On iOS, the background refresh task now runs its sync and upload work in parallel, so uploads actually start within the short time window iOS allows.

Enable backup option on mobile
Enable backup option on mobile

Recently added page

A new "Recently Added" page on the web and mobile lets you browse your library sorted by when assets were added to Immich, rather than when they were taken. This makes it easier to find what's new when browsing a new batch of imports. You can find the new page in the "Explore" tab on the web and in the "Search" tab on mobile.

Recently added row on the explore page
Recently added row on the explore page

Slideshow (mobile)

The slideshow experience comes to mobile! You can now sit back and let your photos and videos play across the screen, just like on the web.

Slideshow view on mobile
Slideshow view on mobile

HLS and Real-Time Video transcoding (preview)

Immich can now transcode videos on-the-fly without needing to generate offline transcodes. This has been a long-requested feature with many benefits:

  • Quality switching (both manual and automatic)
  • Transcoding to the best codecs supported by the client
  • Lower storage overhead when offline transcoding is disabled
  • HDR for compatible clients (not implemented yet)
  • Remuxing rather than transcoding the original when bandwidth allows it (not implemented yet)

Please note that this feature is still experimental and can change behavior from version to version. It's currently only implemented in the web app, with the mobile app implementation in progress.

To enable real-time transcoding, go to the video transcoding settings (scroll down). Offline transcoding isn't directly affected by enabling it, so if you'd like to disable offline transcoding, you should also adjust the transcode policy. For assets imported prior to v3, you may also need to re-run Metadata Extraction in the job panel for them to be re-processed.

A screenshot of the Immich admin settings, showing a new section "Real-Time Transcoding [Experimental]"
A screenshot of the Immich admin settings, showing a new section "Real-Time Transcoding [Experimental]"

Keep in mind that your server needs to be powerful enough to transcode in real-time for this feature to work well. Hardware acceleration is recommended, but not required, when using this feature.

<Any stats/system usage here?>

New video player for web

A new custom video player on the web app ensures all your devices share the same controls and layout, matching the Immich design. Some basic functions, like changing the playback rate, are available. This should also fix a lot of the problems on iOS, where the OS's controls are hidden behind the Immich navbar.

Open photos in Immich as a gallery on Android

Immich can now act as a gallery/image viewer app on Android. Tap a photo or video in another app, choose Immich, and it opens right in the asset viewer with actions for sharing the file or uploading it to your library.

This is the first iteration of the feature, and refinements to how Immich recognizes files that are already in your library are on the way

"Open with" dialog on Android showing the Immich app as a new option
"Open with" dialog on Android showing the Immich app as a new option
Asset viewer of the mobile app showing the image after using the "open with" dialog
Asset viewer of the mobile app showing the image after using the "open with" dialog

OCR on the mobile app

The asset viewer now has a toggle that highlights recognized text in a photo, and you can select and copy it directly from the image.

A screenshot of the mobile app showing selected text in an image
A screenshot of the mobile app showing selected text in an image

Upload assets directly to an album on mobile

You can now upload local photos directly to an album in the mobile app, including from the asset bottom sheet, instead of uploading first and organizing later. A small change that removes a lot of friction from the backup-and-organize flow.

Select image size when sharing on mobile

When sharing photos from the mobile app, you can now choose the image size before sending; it is handy for keeping shared files small for messaging apps while preserving the option to share at full quality when needed.

You can change the default behavior in the App Settings > Perferences

Share file's size settings
Share file's size settings

You can also pick the option when sharing on-the-fly by long pressing the Share button

On-the-fly picker
On-the-fly picker

Timeline performance Improvements

Browsing months with a huge number of assets is now dramatically smoother and prevents locking up the browser tab page when your instance runs into that scenario.

What's Changed

🚨 Breaking Changes

🫥 Deprecated Changes

🔒 Security

🚀 Features

🌟 Enhancements

🐛 Bug fixes

📚 Documentation

🌐 Translations

New Contributors

Full Changelog: https://github.com/immich-app/immich/compare/v2.7.5...v3.0.0-rc.0

Cheers,
The Immich Team

Download

Android

iOS

Server

Company

FUTO

Purchase

Merch

Sites

Documentation

My Immich

Immich API

Immich Data

Immich Datasets

Awesome Immich

Miscellaneous

Roadmap

Cursed Knowledge

Privacy Policy