
A comma in ExifTool's displayed keyword output is not proof that the file contains two keyword entries. Decide the intended list first, inspect it with a separator that cannot be mistaken for ordinary punctuation, then write separate list items deliberately. Replacing the list and appending to it are different operations.
Make the ambiguity visible
Suppose the intended keywords are two items: “Studio, north room” and “Ceramics”. A comma-separated display can look like three items. Before editing a working copy, inspect the specific metadata fields:
exiftool -a -G1 -s -sep " || " -XMP-dc:Subject -IPTC:Keywords sample.jpg
Here the unusual display separator helps distinguish item boundaries from commas inside a label. Choose another separator if your real vocabulary contains || .
The application reference for -sep documents the list separator for reading and writing. A comma inside one assigned value is not automatically an instruction to create two list items; choose separator behavior deliberately.
Write the intended items, not a visually similar sentence
On a disposable copy, this example replaces the XMP Subject list with two entries:
exiftool -XMP-dc:Subject= -XMP-dc:Subject="Studio, north room" -XMP-dc:Subject=Ceramics sample.jpg
The explicit empty assignment clears that target list before the two values are supplied. It does not clear IPTC Keywords or every other keyword representation.
If the existing XMP list is approved and you only intend to add one item, use append syntax instead:
exiftool -XMP-dc:Subject+="Studio, north room" sample.jpg
These are alternative examples, not two commands to run in sequence. ExifTool's application documentation covers list assignment, separator handling and append behavior. Do not add -sep ", " when the comma-space belongs inside one keyword.
Resolve disagreement between keyword fields
Read both XMP Subject and IPTC Keywords again after the test. If one now contains the approved list and the other has old labels, that is an actual field disagreement, not necessarily an unsuccessful XMP write. Decide which fields the receiving application reads and which representations your delivery contract requires.
Do not synchronize unrelated fields blindly. A hierarchy label, a person's name and a public subject description may have different release permissions. Lightroom's keyword export options need their own check when a catalog later renders the delivery copy.
Check boundaries and update intent
The acceptance test is exact item count and exact item text in the chosen field. For the hypothetical example, “Studio, north room” remains one item and “Ceramics” remains another. Confirm that append retained an existing approved item, or that replacement removed a deliberately obsolete one.
If a spreadsheet feeds the write, inspect whether it converted the list into one quoted text cell before ExifTool received it. If a catalog shows different values, resolve its file-versus-catalog authority before reading or writing metadata there. Correct punctuation is useful only when the underlying list and synchronization direction are also correct.
Related tasks
- Why Do Unexpected Keywords Appear in My Exported Photos?
- Lightroom Metadata Conflict: Keep the Disk or Catalog Version?
Sources and scope
- ExifTool Application Documentation: The -sep option sets the read/write separator for list values; repeated list assignments and += provide different replacement and append operations.
Documentation-based guidance researched on 23 October 2026 (Asia/Shanghai). The linked official ExifTool technical pages were retrieved with HTTP 200 and their relevant text was checked. Commands and acceptance procedures are proposed examples, not reported hands-on tests. ExifTool version and file-format support must be checked on the receiving system.
Prepared by Imagild Editorial, the company editorial team responsible for these guides. AI assisted research and drafting. This is documentation-based guidance with proposed examples, not a claim of hands-on testing or an independent product review. Report a correction.
Cover: Mariya Eskina / Pexels, Pexels License. This is an illustrative source photograph, not an application screenshot or a generated test result.