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 - --> XMP pdf Tags photoshop - --> XMP photoshop Tags PixelLive - --> XMP PixelLive Tags tiff - --> XMP tiff Tags xmp - --> XMP xmp Tags xmpBJ - --> XMP xmpBJ Tags xmpDM - --> XMP xmpDM Tags xmpMM - --> XMP xmpMM Tags xmpPLUS - --> XMP xmpPLUS Tags xmpRights - --> XMP xmpRights Tags xmpTPg - --> XMP xmpTPg Tags
Tag Name Writable Values / Notes Firmware string FlashCompensation rational ImageNumber string Lens string LensInfo string OwnerName string SerialNumber string
Tag Name Writable Values / Notes License string
Tag Name Writable Values / Notes AutoBrightness boolean AutoContrast boolean AutoExposure boolean AutoShadows boolean BlueHue integer BlueSaturation integer Brightness integer CameraProfile string ChromaticAberrationB integer ChromaticAberrationR integer ColorNoiseReduction integer Contrast integer CropAngle real CropBottom real CropHeight real CropLeft real CropRight real CropTop real CropUnits integer 0 = pixels
1 = inches
2 = cmCropWidth real Exposure real GreenHue integer GreenSaturation integer HasCrop boolean HasSettings boolean LuminanceSmoothing integer RawFileName string RedHue integer RedSaturation integer Saturation integer Shadows integer ShadowTint integer Sharpness integer Temperature integer Tint integer ToneCurve string+ ToneCurveName string 'Custom' = Custom
'Linear' = Linear
'Medium Contrast' = Medium Contrast
'Strong Contrast' = Strong ContrastVersion string VignetteAmount integer VignetteMidpoint integer WhiteBalance string 'As Shot' = As Shot
'Auto' = Auto
'Cloudy' = Cloudy
'Custom' = Custom
'Daylight' = Daylight
'Flash' = Flash
'Fluorescent' = Fluorescent
'Shade' = Shade
'Tungsten' = Tungsten
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+
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' = UnknownOS integer Rating string/ Revision string ShortDescription lang-alt Source string/
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 = UncalibratedComponentsConfiguration integer+ 0 = .
1 = Y
2 = Cb
3 = Cr
4 = R
5 = G
6 = BCompressedBitsPerPixel rational Contrast integer 0 = Normal
1 = Low
2 = HighCustomRendered integer 0 = Normal
1 = CustomDateTimeDigitized 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 bracketExposureProgram 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 = LandscapeExposureTime rational FileSource integer 3 = Digital Camera FlashEnergy rational FlashFired boolean FlashFunction boolean FlashMode integer 0 = Unknown
1 = On
2 = Off
3 = AutoFlashpixVersion string FlashRedEyeMode boolean FlashReturn integer 0 = No return detection
2 = Return not detected
3 = Return detectedFNumber rational FocalLength rational FocalLengthIn35mmFormat integer FocalPlaneResolutionUnit integer 1 = mm
10 = cm
'0.001' = um
'25.4' = inchesFocalPlaneXResolution rational FocalPlaneYResolution rational GainControl integer 0 = None
1 = Low gain up
2 = High gain up
3 = Low gain down
4 = High gain downGPSAltitude rational GPSAltitudeRef integer 0 = Above Sea Level
1 = Below Sea LevelGPSAreaInformation string GPSDestBearing rational GPSDestBearingRef string 'M' = Magnetic North
'T' = True NorthGPSDestDistance rational GPSDestDistanceRef string 'K' = Kilometers
'M' = Miles
'N' = Nautical MilesGPSDestLatitude string GPSDestLongitude string GPSDifferential integer 0 = No Correction
1 = Differential CorrectedGPSDOP rational GPSImgDirection rational GPSImgDirectionRef string 'M' = Magnetic North
'T' = True NorthGPSLatitude string GPSLongitude string GPSMapDatum string GPSMeasureMode integer 2 = 2-Dimensional
3 = 3-DimensionalGPSProcessingMethod string GPSSatellites string GPSSpeed rational GPSSpeedRef string 'K' = km/h
'M' = mph
'N' = knotsGPSStatus string 'A' = Measurement In Progress
'V' = Measurement InteroperabilityGPSTimeStamp date GPSTrack rational GPSTrackRef string 'M' = Magnetic North
'T' = True NorthGPSVersionID 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 = OtherMakerNote string MaxApertureValue rational MeteringMode integer 1 = Average
2 = Center-weighted average
3 = Spot
4 = Multi-spot
5 = Multi-segment
6 = Partial
255 = OtherOECFColumns integer OECFNames string+ OECFRows integer OECFValues rational+ ExifImageWidth integer ExifImageHeight integer RelatedSoundFile string Saturation integer 0 = Normal
1 = Low
2 = HighSceneCaptureType integer 0 = Standard
1 = Landscape
2 = Portrait
3 = NightSceneType 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 linearSharpness integer 0 = Normal
1 = Soft
2 = HardShutterSpeedValue rational SpatialFrequencyResponseColumns integer SpatialFrequencyResponseNames string+ SpatialFrequencyResponseRows integer SpatialFrequencyResponseValues rational+ SpectralSensitivity string SubjectArea integer+ SubjectDistance rational SubjectDistanceRange integer 0 = Unknown
1 = Macro
2 = Close
3 = DistantSubjectLocation integer+ UserComment lang-alt WhiteBalance integer 0 = Auto
1 = Manual
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+
Tag Name Writable Values / Notes Author string CreationDate date Creator string/ Keywords string ModDate date PDFVersion string Producer string Subject string/ Title string/
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
Tag Name Writable Values / Notes Author N Comments N Copyright N Date N Genre N Title N
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 CompressedCopyright 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 CWPhotometricInterpretation 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 RawPlanarConfiguration integer 1 = Chunky
2 = PlanarPrimaryChromaticities rational+ ReferenceBlackWhite rational+ ResolutionUnit integer 1 = None
2 = inches
3 = cmSamplesPerPixel integer Software string TransferFunction integer+ WhitePoint rational+ XResolution rational YCbCrCoefficients rational+ YCbCrPositioning integer 1 = Centered
2 = Co-sitedYCbCrSubSampling 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:0YResolution rational
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 MetadataDate date ModifyDate date Nickname string Rating integer ThumbnailsFormat string+ ThumbnailsHeight string+ ThumbnailsImage N+ ThumbnailsWidth string+
Tag Name Writable Values / Notes JobRefId string+ JobRefName string+ JobRefUrl string+
Tag Name Writable Values / Notes AbsPeakAudioFilePath string Album string AltTapeName string AltTimecodeTimeFormat string AltTimecodeTimeValue string Artist string/ AudioChannelType string AudioCompressor string AudioModDate date AudioSampleRate integer AudioSampleType string BeatSpliceParamsRiseInDecibel real BeatSpliceParamsRiseInTimeDuration string BeatSpliceParamsUseFileBeatsMarker boolean Composer string ContributedMediaDuration string+ ContributedMediaManaged boolean+ ContributedMediaPath string+ ContributedMediaStartTime string+ ContributedMediaTrack string+ ContributedMediaWebStatement string+ Copyright string/ Duration string Engineer string FileDataRate rational Genre string Instrument string IntroTime string Key string LogComment string Loop boolean MarkersComment string+ MarkersDuration string+ MarkersLocation string+ MarkersName string+ MarkersStartTime string+ MarkersTarget string+ MarkersType string+ MetadataModDate date NumberOfBeats real OutCue string ProjectRefPath string ProjectRefType string PullDown string RelativePeakAudioFilePath string RelativeTimestamp string ReleaseDate date ResampleParamsQuality string ScaleType string Scene string/ ShotDate date ShotLocation string ShotName string SpeakerPlacement string StartTimecodeTimeFormat string StartTimecodeTimeValue string StretchMode string TapeName string Tempo real TimeScaleParamsFrameOverlappingPercentage real TimeScaleParamsFrameSize real TimeScaleParamsQuality string TimeSignature string TrackNumber integer VideoAlphaMode string VideoAlphaPremultipleColorA integer VideoAlphaPremultipleColorB integer VideoAlphaPremultipleColorBlack real VideoAlphaPremultipleColorBlue integer VideoAlphaPremultipleColorCyan real VideoAlphaPremultipleColorGreen integer VideoAlphaPremultipleColorL real VideoAlphaPremultipleColorMagenta real VideoAlphaPremultipleColorMode string VideoAlphaPremultipleColorRed integer VideoAlphaPremultipleColorSwatchName string VideoAlphaPremultipleColorType string VideoAlphaPremultipleColorYellow real VideoAlphaUnityIsTransparent boolean VideoColorSpace string VideoCompressor string VideoFieldOrder string VideoFrameRate string VideoFrameSizeH real VideoFrameSizeUnit string VideoFrameSizeW real VideoModDate date VideoPixelAspectRatio rational VideoPixelDepth string
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 PreservedFileName 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+
Tag Name Writable Values / Notes CreditLineReq boolean ReuseAllowed boolean
Tag Name Writable Values / Notes Certificate string Marked boolean Owner string+ UsageTerms lang-alt WebStatement string
Tag Name Writable Values / Notes ColorantsA integer+ ColorantsB integer+ ColorantsBlack real+ ColorantsBlue integer+ ColorantsCyan real+ ColorantsGreen integer+ ColorantsL real+ ColorantsMagenta real+ ColorantsMode string+ ColorantsRed integer+ ColorantsSwatchName string+ ColorantsType string+ ColorantsYellow real+ FontsChildFontFiles string+ FontsComposite boolean+ FontsFontFace string+ FontsFontFamily string+ FontsFontFileName string+ FontsFontName string+ FontsFontType string+ FontsVersionString string+ MaxPageSizeH real MaxPageSizeUnit string MaxPageSizeW real NPages integer PlateNames string+