Release v3.0.0 | Immich Blog

Blog<br>Release v3.0.0<br>Release v3.0.0<br>July 1, 2026<br>— Immich Team

Release notes for v3.0.0 — new merch, release candidates, mobile editing, workflows, recently added, and more!<br>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! 🎉

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 only affect 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<br>+ IMMICH_VERSION=v3

Then run the usual update commands:

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

New release channel option in version check settings

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<br>Colored embroidery: We now have clothes with a full color embroidered Immich logo

Check it out now at https://immich.store!

Highlights

Now, let's get right into all the new features in this release:

Mobile non-destructive editing<br>Workflows (preview)<br>Background backup improvement<br>Recently added page<br>Integrity checks<br>Slideshow on mobile app<br>HLS and real-time video transcoding (preview)<br>New video player for web<br>Open photo in Immich as gallery on Android<br>OCR on mobile app<br>Upload asset directly to album on the mobile app<br>Option to select image size when sharing on the mobile app<br>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<br>Editing live photos<br>Editing local assets

We have plans to bring some of these capabilities back in future releases.

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

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

Workflows editor

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 occurs, the steps are evaluated.<br>Steps: they include Filters (conditions) and Actions (effects); they can be combined to produce the desired effect of the use case you aim for.

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 a forum or for show-and-tell content. JSON is nice for others to make an exact copy of your workflow's configuration.

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

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