I
Immich2mo ago
tyman00

MP4 Description and Tags from EXIF

I'm new to using EXIF data with MP4's, so I fully expect I am doing something wrong where I am unable to get Immich to populate the Description and Tag fields. I did check the file with ExifTool and it does report my values in the Title, Comment and Category metadata fields. Any insight from someone with experience?
7 Replies
Immich
Immich2mo ago
:wave: Hey @tyman00, Thanks for reaching out to us. Please carefully read this message and follow the recommended actions. This will help us be more effective in our support effort and leave more time for building Immich :immich:. References - Container Logs: docker compose logs docs - Container Status: docker ps -a docs - Reverse Proxy: https://immich.app/docs/administration/reverse-proxy - Code Formatting https://support.discord.com/hc/en-us/articles/210298617-Markdown-Text-101-Chat-Formatting-Bold-Italic-Underline#h_01GY0DAKGXDEHE263BCAYEGFJA Checklist I have... 1. :ballot_box_with_check: verified I'm on the latest release(note that mobile app releases may take some time). 2. :ballot_box_with_check: read applicable release notes. 3. :ballot_box_with_check: reviewed the FAQs for known issues. 4. :ballot_box_with_check: reviewed Github for known issues. 5. :ballot_box_with_check: tried accessing Immich via local ip (without a custom reverse proxy). 6. :blue_square: uploaded the relevant information (see below). 7. :ballot_box_with_check: tried an incognito window, disabled extensions, cleared mobile app cache, logged out and back in, different browsers, etc. as applicable (an item can be marked as "complete" by reacting with the appropriate number) Information In order to be able to effectively help you, we need you to provide clear information to show what the problem is. The exact details needed vary per case, but here is a list of things to consider: - Your docker-compose.yml and .env files. - Logs from all the containers and their status (see above). - All the troubleshooting steps you've tried so far. - Any recent changes you've made to Immich or your system. - Details about your system (both software/OS and hardware). - Details about your storage (filesystems, type of disks, output of commands like fdisk -l and df -h). - The version of the Immich server, mobile app, and other relevant pieces. - Any other information that you think might be relevant. Please paste files and logs with proper code formatting, and especially avoid blurry screenshots. Without the right information we can't work out what the problem is. Help us help you ;) If this ticket can be closed you can use the /close command, and re-open it later if needed.
Sergey Katsubo
Sergey Katsubo2mo ago
Hey @tyman00 Could you describe a bit more 1. What you do 2. What you expect 3. What you observe Immich uses "Description" and "ImageDescription". My test + some more info/details/references. 1. Test mp4 file with fields added manually outside Immich: exiftool -G1 trim.mp4 | grep -Ei 'title|comment|category|mp4':
[File] MIME Type : video/mp4
[ItemList] Comment : This is comment
[XMP-dc] Title : This is title
[XMP-photoshop] Category : This is category
[File] MIME Type : video/mp4
[ItemList] Comment : This is comment
[XMP-dc] Title : This is title
[XMP-photoshop] Category : This is category
2. Uploading mp4 to Immich, logs:
POST /api/assets 201
{"deviceAssetId":"web-trim.mp4-1755641444617","deviceId":"WEB",...}
Exif Tags
Object(88) {
...
Comment: 'This is comment',
Title: 'This is title',
Category: 'This is category',
}
POST /api/assets 201
{"deviceAssetId":"web-trim.mp4-1755641444617","deviceId":"WEB",...}
Exif Tags
Object(88) {
...
Comment: 'This is comment',
Title: 'This is title',
Category: 'This is category',
}
3. The description is empty in UI. 4. Editing description in UI, logs:
PUT /api/assets/2dd8b70e-5ea6-4b78-a25f-12a53ce14ac7 200
{"description":"This is description created in Immich"}
Exif Tags
Object(90) {
...
Comment: 'This is comment',
Title: 'This is title',
Category: 'This is category',
ImageDescription: 'This is description created in Immich',
Description: 'This is description created in Immich'
}
PUT /api/assets/2dd8b70e-5ea6-4b78-a25f-12a53ce14ac7 200
{"description":"This is description created in Immich"}
Exif Tags
Object(90) {
...
Comment: 'This is comment',
Title: 'This is title',
Category: 'This is category',
ImageDescription: 'This is description created in Immich',
Description: 'This is description created in Immich'
}
5. From Immich sources:
description: String(exifTags.ImageDescription || exifTags.Description || '').trim(),
description: String(exifTags.ImageDescription || exifTags.Description || '').trim(),
https://github.com/immich-app/immich/blob/f422b341d163a88acfd2f7efada556e956005d5b/server/src/services/metadata.service.ts#L280 6. Immich writes metadata into XMP sidecar, avoiding modification of the original file exiftool -G1 library/library/admin/2025/2025-08/trim.mp4.xmp:
[System] File Name : trim.mp4.xmp
[File] MIME Type : application/rdf+xml
[XMP-dc] Description : This is description created in Immich
[XMP-tiff] Image Description : This is description created in Immich
[System] File Name : trim.mp4.xmp
[File] MIME Type : application/rdf+xml
[XMP-dc] Description : This is description created in Immich
[XMP-tiff] Image Description : This is description created in Immich
7. Tangentially related - "[Feature] Display option to be more comments/description friendly" https://github.com/immich-app/immich/discussions/15619
Immich
Immich2mo ago
description: String(exifTags.ImageDescription || exifTags.Description || '').trim(),
description: String(exifTags.ImageDescription || exifTags.Description || '').trim(),
[Discussion] [Feature] Display option to be more comments/description friendly (immich-app/immich#15619)
tyman00
tyman00OP2mo ago
Hi @Sergey Katsubo , thank you for the response. In order to make sure I'm not wasting your time I'll digest your response and respond accordingly a little later today. @Sergey Katsubo thanks again for your help so far. I'm currently attempting to add generic and common descriptions to my photos and MP4 videos in an effort to show the person that provided the photo to me for an album that will be shared with extended family. It's meant to be a quick and temporary solution until shared user tags, people data, etc is built into Immich. I know this has been heavily discussed and acknowledged by the team, so I don't intend to pile on. 1. & 2. My goal is to add the comments to the metadata before uploading. I was able to work it out for the photos in bulk using DigiKam. MP4's are not working as well. I'm willing to do the videos individually before uploading, if necessary. I'm currently trying to modify the metadata just using the Windows capabilities. 3.) When I upload to Immich, the coordinates and camera metadata is read and displayed, but the description is not. Tagging would be great too, if possible. When I run exiftool in WSL, I get the following compared to your example:
exiftool -G1 20250817_200359.mp4 | grep -Ei 'title|
comment|category|mp4'
[System] File Name : 20250817_200359.mp4
[File] File Type : MP4
[File] File Type Extension : mp4
[File] MIME Type : video/mp4
[QuickTime] Major Brand : MP4 v2 [ISO 14496-14]
[QuickTime] Compatible Brands : isom, mp42
[ItemList] Title : Uploaded By: Tyman
[ItemList] Comment : Uploaded By: Tyman
[Microsoft] Category : Uploaded By: Tyman
[Track2] Audio Format : mp4a
exiftool -G1 20250817_200359.mp4 | grep -Ei 'title|
comment|category|mp4'
[System] File Name : 20250817_200359.mp4
[File] File Type : MP4
[File] File Type Extension : mp4
[File] MIME Type : video/mp4
[QuickTime] Major Brand : MP4 v2 [ISO 14496-14]
[QuickTime] Compatible Brands : isom, mp42
[ItemList] Title : Uploaded By: Tyman
[ItemList] Comment : Uploaded By: Tyman
[Microsoft] Category : Uploaded By: Tyman
[Track2] Audio Format : mp4a
I'll play around with adding the Metadata using something more reliable and robust than the file properties dialogue in Windows and report back. @Sergey Katsubo Well, that follow up was easier than I expected! I ran the following on my video file prior to uploading:
exiftool -ImageDescription="Thank you, Sergey!" -Description="Thank you, Sergey!" 20250817_200359.mp4
exiftool -ImageDescription="Thank you, Sergey!" -Description="Thank you, Sergey!" 20250817_200359.mp4
Immich was able to pull the description upon upload and pre-populate it as I expected. I'm hoping to be more comfortable with Immich and the various support and development resources so I can troubleshoot these things on my own without having to bother anyone. I really appreciate your help!
Immich
Immich2mo ago
This thread has been closed. To re-open, use the button below.
tyman00
tyman00OP2mo ago
Brief update for anyone finding this in search. I was attempting to use DigiKam to have a graphical interface to update my tags and description in bulk. I was able to assign a tag to the images in bulk and then used the bulk queue manager to assign the "caption" field to be read in as the description in Immich. To ensure it worked on images and video files, I enabled the setting in DigiKam to use ExifTool instead of Exiv2 (https://www.reddit.com/r/kde/comments/u09w2a/with_next_digikam_800_we_add_a_new_option_to/#lightbox). Immich seems to like the way it's written to video files better this way.
Reddit
From the kde community on Reddit: With next digiKam 8.0.0, we add a...
Explore this post and more from the kde community
Sergey Katsubo
Sergey Katsubo2mo ago
Thanks for sharing!

Did you find this page helpful?