Skip to main content

IPTC photo metadata properties

note

This page provides a summary of IPTC photo metadata properties based on the IPTC Photo Metadata Standard.
This information is provided for convenience: It's not authoritative, and in all cases the specification takes precedence.

Contents:

Overview

IPTC photo metadata provides data about photographs that can be processed by software.

The table below consolidates information from the two IPTC Photo Metadata schemas: The original IPTC Core Schema, released in 2004, and the IPTC Extension schema, released in 2008.

Data types

Some properties have non-primitive types, referred to in the IPTC specification as "structures." These structures ("objects" in JSON terminology) are described in detail in Structures.

Localizable text

Properties denoted as "Localizable text" must allow applications to display the text value in multiple human languages, depending on user preference. For example:

"occupation": {
"ja": "忍者",
"en": "Ninja",
"cs": "Nindža"
}

For more information, see:

Property reference

The table below:

PropertyDescriptionData Type /
Allowed Values
Property Name
Additional Model InformationInformation about the ethnicity and other facets of the model(s) in a model-released image.TextIptc4xmpExt:AddlModelInfo
Alt Text (Accessibility)A brief textual description of the purpose and meaning of an image that can be accessed by assistive technology or displayed when the image is disabled in the browser. It should not exceed 250 characters.Localizable textIptc4xmpCore:AltTextAccessibility
Artwork or Object in the ImageA set of metadata about artwork or an object in the imageOne or more ArtworkOrObject objects.Iptc4xmpExt:ArtworkOrObject
Code of Organization Featured in the ImageCode from a controlled vocabulary for identifying the organization or company which is featured in the image; for example a stock ticker symbol.One ore more codes with format: <CV-IDENTIFIER>:<CV-CODE> for example, nasdaq:companyAIptc4xmpExt:OrganisationInImageCode
ContributorParty or parties (person or organization) which contributed to the image, refinement by the role attribute.One or more EntityWRole objects.Iptc4xmpExt:Contributor
Copyright NoticeAny necessary copyright notice for claiming the intellectual property for this photograph. Should identify the current owner of the copyright for the photograph. Other entities like the creator of the photograph may be added in the corresponding field. Notes on usage rights should be provided in "Rights usage terms".Localizable textdc:rights
Copyright OwnerOwner or owners of the copyright in the licensed image.Up to three CopyrigthOwner structuresplus:CopyrightOwner
CreatorContains the name of the photographer, but in cases where the photographer should not be identified the name of a company or organization may be appropriate.Textdc:creator
Creator’s Contact InfoThe creator’s contact information provides all necessary information to get in contact with the creator of this image and comprises a set of sub-properties for proper addressing. NOTE: Use the Licensor field instead, if you are using IPTC Extension fields.CreatorContactInfo structureIptc4xmpCore:CreatorContactInfo
Creator’s job titleContains the job title of the photographer. As this is sort of a qualifier the Creator element has to be filled in as mandatory prerequisite for using Creator’s Job title.Textphotoshop:AuthorsPosition
Credit LineThe credit to person(s) and/or organization(s) required by the supplier of the image to be used when published. This is a free-text field.Textphotoshop:Credit
CV-Term About ImageOne or more topics, themes or entities the content is about, each one expressed by a term from a Controlled Vocabulary.One or more CvTerm structures.Iptc4xmpExt:AboutCvTerm
Data MiningDO NOT USE this property. Instead use the C2PA "do not train" assertion.
Date CreatedDesignates the date and optionally the time the content of the image was created rather than the date of the creation of the digital representation.Date in ISO 8601 format.photoshop:DateCreated
DescriptionA textual description, including captions, of the image.Localizable textdc:description
Description WriterIdentifier or the name of the person(s) involved in writing, editing or correcting the Description, Alt Text (Accessibility), or Extended Description (Accessibility) of the image.Textphotoshop:CaptionWriter
Digital Image GUIDGlobally unique identifier for this digital image. It is created and applied by the creator of the digital image at the time of its creation . This value shall not be changed after that time.TextIptc4xmpExt:DigImageGUID
Digital Source TypeThe type of the source of this digital imageAn IPTC digital source type codeIptc4xmpExt:DigitalSourceType
Embedded Encoded Rights ExpressionAn embedded rights expression using any rights expression languageOne or more EmbdEncRightsExpr structures.Iptc4xmpExt:EmbdEncRightsExpr
Event IdentifierIdentifier(s) of the specific event at which the photo was takenOne or more URIsIptc4xmpExt:EventId
Event NameNames or describes the specific event at which the photo was taken.Localizable textIptc4xmpExt:Event
Extended Description (Accessibility)A detailed textual description of the purpose and meaning of an image that elaborates on the Alt Text (Accessibility) property. No character limitation. Not required if the Alt Text (Accessibility) field sufficiently describes the image.Localizable textIptc4xmpCore:ExtDescrAccessibility
GenreArtistic, style, journalistic, product or other genre(s) of the image (expressed by a term from any Controlled Vocabulary)One or more CvTerm structures.Iptc4xmpExt:Genre
HeadlineA brief synopsis of the caption. Headline is not the same as Title.Textphotoshop:Headline
Image CreatorCreator or creators of the imageUp to three ImageCreator structures.plus:ImageCreator
Image RatingRating of the image by its user or supplierDecimal:
-1: "rejected"
0: "unrated" (default)
0...5
xmp:Rating
Image RegionSets a region inside an image by defining its boundaries. All pixels of the boundary are also part of the region. It may include metadata related to this region.One or more ImageRegion structures.Iptc4xmpExt:ImageRegion
Image Registry EntryBoth a Registry Item Id and a Registry Organization Id to record any registration of this digital image with a registry.One or more RegistryEntry structures.Iptc4xmpExt:RegistryId
Image SupplierIdentifies the most recent supplier of the image, who is not necessarily its owner or creator.ImageSupplier structure.plus:ImageSupplier
Image Supplier Image IDOptional identifier assigned by the Image Supplier to the image.Textplus:ImageSupplierImageID
InstructionsAny number of instructions from the provider or creator to the receiver of the imageTextphotoshop:Instructions
Job IdNumber or identifier for the purpose of improved workflow handling. This is a user created identifier related to the job for which the image is supplied.Textphotoshop:TransmissionReference
KeywordsKeywords to express the subject of the image. Keywords may be free text and don’t have to be taken from a controlled vocabulary.Textdc:subject
LicensorA person or company that should be contacted to obtain a license for using the item or who has licensed the item.Up to three Licensor structures.plus:Licensor
Linked Encoded Rights ExpressionA linked rights expression using any rights expression language.One or more LinkedEncRightsExpr structures.Iptc4xmpExt:LinkedEncRightsExpr
Location createdThe location the photo was taken.Location structure.Iptc4xmpExt:LocationCreated
Location shown in the imageA location shown in the image.One or more Location structures.Iptc4xmpExt:LocationShown
Max Avail HeightThe maximum available height in pixels of the original photo from which this photo has been derived by downsizing.IntegerIptc4xmpExt:MaxAvailHeight
Max Avail WidthThe maximum available width in pixels of the original photo from which this photo has been derived by downsizing.IntegerIptc4xmpExt:MaxAvailWidth
Minor Model Age DisclosureAge of the youngest model pictured in the image, at the time that the image was made.One of the URIs listed in the PLUS Specification Minor Model Age Disclosure section.plus:MinorModelAgeDisclosure
Model AgeAge of the human model(s) at the time this image was taken in a model released image.One or more IntegersIptc4xmpExt:ModelAge
Model Release IdIdentifier(s) of a Model Release document.Text (one or more). See PLUS Specification Model Release IDplus:ModelReleaseID
Model Release StatusSummarizes the availability and scope of model releases authorizing usage of the likenesses of persons appearing in the photograph.One of the URIs listed in the PLUS Specification Model Release Status section.plus:ModelReleaseStatus
Name of Organization Featured in the ImageName of the organization or company which is featured in the image.Text (one or more)Iptc4xmpExt:OrganisationInImageName
Other ConstraintsAdditional constraints on the use of the asset.Text (one or more) (localizable)plus:OtherConstraints
Person Shown in the ImageName of a person shown in the image.Text (one or more)Iptc4xmpExt:PersonInImage
Person Shown in the Image with DetailsDetails about a person the content is about.personWDetails structureIptc4xmpExt:PersonInImageWDetails
Product Shown in the ImageA product the content is about.One or more ProductWGtin structures.Iptc4xmpExt:ProductInImage
Property Release IdIdentifier(s) of a Property Release document.Text (one or more). See PLUS Specification Property Release IDplus:PropertyReleaseID
Property Release StatusSummarizes the availability and scope of property releases authorizing usage of the properties appearing in the photograph.One of the URIs listed from the PLUS Specification Property Release Status section.plus:PropertyReleaseStatus
Rights Usage TermsThe licensing parameters of the image expressed in free-text.Localizable textxmpRights:UsageTerms
Scene CodeDescribes the scene of a photo content. Specifies one ore more terms from the IPTC "Scene-NewsCodes". Each Scene is represented as a string of six digits in an unordered list.One or more six-digit IPTC Scene NewsCodes.Iptc4xmpCore:Scene
Source (Supply Chain)The name of a person or party who has a role in the content supply chain. This could be an agency, a member of an agency, an individual or a combination. Source could be different from Creator and from the entities in the Copyright Notice.Textphotoshop:Source
TitleA shorthand reference for the digital image. Title provides a short human readable name which can be a text and/or numeric reference. It is not the same as Headline.Localizable textdc:title
Web Statement of RightsURL referencing a web resource providing a statement of the copyright ownership and usage rights of the image.Text (URI)xmpRights:WebStatement

Structures

This section documents the object structures used for IPTC photo metadata properties. It is based on the IPTC Photo Metadata technical specification in JSON format.

ArtworkOrObject

This structure provides details about artwork or an object in an image. Includes a Copyright Notice, a Creator, a Date Created, a Source, a Source Inventory Number and a Title.

See Artwork or Object in the Image structure in the IPTC Photo Metadata Specification.

PropertyDatatypeData formatSpecification link
Iptc4xmpExt:AOCircaDateCreatedStringN/ACirca Date Created
Iptc4xmpExt:AOContentDescriptionStructureLocalizable textContent Description
Iptc4xmpExt:AOContributionDescriptionStructureLocalizable textContribution Description
Iptc4xmpExt:AOCopyrightNoticeStringN/ACopyright Notice
Iptc4xmpExt:AOCreatorNamesStringN/ACreator
Iptc4xmpExt:AOCreatorIdentifiersStringURICreator ID
Iptc4xmpExt:AOCurrentCopyrightOwnerIdentifierStringURICurrent Copyright Owner ID
Iptc4xmpExt:AOCurrentCopyrightOwnerNameStringN/ACurrent Copyright Owner Name
Iptc4xmpExt:AOCurrentLicensorIdentifierStringURICurrent Licensor Identifier
Iptc4xmpExt:AOCurrentLicensorNameStringN/ACurrent LicensorName
Iptc4xmpExt:AODateCreatedStringdate-timeDate Created
Iptc4xmpExt:AOPhysicalDescriptionStructureLocalizable textPhysical Description
Iptc4xmpExt:AOSourceStringN/ASource
Iptc4xmpExt:AOSourceInvNoStringN/ASource Inventory Number
Iptc4xmpExt:AOSourceInvURLStringURLSource Inventory URL
Iptc4xmpExt:AOStylePeriodStringN/AStyle Period
Iptc4xmpExt:AOTitleStructureLocalizable textTitle

CopyrightOwner

This structure provides information on the owner or owners of the copyright in the licensed image. The copyright owner, image creator, image supplier and licensor may be the same or different entities.

See CopyrightOwner in the Picture Licensing Universal System (PLUS) specification.

PropertyDatatypeData formatSpecification link
plus:CopyrightOwnerIdStringN/ACopyright Owner ID
plus:CopyrightOwnerNameStringN/ACopyright Owner Name

CreatorContactInfo

This generic structure provides a basic set of information to get in contact with a person or organization.

See Contact Info structure in the IPTC Photo Metadata Specification.

PropertyDatatypeData formatSpecification link
Iptc4xmpCore:CiAdrExtadrStringN/AAddress
Iptc4xmpCore:CiAdrCityStringN/ACity
Iptc4xmpCore:CiAdrCtryStringN/ACountry
Iptc4xmpCore:CiEmailWorkStringN/AEmail address(es)
Iptc4xmpCore:CiTelWorkStringN/APhone number(s)
Iptc4xmpCore:CiAdrPcodeStringN/APostal Code
Iptc4xmpCore:CiAdrRegion StringN/AState/Province
Iptc4xmpCore:CiUrlWorkStringURL Web URL(s)

CvTerm

This structure provides details of a controlled vocabulary term the image is about.

See CV-Term structure in the IPTC Photo Metadata Specification.

PropertyDatatypeData formatSpecification link
Iptc4xmpExt:CvIdStringURICV-Term CV ID
Iptc4xmpExt:CvTermIdStringURICV-Term ID
Iptc4xmpExt:CvTermNameStructureLocalizable textCV-Term Name
Iptc4xmpExt:CvTermRefinedAboutStringURIRefined 'about' Relationship of the CV-Term

EmbdEncRightsExpr

This structure provides details of an embedded encoded rights expression.

See Embedded Encoded Rights Expression (EERE) structure in the IPTC Photo Metadata Specification.

PropertyDatatypeData formatSpecification link
Iptc4xmpExt:EncRightsExprStringN/AEncoded Rights Expression
Iptc4xmpExt:RightsExprEncTypeStringN/AEncoding type
Iptc4xmpExt:RightsExprLangIdStringURIRights Expression Language ID

Entity

This structure is a datatype for a named entity or concept.

See Entity or Concept structure in the IPTC Photo Metadata Specification.

PropertyDatatypeData formatSpecification link
xmp:IdentifierStringURIIdentifier
Iptc4xmpExt:NameStructureLocalizable textName

EntityWRole

This structure is a datatype for a named entity or concept with a role property.

See Entity or Concept with role structures in the IPTC Photo Metadata Specification.

PropertyDatatypeData formatSpecification link
xmp:IdentifierStringURIIdentifier
Iptc4xmpExt:NameStructureLocalizable textName
Iptc4xmpExt:RoleStringN/ARole

ImageCreator

This structure provides information on the creator(s) of an image. In many countries, the image creator must be attributed in association with any use of the image. The image creator, copyright owner, image supplier and licensor may be the same or different entities.

See ImageCreator in the Picture Licensing Universal System (PLUS) specification..

PropertyDatatypeData formatSpecification link
plus:ImageCreatorIDStringN/AImage Creator ID
plus:ImageCreatorNameStringN/AImage Creator Name

ImageRegion

This structure defines the boundaries of an image region, some characteristics of the image region, and metadata properties related to the region.

See Image Region structure in the IPTC Photo Metadata Specification.

PropertyDatatypeData formatSpecification link
Iptc4xmpExt:RegionBoundaryStructureRegionBoundaryRegion Boundary
Iptc4xmpExt:rIdStringN/ARegion Identifier
Iptc4xmpExt:NameStructureLocalizable textRegion Name
Iptc4xmpExt:rCtypeStructureEntityRegion Content Type
Iptc4xmpExt:rRoleStructureEntityRegion Role
Iptc4xmpExt:<other>AnyN/AOther metadata property

ImageSupplier

This structure provides information on the party providing the image to the licensor or to the licensee on behalf of the licensor. In some instances, a licensor serves as an agent or distributor for a third party supplying the image either to the licensor, or directly to the Licensee. The image creator, copyright owner, image supplier and licensor may be the same or different entities.

See ImageSupplier in the PLUS Specification.

PropertyDatatypeData formatSpecification link
plus:ImageSupplierIDStringN/AImage Supplier ID
plus:ImageSupplierNameStringN/AImage Supplier Name

Licensor

This structure provides information on the party or parties granting the license to the licensee.

See Licensor in the PLUS Specification.

PropertyDatatypeData formatSpecification link
plus:LicensorIDStringN/ALicensor ID
plus:LicensorNameStringN/ALicensor Name
plus:LicensorStreetAddressStringN/ALicensor Address
plus:LicensorExtendedAddressStringN/ALicensor Address Detail
plus:LicensorCityStringN/ALicensor City
plus:LicensorRegionStringN/ALicensor State or Province
plus:LicensorPostalCodeStringN/ALicensor Postal Code
plus:LicensorCountryStringN/ALicensor Country
plus:LicensorTelephoneType1StringURLLicensor TelephoneType1
plus:LicensorTelephone1StringN/ALicensor Telephone1
plus:LicensorTelephoneType2StringURLLicensor TelephoneType2
plus:LicensorTelephone2StringN/ALicensor Telephone2
plus:LicensorEmailStringN/ALicensor Email
plus:LicensorURLStringURLLicensor URL

LinkedEncRightsExpr

This structure provides details of a linked encoded rights expression.

See Linked Encoded Rights Expression (LERE) structure in the IPTC Photo Metadata Specification.

PropertyDatatypeData formatSpecification link
Iptc4xmpExt:LinkedRightsExprStringURLLink to Encoded Rights Expression
Iptc4xmpExt:RightsExprEncTypeStringMIME Type / URIEncoding type
Iptc4xmpExt:RightsExprLangIdStringURIRights Expression Language ID

Location

This structure provides details about a location.

See Location structure in the IPTC Photo Metadata Specification.

PropertyDatatypeData formatSpecification link
Iptc4xmpExt:CityStringN/ACity
Iptc4xmpExt:CountryCodeStringN/ACountry Code
Iptc4xmpExt:CountryNameStringN/ACountry Name
exif:GPSAltitudeNumberN/AGPS Altitude
exif:GPSLatitudeNumberN/AGPS Latitude
exif:GPSLongitudeNumberN/AGPS Longitude
Iptc4xmpExt:LocationIdStringURILocation Identifier
Iptc4xmpExt:LocationNameStructureLocalizable textLocation Name
Iptc4xmpExt:ProvinceStateStringN/AProvince or State
Iptc4xmpExt:SublocationStringN/ASublocation
Iptc4xmpExt:WorldRegionStringN/AWorld Region

PersonWDetails

This structure provides details about a single person in the image.

See Person structure in the IPTC Photo Metadata Specification.

PropertyDatatypeData formatSpecification link
Iptc4xmpExt:PersonCharacteristicStructureCvTermCharacteristics
Iptc4xmpExt:PersonDescriptionStructureLocalizable textDescription
Iptc4xmpExt:PersonIdStringURIIdentifier
Iptc4xmpExt:PersonNameStructureLocalizable textName

ProductWGtin

This structure provides details about a product.

See Product structure in the IPTC Photo Metadata Specification.

PropertyDatatypeData formatSpecification link
Iptc4xmpExt:ProductDescriptionStructureLocalizable textDescription
Iptc4xmpExt:ProductGTINStringN/AGTIN
Iptc4xmpExt:ProductIdStringURIIdentifier
Iptc4xmpExt:ProductNameStructureLocalizable textName

RegionBoundary

This structure defines the boundary of a region inside an image. It may define a single point to express special characteristics of the point, or may define a line to express a division of the image.

See Region Boundary structure in the IPTC Photo Metadata Specification.

PropertyDatatypeData formatSpecification link
Iptc4xmpExt:rbShapeStringN/ArbShape
Iptc4xmpExt:rbUnitStringN/ArbUnit
Iptc4xmpExt:rbXNumberN/ArbX
Iptc4xmpExt:rbYNumberN/ArbY
Iptc4xmpExt:rbWNumberN/ArbW
Iptc4xmpExt:rbHNumberN/ArbH
Iptc4xmpExt:rbRxNumberN/ArbRx
Iptc4xmpExt:rbVerticesStructureRegionBoundaryPointrbVertices

RegionBoundaryPoint

This structure defines a point in an image by its coordinates.

See Region Boundary Point structure in the IPTC Photo Metadata Specification.

PropertyDatatypeData formatSpecification link
Iptc4xmpExt:rbXNumberN/ArbX
Iptc4xmpExt:rbYNumberN/ArbY

RegistryEntry

This structure defines an entry in a registry, including the ID for the image issued by the registry and the registry’s ID.

See Registry Entry structure in the IPTC Photo Metadata Specification.

PropertyDatatypeData formatSpecification link
Iptc4xmpExt:RegItemIdStringN/ARegistry Item ID
Iptc4xmpExt:RegOrgIdStringN/ARegistry Organization ID
Iptc4xmpExt:RegEntryRoleStringURIRole