
ExifTool can read unfamiliar XMP properties without knowing how to write them. To update a custom field, provide a writable tag definition that matches the asset system's namespace URI, property name and data type. A familiar label in the output is not enough to define that contract.
Identify the stored schema first
Ask the receiving system's owner for its actual namespace URI and property specification. A local namespace prefix is an abbreviation; matching only that prefix can put data into the wrong schema.
The official ExifTool configuration example documents user-defined XMP tables and the difference between readable unknown information and writable definitions. Prefer an existing standard property when it accurately represents the required information.
A metadata configuration is Perl code, so review its origin and contents before loading it. Do not execute a file copied from an untrusted image's metadata.
Understand a minimal definition
This hypothetical example defines a simple string property for an illustrative handoff schema. It is not an Imagild product feature or a deployed archive standard:
%Image::ExifTool::UserDefined = (
'Image::ExifTool::XMP::Main' => {
handoff => {
SubDirectory => {
TagTable => 'Image::ExifTool::UserDefined::handoff',
},
},
},
);
%Image::ExifTool::UserDefined::handoff = (
GROUPS => { 0 => 'XMP', 1 => 'XMP-handoff', 2 => 'Image' },
NAMESPACE => { handoff => 'urn:photo-handoff:1.0' },
WRITABLE => 'string',
ApprovedRevision => { },
);
1;
For a real existing system, replace this illustrative definition with its authorized schema. Do not relabel a list or structure as a string simply because the simpler definition is easier to write.
Load the definition explicitly
After reviewing and saving the appropriate configuration, a proposed working-copy request follows this pattern:
exiftool -config handoff.config -XMP-handoff:ApprovedRevision="r03" sample.jpg
The configuration option must precede other arguments. Keep normal backups during a trial. No configuration or command was executed for this guide.
Read the output using the same authorized configuration and inspect the receiving system's interpretation. A successful write to an invented namespace does not satisfy a system expecting a different URI.
Verify more than the display label
Record the source file, schema URI, property name, type and resulting value. If the receiver ignores the field, compare its schema requirements rather than adding more similar-looking tags.
Keep shared-source metadata ownership explicit. A revision property in a shared asset is different from a private project note.
For a broader RAW-and-sidecar handoff, this custom property is only one metadata item. It does not replace processing instructions, original pixels or an approved rendered reference. Acceptance requires the intended system to read the correct property under the actual agreed schema.
Related tasks
- Why Did Editing Premiere Clip Metadata Change What Another Adobe App Shows?
- Why Does My RAW Photo Lose Its Edits on Another Computer?
Sources and scope
- example.config: Custom writable XMP tags require definitions. The example connects an XMP namespace prefix and URI to a user-defined tag table, including scalar/list/structure types.
Official-documentation synthesis researched on 23 October 2026 (Asia/Shanghai). Readable official deep-page text was obtained through public search; direct ExifTool fetches may return HTTP 403. No configuration, file edit, coordinate export or geotagging test was executed. Namespaces, paths, ASCII trial text, coordinates, dates and thresholds are explicitly illustrative. Historical official-forum exchanges support specific mechanisms, not demand frequency. Exact installed-version and receiving-system behavior require the stated acceptance checks.
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: 85 LENS (Ngô Hoàng Auth) / Pexels, Pexels License. This is an illustrative source photograph, not an application screenshot or a generated test result.