## XMP Tags

XMP stands for 'Extensible Metadata Platform', an XML/RDF-based metadata format which is being pushed by Adobe. Information in this format can be embedded in many different image file types including JPG, JP2, TIFF, PNG, MIFF, PS, PDF, PSD and DNG.

The XMP Tag ID's aren't listed because in most cases they are identical to the Tag Name.

All XMP information is stored as character strings. The Writable column specifies the information format: `integer` is a string of digits (possibly beginning with a '+' or '-'), `real` is a floating point number, `rational` is two `integer` strings separated by a '/' character, `date` is a date/time string in the format 'YYYY:MM:DD HH:MM:SS[+/-HH:MM]', `boolean` is either 'True' or 'False', and `lang-alt` is a list of string alternatives in different languages. Currently, ExifTool only writes the 'x-default' language in `lang-alt` lists.

The XMP tags are organized according to schema namespace in the following tables. The table names correspond to the XMP namespace prefixes, which are used to generate the family 1 group names by adding the prefix 'XMP-'. If the same XMP tag name exists in more than one group, all groups are written unless a family 1 group name is specified. ie) If XMP:Contrast is specified, information will be written to both XMP-crs:Contrast and XMP-exif:Contrast.

ExifTool will extract XMP information even if it is not listed in these tables. For example, the `pdfx` namespace doesn't have a predefined set of tag names because it is used to store application-defined PDF information, but this information is extracted by ExifTool anyway.

> Namespace | Writable | Values / Notes
> --- | --- | ---
> aux | - | --> XMP aux Tags
> cc | - | --> XMP cc Tags
> crs | - | --> XMP crs Tags
> dc | - | --> XMP dc Tags
> dex | - | --> XMP dex Tags
> exif | - | --> XMP exif Tags
> iptcCore | - | --> XMP iptcCore Tags
> pdf | - | --> XMP pdf Tags
> photoshop | - | --> XMP photoshop Tags
> PixelLive | - | --> XMP PixelLive Tags
> tiff | - | --> XMP tiff Tags
> xmp | - | --> XMP xmp Tags
> xmpBJ | - | --> XMP xmpBJ Tags
> xmpMM | - | --> XMP xmpMM Tags
> xmpPLUS | - | --> XMP xmpPLUS Tags
> xmpRights | - | --> XMP xmpRights Tags
> xmpTPg | - | --> XMP xmpTPg Tags

## XMP aux Tags

Photoshop Auxiliary schema tags.

> Tag Name | Writable | Values / Notes
> --- | --- | ---
> Lens | string |
> SerialNumber | string |

## XMP cc Tags

Creative Commons schema tags.

> Tag Name | Writable | Values / Notes
> --- | --- | ---
> License | string |

## XMP crs Tags

Photoshop Camera Raw Schema tags.

> Tag Name | Writable | Values / Notes
> --- | --- | ---
> BlueHue | string |
> BlueSaturation | string |
> Brightness | string |
> ChromaticAberrationB | string |
> ChromaticAberrationR | string |
> ColorNoiseReduction | string |
> Contrast | string |
> Exposure | string |
> GreenHue | string |
> GreenSaturation | string |
> LuminanceSmoothing | string |
> RawFileName | string |
> RedHue | string |
> RedSaturation | string |
> Saturation | string |
> Shadows | string |
> ShadowTint | string |
> Sharpness | string |
> Version | string |
> VignetteAmount | string |
> VignetteMidpoint | string |
> WhiteBalance | string |

## XMP dc Tags

Dublin Core schema tags.

> Tag Name | Writable | Values / Notes
> --- | --- | ---
> Contributor | string |
> Coverage | string |
> Creator | string |
> Date | date |
> Description | lang-alt |
> Format | string |
> Identifier | string |
> Language | string |
> Publisher | string |
> Relation | string |
> Rights | lang-alt |
> Source | string |
> Subject | string |
> Title | lang-alt |
> Type | string |

## XMP dex Tags

Description Explorer schema tags. These tags are not very common, and some are not made writable due to name conflicts with other XMP tags.

> Tag Name | Writable | Values / Notes
> --- | --- | ---
> CRC32 | integer |
> FFID | string |
> LicenseType | string | 'adware' = Adware 'commercial' = Commercial 'demo' = Demo 'freeware' = Freeware 'open source' = Open Source 'public domain' = Public Domain 'shareware' = Shareware 'unknown' = Unknown
> OS | integer |
> Rating | N |
> Revision | string |
> ShortDescription | lang-alt |
> Source | N |

## XMP exif Tags

EXIF schema for EXIF tags.

> Tag Name | Writable | Values / Notes
> --- | --- | ---
> ApertureValue | rational |
> BrightnessValue | rational |
> CFAPatternColumns | integer |
> CFAPatternRows | integer |
> CFAPatternValues | integer |
> ColorSpace | integer | 1 = sRGB 2 = Adobe RGB 65535 = Uncalibrated 4294967295 = Uncalibrated
> ComponentsConfiguration | integer | 0 = . 1 = Y 2 = Cb 3 = Cr 4 = R 5 = G 6 = B
> CompressedBitsPerPixel | rational |
> Contrast | integer | 0 = Normal 1 = Low 2 = High
> CustomRendered | integer | 0 = Normal 1 = Custom
> DateTimeDigitized | date |
> DateTimeOriginal | date |
> DeviceSettingDescriptionColumns | integer |
> DeviceSettingDescriptionRows | integer |
> DeviceSettingDescriptionSettings | string |
> DigitalZoomRatio | rational |
> ExifVersion | string |
> ExposureCompensation | rational |
> ExposureIndex | rational |
> ExposureMode | integer | 0 = Auto 1 = Manual 2 = Auto bracket
> ExposureProgram | integer | 1 = Manual 2 = Program AE 3 = Aperture-priority AE 4 = Shutter speed priority AE 5 = Creative (Slow speed) 6 = Action (High speed) 7 = Portrait 8 = Landscape
> ExposureTime | rational |
> FileSource | integer | 3 = Digital Camera
> FlashEnergy | rational |
> FlashFired | boolean |
> FlashFunction | boolean |
> FlashMode | integer | 0 = Unknown 1 = On 2 = Off 3 = Auto
> FlashpixVersion | string |
> FlashRedEyeMode | boolean |
> FlashReturn | integer | 0 = No return detection 2 = Return not detected 3 = Return detected
> FNumber | rational |
> FocalLength | rational |
> FocalLengthIn35mmFormat | integer |
> FocalPlaneResolutionUnit | integer | 1 = mm 10 = cm '0.001' = um '25.4' = inches
> FocalPlaneXResolution | rational |
> FocalPlaneYResolution | rational |
> GainControl | integer | 0 = None 1 = Low gain up 2 = High gain up 3 = Low gain down 4 = High gain down
> GPSAltitude | rational |
> GPSAltitudeRef | integer | 0 = Above Sea Level 1 = Below Sea Level
> GPSAreaInformation | string |
> GPSDestBearing | rational |
> GPSDestBearingRef | string | 'M' = Magnetic North 'T' = True North
> GPSDestDistance | rational |
> GPSDestDistanceRef | string | 'K' = Kilometers 'M' = Miles 'N' = Nautical Miles
> GPSDestLatitude | string |
> GPSDestLongitude | string |
> GPSDifferential | integer | 0 = No Correction 1 = Differential Corrected
> GPSDOP | rational |
> GPSImgDirection | rational |
> GPSImgDirectionRef | string | 'M' = Magnetic North 'T' = True North
> GPSLatitude | string |
> GPSLongitude | string |
> GPSMapDatum | string |
> GPSMeasureMode | integer | 2 = 2-Dimensional 3 = 3-Dimensional
> GPSProcessingMethod | string |
> GPSSatellites | string |
> GPSSpeed | rational |
> GPSSpeedRef | string | 'K' = km/h 'M' = mph 'N' = knots
> GPSStatus | string | 'A' = Measurement In Progress 'V' = Measurement Interoperability
> GPSTimeStamp | date |
> GPSTrack | rational |
> GPSTrackRef | string | 'M' = Magnetic North 'T' = True North
> GPSVersionID | string |
> ImageUniqueID | string |
> ISO | integer |
> LightSource | string | 1 = Daylight 2 = Fluorescent 3 = Tungsten 4 = Flash 9 = Fine Weather 10 = Cloudy 11 = Shade 12 = Daylight Fluorescent 13 = Day White Fluorescent 14 = Cool White Fluorescent 15 = White Fluorescent 17 = Standard Light A 18 = Standard Light B 19 = Standard Light C 20 = D55 21 = D65 22 = D75 23 = D50 24 = ISO Studio Tungsten 255 = Other
> MakerNote | string |
> MaxApertureValue | rational |
> MeteringMode | integer | 1 = Average 2 = Center-weighted average 3 = Spot 4 = Multi-spot 5 = Multi-segment 6 = Partial 255 = Other
> OECFColumns | integer |
> OECFNames | string |
> OECFRows | integer |
> OECFValues | rational |
> ExifImageWidth | integer |
> ExifImageHeight | integer |
> RelatedSoundFile | string |
> Saturation | integer | 0 = Normal 1 = Low 2 = High
> SceneCaptureType | integer | 0 = Standard 1 = Landscape 2 = Portrait 3 = Night
> SceneType | integer | 1 = Directly photographed
> SensingMethod | integer | 1 = Not defined 2 = One-chip color area 3 = Two-chip color area 4 = Three-chip color area 5 = Color sequential area 7 = Trilinear 8 = Color sequential linear
> Sharpness | integer | 0 = Normal 1 = Soft 2 = Hard
> ShutterSpeedValue | rational |
> SpatialFrequencyResponseColumns | integer |
> SpatialFrequencyResponseNames | string |
> SpatialFrequencyResponseRows | integer |
> SpatialFrequencyResponseValues | rational |
> SpectralSensitivity | string |
> SubjectArea | integer |
> SubjectDistance | rational |
> SubjectDistanceRange | integer | 0 = Unknown 1 = Macro 2 = Close 3 = Distant
> SubjectLocation | integer |
> UserComment | lang-alt |
> WhiteBalance | integer | 0 = Auto 1 = Manual

## XMP iptcCore Tags

IPTC Core schema tags. The actual IPTC Core namespace schema prefix is `Iptc4xmpCore`, which is the name used in the file, but ExifTool uses `iptcCore` to generate the family 1 group name of XMP-iptcCore because XMP-Iptc4xmpCore is a bit lengthy.

> Tag Name | Writable | Values / Notes
> --- | --- | ---
> CountryCode | string |
> CreatorContactInfoCiAdrCity | string |
> CreatorContactInfoCiAdrCtry | string |
> CreatorContactInfoCiAdrExtadr | string |
> CreatorContactInfoCiAdrPcode | string |
> CreatorContactInfoCiAdrRegion | string |
> CreatorContactInfoCiEmailWork | string |
> CreatorContactInfoCiTelWork | string |
> CreatorContactInfoCiUrlWork | string |
> IntellectualGenre | string |
> Location | string |
> Scene | string |
> SubjectCode | string |

## XMP pdf Tags

Adobe PDF schema tags. The official XMP specification only defines Keywords, PDFVersion and Producer. The other tags are included because they have been observed in PDF files, but Creator, Subject and Title aren't made writable because their names conflict with XMP-dc tags.

> Tag Name | Writable | Values / Notes
> --- | --- | ---
> Author | string |
> CreationDate | date |
> Creator | N |
> Keywords | string |
> ModDate | date |
> PDFVersion | string |
> Producer | string |
> Subject | N |
> Title | N |

## XMP photoshop Tags

Adobe Photoshop schema tags.

> Tag Name | Writable | Values / Notes
> --- | --- | ---
> AuthorsPosition | string |
> CaptionWriter | string |
> Category | string |
> City | string |
> Country | string |
> Credit | string |
> DateCreated | date |
> Headline | string |
> Instructions | string |
> Source | string |
> State | string |
> SupplementalCategories | string |
> TransmissionReference | string |
> Urgency | integer |

## XMP PixelLive Tags

PixelLive schema tags. These tags are not writable because they are uncommon and there are name conflicts with other more common tags.

> Tag Name | Writable | Values / Notes
> --- | --- | ---
> Author | N |
> Comments | N |
> Copyright | N |
> Date | N |
> Genre | N |
> Title | N |

## XMP tiff Tags

EXIF schema for TIFF tags.

> Tag Name | Writable | Values / Notes
> --- | --- | ---
> Artist | string |
> BitsPerSample | integer |
> Compression | integer | 1 = Uncompressed 2 = CCITT 1D 3 = T4/Group 3 Fax 4 = T6/Group 4 Fax 5 = LZW 6 = JPEG (old-style) 7 = JPEG 8 = Adobe Deflate 9 = JBIG B&W 10 = JBIG Color 32766 = Next 32771 = CCIRLEW 32773 = PackBits 32809 = Thunderscan 32895 = IT8CTPAD 32896 = IT8LW 32897 = IT8MP 32898 = IT8BL 32908 = PixarFilm 32909 = PixarLog 32946 = Deflate 32947 = DCS 34661 = JBIG 34676 = SGILog 34677 = SGILog24 34712 = JPEG 2000 34713 = Nikon NEF Compressed
> Copyright | lang-alt |
> DateTime | date |
> ImageDescription | lang-alt |
> ImageHeight | integer |
> ImageWidth | integer |
> Make | string |
> Model | string |
> Orientation | integer | 1 = Horizontal (normal) 2 = Mirror horizontal 3 = Rotate 180 4 = Mirror vertical 5 = Mirror horizontal and rotate 270 CW 6 = Rotate 90 CW 7 = Mirror horizontal and rotate 90 CW 8 = Rotate 270 CW
> PhotometricInterpretation | integer | 0 = WhiteIsZero 1 = BlackIsZero 2 = RGB 3 = RGB Palette 4 = Transparency Mask 5 = CMYK 6 = YCbCr 8 = CIELab 9 = ICCLab 10 = ITULab 32803 = Color Filter Array 32844 = Pixar LogL 32845 = Pixar LogLuv 34892 = Linear Raw
> PlanarConfiguration | integer | 1 = Chunky 2 = Planar
> PrimaryChromaticities | rational |
> ReferenceBlackWhite | rational |
> ResolutionUnit | integer | 1 = None 2 = inches 3 = cm
> SamplesPerPixel | integer |
> Software | string |
> TransferFunction | integer |
> WhitePoint | rational |
> XResolution | rational |
> YCbCrCoefficients | rational |
> YCbCrSubSampling | string | '1 1' = YCbCr4:4:4 '1 2' = YCbCr4:4:0 '2 1' = YCbCr4:2:2 '2 2' = YCbCr4:2:0 '4 1' = YCbCr4:1:1 '4 2' = YCbCr4:1:0
> YResolution | rational |

## XMP xmp Tags

XMP Basic schema tags. If the older `xap`, `xapBJ`, `xapMM` or `xapRights` namespace prefixes are found, they are translated to the newer `xmp`, `xmpBJ`, `xmpMM` and `xmpRights` prefixes for use in family 1 group names.

> Tag Name | Writable | Values / Notes
> --- | --- | ---
> Advisory | string |
> BaseURL | string |
> CreateDate | date |
> CreatorTool | string |
> Identifier | string |
> Label | string | (not in original spec)
> MetadataDate | date |
> ModifyDate | date |
> Nickname | string |
> Rating | integer | (not in original spec)
> ThumbnailsFormat | string |
> ThumbnailsHeight | string |
> ThumbnailsImage | N |
> ThumbnailsWidth | string |

## XMP xmpBJ Tags

XMP Basic Job Ticket schema tags.

> Tag Name | Writable | Values / Notes
> --- | --- | ---
> JobRefId | string |
> JobRefName | string |
> JobRefUrl | string |

## XMP xmpMM Tags

XMP Media Management schema tags.

> Tag Name | Writable | Values / Notes
> --- | --- | ---
> DerivedFromDocumentID | string |
> DerivedFromInstanceID | string |
> DerivedFromManager | string |
> DerivedFromManagerVariant | string |
> DerivedFromManageTo | string |
> DerivedFromManageUI | string |
> DerivedFromRenditionClass | string |
> DerivedFromRenditionParams | string |
> DerivedFromVersionID | string |
> DocumentID | string |
> HistoryAction | string |
> HistoryInstanceID | string |
> HistoryParameters | string |
> HistorySoftwareAgent | string |
> HistoryWhen | date |
> LastURL | string |
> ManagedFromDocumentID | string |
> ManagedFromInstanceID | string |
> ManagedFromManager | string |
> ManagedFromManagerVariant | string |
> ManagedFromManageTo | string |
> ManagedFromManageUI | string |
> ManagedFromRenditionClass | string |
> ManagedFromRenditionParams | string |
> ManagedFromVersionID | string |
> Manager | string |
> ManagerVariant | string |
> ManageTo | string |
> ManageUI | string |
> RenditionClass | string |
> RenditionOfDocumentID | string |
> RenditionOfInstanceID | string |
> RenditionOfManager | string |
> RenditionOfManagerVariant | string |
> RenditionOfManageTo | string |
> RenditionOfManageUI | string |
> RenditionOfRenditionClass | string |
> RenditionOfRenditionParams | string |
> RenditionOfVersionID | string |
> RenditionParams | string |
> SaveID | integer |
> VersionID | string |
> VersionsComments | string |
> VersionsEventAction | string |
> VersionsEventInstanceID | string |
> VersionsEventParameters | string |
> VersionsEventSoftwareAgent | string |
> VersionsEventWhen | date |
> VersionsModifier | string |
> VersionsModifyDate | date |
> VersionsVersion | string |

## XMP xmpPLUS Tags

XMP Picture Licensing Universal System (PLUS) schema tags.

> Tag Name | Writable | Values / Notes
> --- | --- | ---
> CreditLineReq | boolean |
> ReuseAllowed | boolean |

## XMP xmpRights Tags

XMP Rights Management schema tags.

> Tag Name | Writable | Values / Notes
> --- | --- | ---
> Certificate | string |
> Marked | boolean |
> Owner | string |
> UsageTerms | lang-alt |
> WebStatement | string |

## XMP xmpTPg Tags

XMP Paged-Text schema tags.

> Tag Name | Writable | Values / Notes
> --- | --- | ---
> MaxPageSizeH | real |
> MaxPageSizeUnit | string |
> MaxPageSizeW | real |
> NPages | integer |

<-- ExifTool Tag Names

(This document generated automatically by Image::ExifTool::BuildTagLookup)
Last revised Feb 6, 2006