Photo metadata

Why this matters

Metadata embedded in an image file travels with the file. Photo CMSs (Photo Mechanic, Lightroom, Capture One) and wire intake systems read a photo's caption, credit, and rights from its IPTC and XMP blocks — not from a separate document or the email it arrived in. If the caption, credit, alt text, and license are not inside the file, they are gone the moment the photo is downloaded, forwarded, or re-uploaded.

One exiftool pass writes the EXIF, IPTC, and XMP layers together and leaves every other tag (camera settings, shot time) untouched. Embedded metadata is what lets a partner newsroom find a photo, credit it correctly, and republish it under a clear license without contacting the photographer. Strip it, and the same photo is an orphaned file.

When to use

• Prepping press photos for a wire so partner newsrooms can search, credit, and republish them
• Adding required photographer attribution and a reuse license before publishing or sharing
• Batch-tagging a shoot (a folder of images)
• Making images accessible (embedded alt text) and rights-clear (copyright or Creative Commons)

When not to use: editing pixels (this is metadata only); writing alt text for an HTML <img> tag (use accessibility-compliance); preserving web pages as evidence (use web-archiving).

The discipline

These are the failures a capable model makes anyway. They matter more than any tag name.

Field map

A JPEG can carry the same fact in three places. Write all three; exiftool keeps them consistent. EXIF is written by the camera and survives tools that strip other layers. IPTC-IIM is the legacy newsroom standard; wire intake systems still index it first. XMP is the modern XML layer with no byte limits.

One pass that writes all three layers

This command tags a single file with photographer, credit, caption, alt text, keywords, copyright, Creative Commons license, and location — then copies the shoot date from EXIF rather than typing it.

CAPTION="A crowd holds signs outside the Mercer County Courthouse, Friday, June 19, 2026, in Trenton, N.J. (Dana Rivera/Example News Collective)"
ALT="A crowd of people holding handmade signs stands on the steps of a stone courthouse."

exiftool -codedcharacterset=utf8 -overwrite_original \
  -EXIF:Artist="Dana Rivera" -XMP-dc:Creator="Dana Rivera" -IPTC:By-line="Dana Rivera" \
  -IPTC:Credit="Example News Collective" -XMP-photoshop:Credit="Dana Rivera / Example News Collective" \
  -IPTC:Caption-Abstract="$CAPTION" -XMP-dc:Description="$CAPTION" \
    -EXIF:ImageDescription="$CAPTION" -XMP-iptcCore:ExtDescrAccessibility="$CAPTION" \
  -XMP-iptcCore:AltTextAccessibility="$ALT" \
  -IPTC:Keywords="protest" -IPTC:Keywords+="Trenton" \
    -XMP-dc:Subject="protest" -XMP-dc:Subject+="Trenton" \
  -EXIF:Copyright="(c) 2026 Example News Collective. Licensed CC BY 4.0." \
    -IPTC:CopyrightNotice="(c) 2026 Example News Collective. CC BY 4.0." \
    -XMP-dc:Rights="(c) 2026 Example News Collective. Licensed CC BY 4.0." \
  -XMP-xmpRights:Marked=True \
    -XMP-xmpRights:WebStatement="https://creativecommons.org/licenses/by/4.0/" \
    -XMP-xmpRights:UsageTerms="Licensed CC BY 4.0. Credit: Dana Rivera / Example News Collective." \
    -XMP-cc:License="https://creativecommons.org/licenses/by/4.0/" \
    -XMP-cc:AttributionName="Dana Rivera / Example News Collective" \
  -IPTC:City="Trenton" -IPTC:Province-State="New Jersey" \
    -IPTC:Country-PrimaryLocationName="United States" -IPTC:Country-PrimaryLocationCode="USA" \
  "-IPTC:DateCreated<EXIF:DateTimeOriginal" "-IPTC:TimeCreated<EXIF:DateTimeOriginal" \
    "-XMP-photoshop:DateCreated<EXIF:DateTimeOriginal" \
  photo.jpg

Then verify from the file — the step that gets skipped:

exiftool -G1 -s -IPTC:By-line -IPTC:Caption-Abstract \
  -XMP-iptcCore:AltTextAccessibility -XMP-cc:License -IPTC:Keywords photo.jpg

Batch tagging a folder

For a shoot, drive exiftool from a manifest instead of one command per file. embed.py in this skill's directory takes a folder plus a JSON manifest — constant credit and license fields, then per-image alt text, caption, and keywords — writes tagged copies, and reads each one back to confirm the metadata landed. Run python3 embed.py --help.

Common mistakes

IPTC-IIM byte limits

IIM fields are byte-capped; exiftool truncates silently unless you pass -m. XMP has no limit, so put the short form in IPTC and the full form in XMP. Use -codedcharacterset=utf8 so accented names and curly quotes survive in the IPTC layer.

Installation

Or browse this skill in the GitHub repository.

Related skills