What each of Immich's goals does, in plain words.
A mechanic is the kind of action behind something an app lets you do, named the same way in every app. Here every Immich goal sits under its mechanic, and each row opens the goals behind it. See what that means on one book.
Immich · production's goal records, read 21 Oct 2026, 18:43 UTC (store seq 468538) · named with featkpr's mechanics list 1.0.5 · 154 goals under 27 of 34 mechanics, 143 rows

Immich's Bin screen, and what its buttons do
-
Empty bin Deletes it for good
-
Restore all Brings it back
featkpr reads Immich's “Delete assets” goal as “Moves it to the bin” (Likely): this screen's “Restore all” is another goal that brings the same assets back. “Empty bin” is still “Deletes it for good”, the bin's own permanent delete. A run will settle how sure.
Seven families, the same rows for every app #
A bar per mechanic Immich uses, counted in goals. A family Immich has nothing in still gets its row, so the gaps show.
Nothing in Immich: Amounts
Make or remove 58 goals · 6 of 6 mechanics #
Change 43 goals · 4 of 6 mechanics #
not used here: Moves it somewhere else · Changes the order
Connect 17 goals · 4 of 5 mechanics #
not used here: Lets someone do more
Look and find 13 goals · 4 of 5 mechanics #
not used here: Downloads it as a file
Bring in or send 5 goals · 3 of 4 mechanics #
not used here: Notes down what happened
People and access 18 goals · 6 of 6 mechanics #
Amounts none in Immich #
not used here: Sets an amount aside · Moves an amount from one to another
Every mechanic on every thing #
One row is one mechanic on one thing in Immich. Type a word, or pick a family or how sure; each row opens its goals.
- 2
Deletes it for good on asset metadata #
its 2 goals
- Delete asset metadataA guess
- Delete asset metadata by keyA guess
- 1
Deletes it for good on activity #
its goal
- Delete an activityA guess
- 1
Deletes it for good on album #
its goal
- Delete an albumA guess
- 1
Deletes it for good on asset edits #
its goal
- Remove edits from an existing assetA guess
- 1
Deletes it for good on asset file #
its goal
- Delete an asset fileA guess
- 1
Deletes it for good on asset from stack #
its goal
- Remove an asset from a stackA guess
- 1
Deletes it for good on database backup #
its goal
- Delete database backupA guess
- 1
Deletes it for good on duplicates #
its goal
- Delete duplicatesA guess
- 1
Deletes it for good on face #
its goal
- Delete a faceA guess
- 1
Deletes it for good on integrity report #
its goal
- Delete integrity report itemA guess
- 1
Deletes it for good on library #
its goal
- Delete a libraryA guess
- 1
Deletes it for good on memory #
its goal
- Delete a memoryA guess
- 1
Deletes it for good on notification #
its goal
- Delete a notificationA guess
- 1
Deletes it for good on notifications #
its goal
- Delete notificationsA guess
- 1
Deletes it for good on partner #
its goal
- Remove a partnerA guess
- 1
Deletes it for good on people #
its goal
- Delete peopleA guess
- 1
Deletes it for good on person #
its goal
- Delete personA guess
- 1
Deletes it for good on profile image #
its goal
- Delete user profile imageA guess
- 1
Deletes it for good on queue #
its goal
- Empty a queueLikely
- 1
Deletes it for good on session #
its goal
- Delete a sessionA guess
- 1
Deletes it for good on sessions #
its goal
- Delete all sessionsA guess
- 1
Deletes it for good on shared link #
its goal
- Delete a shared linkA guess
- 1
Deletes it for good on stack #
its goal
- Delete a stackA guess
- 1
Deletes it for good on stacks #
its goal
- Delete stacksA guess
- 1
Deletes it for good on sync ack #
its goal
- Delete acknowledgementsA guess
- 1
Deletes it for good on tag #
its goal
- Delete a tagA guess
- 1
Deletes it for good on trash #
its goal
- Empty trashLikely
- 1
Deletes it for good on user from album #
its goal
- Remove user from albumA guess
- 1
Deletes it for good on user license #
its goal
- Delete user product keyA guess
- 1
Deletes it for good on workflow #
its goal
- Delete a workflowA guess
- 1
Makes a new one on album #
its goal
- Create an albumLikely
- 1
Makes a new one on cluster group request #
its goal
- Create a cluster group requestLikely
- 1
Makes a new one on duplicates resolve #
its goal
- Create a duplicates resolveLikely
- 1
Makes a new one on face #
its goal
- Create a faceLikely
- 1
Makes a new one on job #
its goal
- Create a manual jobLikely
- 1
Makes a new one on library #
its goal
- Create a libraryLikely
- 1
Makes a new one on memory #
its goal
- Create a memoryLikely
- 1
Makes a new one on notification #
its goal
- Create a notificationLikely
- 1
Makes a new one on partner #
its goal
- Create a partnerLikely
- 1
Makes a new one on partner deprecated #
its goal
- Create a partner deprecatedLikely
- 1
Makes a new one on person #
its goal
- Create a personLikely
- 1
Makes a new one on predict #
its goal
- Create a predictLikely
- 1
Makes a new one on profile image #
its goal
- Create user profile imageLikely
- 1
Makes a new one on session #
its goal
- Create a sessionLikely
- 1
Makes a new one on shared link #
its goal
- Create a shared linkLikely
- 1
Makes a new one on stack #
its goal
- Create a stackLikely
- 1
Makes a new one on tag #
its goal
- Create a tagLikely
- 1
Makes a new one on user admin #
its goal
- Create a userLikely
- 1
Makes a new one on workflow #
its goal
- Create a workflowLikely
- 1
Brings it back on assets #
its goal
- Restore assetsLikely
- 1
Brings it back on database restore flow #
its goal
- Start database backup restore flowFrom the code
- 1
Brings it back on trash #
its goal
- Restore trashFrom the code
- 1
Brings it back on user admin #
its goal
- Restore a deleted userFrom the code
- 1
Moves it to the bin on assets #
its goal
- Delete assetsLikely
- 1
Moves it to the bin on user admin #
its goal
- Delete a userLikely
- 1
Puts it away, still readable on archive #
its goal
- Download asset archiveLikely
- 1
Makes a copy of it on asset #
its goal
- Copy assetFrom the code
- 2
Changes it on asset #
its 2 goals
- Apply edits to an existing assetA guess
- Update an assetLikely
- 2
Changes it on asset metadata #
its 2 goals
- Update asset metadataA guess
- Upsert asset metadataA guess
- 1
Changes it on admin config #
its goal
- Update the system configurationA guess
- 1
Changes it on album info #
its goal
- Update an albumLikely
- 1
Changes it on album user #
its goal
- Update user roleLikely
- 1
Changes it on api key #
its goal
- Update an API keyLikely
- 1
Changes it on assets #
its goal
- Update assetsA guess
- 1
Changes it on config #
its goal
- Update system configurationA guess
- 1
Changes it on library #
its goal
- Update a libraryLikely
- 1
Changes it on maintenance mode #
its goal
- Set maintenance modeA guess
- 1
Changes it on memory #
its goal
- Update a memoryLikely
- 1
Changes it on my preferences #
its goal
- Update my preferencesA guess
- 1
Changes it on my user #
its goal
- Update current userA guess
- 1
Changes it on notification #
its goal
- Update a notificationLikely
- 1
Changes it on notifications #
its goal
- Update notificationsA guess
- 1
Changes it on partner #
its goal
- Update a partnerLikely
- 1
Changes it on password #
its goal
- Change passwordA guess
- 1
Changes it on people #
its goal
- Update peopleA guess
- 1
Changes it on person #
its goal
- Update personLikely
- 1
Changes it on session #
its goal
- Update a sessionLikely
- 1
Changes it on shared link #
its goal
- Update a shared linkLikely
- 1
Changes it on stack #
its goal
- Update a stackLikely
- 1
Changes it on tag #
its goal
- Update a tagLikely
- 1
Changes it on tags #
its goal
- Upsert tagsA guess
- 1
Changes it on user admin #
its goal
- Update a userLikely
- 1
Changes it on user license #
its goal
- Set user product keyA guess
- 1
Changes it on user preferences admin #
its goal
- Update user preferencesA guess
- 1
Changes it on workflow #
its goal
- Update a workflowLikely
- 2
Turns it on or off on user onboarding #
its 2 goals
- Delete user onboardingFrom the code
- Update user onboardingFrom the code
- 1
Turns it on or off on admin onboarding #
its goal
- Update admin onboardingFrom the code
- 1
Turns it on or off on auth session #
its goal
- Lock auth sessionFrom the code
- 1
Turns it on or off on queue #
its goal
- Update a queueFrom the code
- 1
Turns it on or off on session #
its goal
- Lock a sessionFrom the code
- 2
Moves it to its next step on cluster group request #
its 2 goals
- Accept a cluster group requestFrom the code
- Decline a cluster group requestA guess
- 1
Moves it to its next step on duplicate #
its goal
- Dismiss a duplicate groupA guess
- 1
Moves it to its next step on o auth #
its goal
- Finish OAuthLikely
- 1
Moves it to its next step on sync ack #
its goal
- Acknowledge changesA guess
- 1
Joins or splits them on people #
its goal
- Merge the peopleFrom the code
- 1
Joins or splits them on person legacy #
its goal
- Merge the person legacyFrom the code
- 2
Connects it to another one on assets #
its 2 goals
- Tag the assetsFrom the code
- Tag the assets (bulk)From the code
- 1
Connects it to another one on assets to album #
its goal
- Add assets to an albumFrom the code
- 1
Connects it to another one on assets to albums #
its goal
- Add assets to albumsFrom the code
- 1
Connects it to another one on memory assets #
its goal
- Add assets to a memoryFrom the code
- 1
Connects it to another one on o auth account #
its goal
- Link OAuth accountLikely
- 1
Connects it to another one on shared link assets #
its goal
- Add assets to a shared linkFrom the code
- 1
Disconnects it from another one on asset from album #
its goal
- Remove assets from an albumFrom the code
- 1
Disconnects it from another one on assets #
its goal
- Untag assetsFrom the code
- 1
Disconnects it from another one on cluster group #
its goal
- Leave a cluster groupLikely
- 1
Disconnects it from another one on memory assets #
its goal
- Remove assets from a memoryFrom the code
- 1
Disconnects it from another one on o auth account #
its goal
- Unlink OAuth accountLikely
- 1
Disconnects it from another one on o auth accounts admin #
its goal
- Unlink all OAuth accountsLikely
- 1
Disconnects it from another one on shared link assets #
its goal
- Remove assets from a shared linkFrom the code
- 1
Gives it to someone on faces #
its goal
- Reassign facesLikely
- 1
Gives it to someone on faces by id #
its goal
- Reassign a face to another personLikely
- 1
Lets someone else see it on users to album #
its goal
- Share album with usersLikely
- 1
Finds the matching ones on asset statistics #
its goal
- Search asset statisticsFrom the code
- 1
Finds the matching ones on assets #
its goal
- Search assets by metadataFrom the code
- 1
Finds the matching ones on large assets #
its goal
- Search large assetsFrom the code
- 1
Finds the matching ones on random #
its goal
- Search random assetsFrom the code
- 1
Finds the matching ones on smart #
its goal
- Search the smartFrom the code
- 2
Checks that it is right on library #
its 2 goals
- Scan a libraryLikely
- Validate library settingsFrom the code
- 1
Checks that it is right on access token #
its goal
- Validate access tokenLikely
- 1
Checks that it is right on upload #
its goal
- Check bulk uploadLikely
- 1
Shows it on download info #
its goal
- Retrieve download informationLikely
- 1
Shows it on notification template admin #
its goal
- Get the notification template adminLikely
- 1
Shows it on sync stream #
its goal
- Get the sync streamLikely
- 1
Builds a result from what is there on people #
its goal
- Regenerate people of users in cluster groupLikely
- 1
Brings rows in from a file on asset #
its goal
- Upload assetA guess
- 1
Brings rows in from a file on database backup #
its goal
- Upload database backupA guess
- 1
Starts a job on asset jobs #
its goal
- Run an asset jobA guess
- 1
Starts a job on queue command legacy #
its goal
- Run jobsA guess
- 1
Sends a message on test email admin #
its goal
- Send test emailFrom the code
- 3
Sets a password or key on api key #
its 3 goals
- Create an API keyLikely
- Delete an API keyLikely
- Rotate an API keyFrom the code
- 2
Sets a password or key on pin code #
its 2 goals
- Change pin codeFrom the code
- Reset pin codeFrom the code
- 1
Sets a password or key on auth pin code #
its goal
- Create an auth pin codeLikely
- 1
Signs you in on admin maintenance #
its goal
- Login the admin maintenanceFrom the code
- 1
Signs you in on auth #
its goal
- LoginFrom the code
- 1
Signs you in on auth session #
its goal
- Unlock auth sessionLikely
- 1
Signs you in on o auth #
its goal
- Start OAuthLikely
- 1
Signs you in on shared link #
its goal
- Login the shared linkFrom the code
- 1
Signs you out on auth #
its goal
- LogoutFrom the code
- 1
Signs you out on o auth #
its goal
- Logout the o authLikely
- 1
Signs you out on video stream #
its goal
- Delete the video streamFrom the code
- 2
Changes a setting on server license #
its 2 goals
- Delete server product keyLikely
- Set server product keyFrom the code
- 1
Adds a comment or reaction on activity #
its goal
- Create an activityLikely
- 1
Makes a new account on auth admin sign up #
its goal
- Register adminLikely
Nothing matches. Clear the search or a chip to widen it.
What works today, and what does not yet #
Works today as of 21 Oct 2026
Not yet
Your app, row by row like this #
On the call we open Immich's rows, then read your app the same way. Tim replies by hand.