immich/docs/docs/features/img
trommegutten 7e6cd48783
docs: improve and clarify XMP sidecar behavior (#20334)
* docs: improve and clarify XMP sidecar behavior

- Simplified and reorganized the documentation for XMP sidecars
- Clearly separated CLI import vs. external library behavior
- Clarified what metadata fields are stored in the database
- Documented filename rules and storage behavior
- Explained write-back behavior, including permission requirements

* Clarify sidecar write-back behavior for external libraries

Updated documentation to reflect that Immich does not write metadata to sidecar files in external libraries unless the mount is writable.

Mentions silent fail behavior as described in Issue #10538.

* Update xmp-sidecars.md

* Refactor section 1: clarify XMP fields Immich reads and writes

- Rewrote section 1 with a simplified 3-column table: Metadata · Writes to · Reads from
- Corrected date field logic with prioritized read order
- Clarified that Immich only updates fields that have changed
- Removed incorrect mention of dc:title

* docs: clarify tag reading priority (TagsList, HierarchicalSubject, IPTC:Keywords)

Updated the documentation for tag metadata extraction to clarify the prioritized order in which Immich reads tags from imported media:

1. digiKam:TagsList
2. lr:HierarchicalSubject
3. IPTC:Keywords

This reflects the actual logic used in the getTagList()
2025-09-11 14:00:53 +00:00
..
advanced-search-filters.webp docs: update Smart Search feature (#8625) 2024-04-08 14:58:24 -04:00
background-app-refresh.webp chore(docs): clean up and add new content (#15003) 2025-01-02 10:04:14 -06:00
background-foreground-backup.webp chore(docs): clean up and add new content (#15003) 2025-01-02 10:04:14 -06:00
backup-settings-access.webp chore(docs): clean up and add new content (#15003) 2025-01-02 10:04:14 -06:00
facial-recognition-1.webp chore(docs): clean up and add new content (#15003) 2025-01-02 10:04:14 -06:00
facial-recognition-2.webp chore(docs): clean up and add new content (#15003) 2025-01-02 10:04:14 -06:00
facial-recognition-3.webp chore(docs): clean up and add new content (#15003) 2025-01-02 10:04:14 -06:00
facial-recognition-4.webp chore(docs): clean up and add new content (#15003) 2025-01-02 10:04:14 -06:00
folder-access.webp chore(docs): clean up and add new content (#15003) 2025-01-02 10:04:14 -06:00
folder-view-1.webp chore(docs): clean up and add new content (#15003) 2025-01-02 10:04:14 -06:00
folder-view-enable.webp chore(docs): clean up and add new content (#15003) 2025-01-02 10:04:14 -06:00
gcast-enable.webp feat(web): make google cast opt in (#18514) 2025-05-28 15:57:36 -05:00
library-custom-scan-interval.webp chore(docs): clean up and add new content (#15003) 2025-01-02 10:04:14 -06:00
me.webp chore(docs): clean up and add new content (#15003) 2025-01-02 10:04:14 -06:00
mobile-smart-search.webp feat(ml): better multilingual search with nllb models (#13567) 2025-03-31 11:06:57 -04:00
mobile-upload-open-photo.webp chore(docs): clean up and add new content (#15003) 2025-01-02 10:04:14 -06:00
mobile-upload-selected-photos.webp chore(docs): clean up and add new content (#15003) 2025-01-02 10:04:14 -06:00
my-wife.webp chore(docs): clean up and add new content (#15003) 2025-01-02 10:04:14 -06:00
obtain-api-key.webp chore(docs): clean up and add new content (#15003) 2025-01-02 10:04:14 -06:00
partner-sharing-1.webp chore(docs): clean up and add new content (#15003) 2025-01-02 10:04:14 -06:00
partner-sharing-2.webp chore(docs): clean up and add new content (#15003) 2025-01-02 10:04:14 -06:00
partner-sharing-3.webp chore(docs): clean up and add new content (#15003) 2025-01-02 10:04:14 -06:00
partner-sharing-4.webp chore(docs): clean up and add new content (#15003) 2025-01-02 10:04:14 -06:00
partner-sharing-5.webp chore(docs): clean up and add new content (#15003) 2025-01-02 10:04:14 -06:00
partner-sharing-6.webp chore(docs): clean up and add new content (#15003) 2025-01-02 10:04:14 -06:00
partner-sharing-7.webp chore(docs): clean up and add new content (#15003) 2025-01-02 10:04:14 -06:00
partner-sharing-8.webp chore(docs): clean up and add new content (#15003) 2025-01-02 10:04:14 -06:00
public-shared-link-album.webp chore(docs): clean up and add new content (#15003) 2025-01-02 10:04:14 -06:00
public-shared-link-form.webp chore(docs): clean up and add new content (#15003) 2025-01-02 10:04:14 -06:00
public-shared-link-individual.webp chore(docs): clean up and add new content (#15003) 2025-01-02 10:04:14 -06:00
reverse-geocoding-mobile1.webp chore(docs): clean up and add new content (#15003) 2025-01-02 10:04:14 -06:00
reverse-geocoding-mobile2.webp chore(docs): clean up and add new content (#15003) 2025-01-02 10:04:14 -06:00
reverse-geocoding-mobile3.webp chore(docs): clean up and add new content (#15003) 2025-01-02 10:04:14 -06:00
search-ex-1.webp chore(docs): clean up and add new content (#15003) 2025-01-02 10:04:14 -06:00
shared-album-mobile.webp chore(docs): clean up and add new content (#15003) 2025-01-02 10:04:14 -06:00
shared-album-user-selection.webp chore(docs): clean up and add new content (#15003) 2025-01-02 10:04:14 -06:00
shared-album.webp chore(docs): clean up and add new content (#15003) 2025-01-02 10:04:14 -06:00
sidecar-jobs.webp chore(docs): clean up and add new content (#15003) 2025-01-02 10:04:14 -06:00
tag-creation.webp chore(docs): clean up and add new content (#15003) 2025-01-02 10:04:14 -06:00
tag-enable.webp chore(docs): clean up and add new content (#15003) 2025-01-02 10:04:14 -06:00
tag-form.webp chore(docs): clean up and add new content (#15003) 2025-01-02 10:04:14 -06:00
tag-view.webp chore(docs): clean up and add new content (#15003) 2025-01-02 10:04:14 -06:00
user-change-password.webp chore(docs): clean up and add new content (#15003) 2025-01-02 10:04:14 -06:00
user-popup.webp chore(docs): clean up and add new content (#15003) 2025-01-02 10:04:14 -06:00
user-profile.webp chore(docs): clean up and add new content (#15003) 2025-01-02 10:04:14 -06:00
user-settings-1.webp chore(docs): clean up and add new content (#15003) 2025-01-02 10:04:14 -06:00
user-settings-2.webp chore(docs): clean up and add new content (#15003) 2025-01-02 10:04:14 -06:00
user-settings-3.webp chore(docs): clean up and add new content (#15003) 2025-01-02 10:04:14 -06:00