Home
Check a coordinate before processing¶
Open Lookup, paste coordinates from a photo you know, and inspect the country, state, city, and matching sources before running against your library. Lookup previews location names without updating Immich assets; it may download country data when needed.
What it can help with¶
- Missing or overly broad location names on photos that already have GPS coordinates.
- Matching around coastlines, islands, administrative boundaries, and airport areas.
- Repeatable processing with locally cached geographic data.
Results depend on the available source data. It cannot add missing GPS coordinates or guarantee a better name for every point. Compare known locations in Lookup first, then choose the settings that fit your library.
To correct existing names, use Location Management to scan your photos, review proposed differences, and apply only the changes you select. Back up the database before applying. Saved scans let you continue unfinished work; Change History records applied names and supports undo when the metadata has not changed. See Correct existing location names.
See Using the App for the workflow and Data Sources for coverage and licence limits.
Before You Run It On Real Data¶
- It needs direct access to your immich database.
- immich's own reverse geocoding should be turned off first.
- It writes back to immich metadata.
- It can clear existing immich location values from the Data page.
- It needs internet access the first time it downloads extra data for a country.
- Large country downloads can consume hundreds of megabytes each.
Turn off immich's built-in reverse geocoding
Immich ReverseGeo writes city, state, and country back into immich.
If immich's own reverse geocoding remains enabled, both systems can overwrite the same fields and step on each other's results.
Disable immich's built-in reverse geocoding before running Immich ReverseGeo. See immich's official docs: Reverse Geocoding and Reverse Geocoding Settings.
Back up your immich database first
Immich ReverseGeo reads from and writes to immich's database.
Before running processing on real assets, and before clearing existing location fields, create a proper immich backup first: Backup and Restore | Immich
