IPTC photo metadata properties
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:
- Lang Alt value type in the IPTC specification.
- AltLang structure in the IPTC specification.
- Language alternative in the XMP specification.
Property reference
The table below:
- Summarizes both IPTC core metadata properties and IPTC extension properties.
- Does not include "legacy" core properties, since they are superseded by IPTC extension properties.
- Does not include properties from the IPTC Video Metadata Hub Specification.
Property | Description | Data Type / Allowed Values | Property Name |
---|---|---|---|
Additional Model Information | Information about the ethnicity and other facets of the model(s) in a model-released image. | Text | Iptc4xmpExt: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 text | Iptc4xmpCore:AltTextAccessibility |
Artwork or Object in the Image | A set of metadata about artwork or an object in the image | One or more ArtworkOrObject objects. | Iptc4xmpExt:ArtworkOrObject |
Code of Organization Featured in the Image | Code 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:companyA | Iptc4xmpExt:OrganisationInImageCode |
Contributor | Party or parties (person or organization) which contributed to the image, refinement by the role attribute. | One or more EntityWRole objects. | Iptc4xmpExt:Contributor |
Copyright Notice | Any 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 text | dc:rights |
Copyright Owner | Owner or owners of the copyright in the licensed image. | Up to three CopyrigthOwner structures | plus:CopyrightOwner |
Creator | Contains 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. | Text | dc:creator |
Creator’s Contact Info | The 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 structure | Iptc4xmpCore:CreatorContactInfo |
Creator’s job title | Contains 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. | Text | photoshop:AuthorsPosition |
Credit Line | The 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. | Text | photoshop:Credit |
CV-Term About Image | One 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 Mining | DO NOT USE this property. Instead use the C2PA "do not train" assertion. | ||
Date Created | Designates 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 |
Description | A textual description, including captions, of the image. | Localizable text | dc:description |
Description Writer | Identifier 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. | Text | photoshop:CaptionWriter |
Digital Image GUID | Globally 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. | Text | Iptc4xmpExt:DigImageGUID |
Digital Source Type | The type of the source of this digital image | An IPTC digital source type code | Iptc4xmpExt:DigitalSourceType |
Embedded Encoded Rights Expression | An embedded rights expression using any rights expression language | One or more EmbdEncRightsExpr structures. | Iptc4xmpExt:EmbdEncRightsExpr |
Event Identifier | Identifier(s) of the specific event at which the photo was taken | One or more URIs | Iptc4xmpExt:EventId |
Event Name | Names or describes the specific event at which the photo was taken. | Localizable text | Iptc4xmpExt: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 text | Iptc4xmpCore:ExtDescrAccessibility |
Genre | Artistic, 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 |
Headline | A brief synopsis of the caption. Headline is not the same as Title. | Text | photoshop:Headline |
Image Creator | Creator or creators of the image | Up to three ImageCreator structures. | plus:ImageCreator |
Image Rating | Rating of the image by its user or supplier | Decimal: -1: "rejected" 0: "unrated" (default) 0...5 | xmp:Rating |
Image Region | Sets 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 Entry | Both 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 Supplier | Identifies the most recent supplier of the image, who is not necessarily its owner or creator. | ImageSupplier structure. | plus:ImageSupplier |
Image Supplier Image ID | Optional identifier assigned by the Image Supplier to the image. | Text | plus:ImageSupplierImageID |
Instructions | Any number of instructions from the provider or creator to the receiver of the image | Text | photoshop:Instructions |
Job Id | Number 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. | Text | photoshop:TransmissionReference |
Keywords | Keywords to express the subject of the image. Keywords may be free text and don’t have to be taken from a controlled vocabulary. | Text | dc:subject |
Licensor | A 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 Expression | A linked rights expression using any rights expression language. | One or more LinkedEncRightsExpr structures. | Iptc4xmpExt:LinkedEncRightsExpr |
Location created | The location the photo was taken. | Location structure. | Iptc4xmpExt:LocationCreated |
Location shown in the image | A location shown in the image. | One or more Location structures. | Iptc4xmpExt:LocationShown |
Max Avail Height | The maximum available height in pixels of the original photo from which this photo has been derived by downsizing. | Integer | Iptc4xmpExt:MaxAvailHeight |
Max Avail Width | The maximum available width in pixels of the original photo from which this photo has been derived by downsizing. | Integer | Iptc4xmpExt:MaxAvailWidth |
Minor Model Age Disclosure | Age 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 Age | Age of the human model(s) at the time this image was taken in a model released image. | One or more Integers | Iptc4xmpExt:ModelAge |
Model Release Id | Identifier(s) of a Model Release document. | Text (one or more). See PLUS Specification Model Release ID | plus:ModelReleaseID |
Model Release Status | Summarizes 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 Image | Name of the organization or company which is featured in the image. | Text (one or more) | Iptc4xmpExt:OrganisationInImageName |
Other Constraints | Additional constraints on the use of the asset. | Text (one or more) (localizable) | plus:OtherConstraints |
Person Shown in the Image | Name of a person shown in the image. | Text (one or more) | Iptc4xmpExt:PersonInImage |
Person Shown in the Image with Details | Details about a person the content is about. | personWDetails structure | Iptc4xmpExt:PersonInImageWDetails |
Product Shown in the Image | A product the content is about. | One or more ProductWGtin structures. | Iptc4xmpExt:ProductInImage |
Property Release Id | Identifier(s) of a Property Release document. | Text (one or more). See PLUS Specification Property Release ID | plus:PropertyReleaseID |
Property Release Status | Summarizes 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 Terms | The licensing parameters of the image expressed in free-text. | Localizable text | xmpRights:UsageTerms |
Scene Code | Describes 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. | Text | photoshop:Source |
Title | A 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 text | dc:title |
Web Statement of Rights | URL 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.
Property | Datatype | Data format | Specification link |
---|---|---|---|
Iptc4xmpExt:AOCircaDateCreated | String | N/A | Circa Date Created |
Iptc4xmpExt:AOContentDescription | Structure | Localizable text | Content Description |
Iptc4xmpExt:AOContributionDescription | Structure | Localizable text | Contribution Description |
Iptc4xmpExt:AOCopyrightNotice | String | N/A | Copyright Notice |
Iptc4xmpExt:AOCreatorNames | String | N/A | Creator |
Iptc4xmpExt:AOCreatorIdentifiers | String | URI | Creator ID |
Iptc4xmpExt:AOCurrentCopyrightOwnerIdentifier | String | URI | Current Copyright Owner ID |
Iptc4xmpExt:AOCurrentCopyrightOwnerName | String | N/A | Current Copyright Owner Name |
Iptc4xmpExt:AOCurrentLicensorIdentifier | String | URI | Current Licensor Identifier |
Iptc4xmpExt:AOCurrentLicensorName | String | N/A | Current LicensorName |
Iptc4xmpExt:AODateCreated | String | date-time | Date Created |
Iptc4xmpExt:AOPhysicalDescription | Structure | Localizable text | Physical Description |
Iptc4xmpExt:AOSource | String | N/A | Source |
Iptc4xmpExt:AOSourceInvNo | String | N/A | Source Inventory Number |
Iptc4xmpExt:AOSourceInvURL | String | URL | Source Inventory URL |
Iptc4xmpExt:AOStylePeriod | String | N/A | Style Period |
Iptc4xmpExt:AOTitle | Structure | Localizable text | Title |
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.
Property | Datatype | Data format | Specification link |
---|---|---|---|
plus:CopyrightOwnerId | String | N/A | Copyright Owner ID |
plus:CopyrightOwnerName | String | N/A | Copyright 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.
Property | Datatype | Data format | Specification link |
---|---|---|---|
Iptc4xmpCore:CiAdrExtadr | String | N/A | Address |
Iptc4xmpCore:CiAdrCity | String | N/A | City |
Iptc4xmpCore:CiAdrCtry | String | N/A | Country |
Iptc4xmpCore:CiEmailWork | String | N/A | Email address(es) |
Iptc4xmpCore:CiTelWork | String | N/A | Phone number(s) |
Iptc4xmpCore:CiAdrPcode | String | N/A | Postal Code |
Iptc4xmpCore:CiAdrRegion | String | N/A | State/Province |
Iptc4xmpCore:CiUrlWork | String | URL | 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.
Property | Datatype | Data format | Specification link |
---|---|---|---|
Iptc4xmpExt:CvId | String | URI | CV-Term CV ID |
Iptc4xmpExt:CvTermId | String | URI | CV-Term ID |
Iptc4xmpExt:CvTermName | Structure | Localizable text | CV-Term Name |
Iptc4xmpExt:CvTermRefinedAbout | String | URI | Refined '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.
Property | Datatype | Data format | Specification link |
---|---|---|---|
Iptc4xmpExt:EncRightsExpr | String | N/A | Encoded Rights Expression |
Iptc4xmpExt:RightsExprEncType | String | N/A | Encoding type |
Iptc4xmpExt:RightsExprLangId | String | URI | Rights 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.
Property | Datatype | Data format | Specification link |
---|---|---|---|
xmp:Identifier | String | URI | Identifier |
Iptc4xmpExt:Name | Structure | Localizable text | Name |
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.
Property | Datatype | Data format | Specification link |
---|---|---|---|
xmp:Identifier | String | URI | Identifier |
Iptc4xmpExt:Name | Structure | Localizable text | Name |
Iptc4xmpExt:Role | String | N/A | Role |
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..
Property | Datatype | Data format | Specification link |
---|---|---|---|
plus:ImageCreatorID | String | N/A | Image Creator ID |
plus:ImageCreatorName | String | N/A | Image 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.
Property | Datatype | Data format | Specification link |
---|---|---|---|
Iptc4xmpExt:RegionBoundary | Structure | RegionBoundary | Region Boundary |
Iptc4xmpExt:rId | String | N/A | Region Identifier |
Iptc4xmpExt:Name | Structure | Localizable text | Region Name |
Iptc4xmpExt:rCtype | Structure | Entity | Region Content Type |
Iptc4xmpExt:rRole | Structure | Entity | Region Role |
Iptc4xmpExt:<other> | Any | N/A | Other 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.
Property | Datatype | Data format | Specification link |
---|---|---|---|
plus:ImageSupplierID | String | N/A | Image Supplier ID |
plus:ImageSupplierName | String | N/A | Image Supplier Name |
Licensor
This structure provides information on the party or parties granting the license to the licensee.
See Licensor in the PLUS Specification.
Property | Datatype | Data format | Specification link |
---|---|---|---|
plus:LicensorID | String | N/A | Licensor ID |
plus:LicensorName | String | N/A | Licensor Name |
plus:LicensorStreetAddress | String | N/A | Licensor Address |
plus:LicensorExtendedAddress | String | N/A | Licensor Address Detail |
plus:LicensorCity | String | N/A | Licensor City |
plus:LicensorRegion | String | N/A | Licensor State or Province |
plus:LicensorPostalCode | String | N/A | Licensor Postal Code |
plus:LicensorCountry | String | N/A | Licensor Country |
plus:LicensorTelephoneType1 | String | URL | Licensor TelephoneType1 |
plus:LicensorTelephone1 | String | N/A | Licensor Telephone1 |
plus:LicensorTelephoneType2 | String | URL | Licensor TelephoneType2 |
plus:LicensorTelephone2 | String | N/A | Licensor Telephone2 |
plus:LicensorEmail | String | N/A | Licensor Email |
plus:LicensorURL | String | URL | Licensor 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.
Property | Datatype | Data format | Specification link |
---|---|---|---|
Iptc4xmpExt:LinkedRightsExpr | String | URL | Link to Encoded Rights Expression |
Iptc4xmpExt:RightsExprEncType | String | MIME Type / URI | Encoding type |
Iptc4xmpExt:RightsExprLangId | String | URI | Rights Expression Language ID |
Location
This structure provides details about a location.
See Location structure in the IPTC Photo Metadata Specification.
Property | Datatype | Data format | Specification link |
---|---|---|---|
Iptc4xmpExt:City | String | N/A | City |
Iptc4xmpExt:CountryCode | String | N/A | Country Code |
Iptc4xmpExt:CountryName | String | N/A | Country Name |
exif:GPSAltitude | Number | N/A | GPS Altitude |
exif:GPSLatitude | Number | N/A | GPS Latitude |
exif:GPSLongitude | Number | N/A | GPS Longitude |
Iptc4xmpExt:LocationId | String | URI | Location Identifier |
Iptc4xmpExt:LocationName | Structure | Localizable text | Location Name |
Iptc4xmpExt:ProvinceState | String | N/A | Province or State |
Iptc4xmpExt:Sublocation | String | N/A | Sublocation |
Iptc4xmpExt:WorldRegion | String | N/A | World Region |
PersonWDetails
This structure provides details about a single person in the image.
See Person structure in the IPTC Photo Metadata Specification.
Property | Datatype | Data format | Specification link |
---|---|---|---|
Iptc4xmpExt:PersonCharacteristic | Structure | CvTerm | Characteristics |
Iptc4xmpExt:PersonDescription | Structure | Localizable text | Description |
Iptc4xmpExt:PersonId | String | URI | Identifier |
Iptc4xmpExt:PersonName | Structure | Localizable text | Name |
ProductWGtin
This structure provides details about a product.
See Product structure in the IPTC Photo Metadata Specification.
Property | Datatype | Data format | Specification link |
---|---|---|---|
Iptc4xmpExt:ProductDescription | Structure | Localizable text | Description |
Iptc4xmpExt:ProductGTIN | String | N/A | GTIN |
Iptc4xmpExt:ProductId | String | URI | Identifier |
Iptc4xmpExt:ProductName | Structure | Localizable text | Name |
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.
Property | Datatype | Data format | Specification link |
---|---|---|---|
Iptc4xmpExt:rbShape | String | N/A | rbShape |
Iptc4xmpExt:rbUnit | String | N/A | rbUnit |
Iptc4xmpExt:rbX | Number | N/A | rbX |
Iptc4xmpExt:rbY | Number | N/A | rbY |
Iptc4xmpExt:rbW | Number | N/A | rbW |
Iptc4xmpExt:rbH | Number | N/A | rbH |
Iptc4xmpExt:rbRx | Number | N/A | rbRx |
Iptc4xmpExt:rbVertices | Structure | RegionBoundaryPoint | rbVertices |
RegionBoundaryPoint
This structure defines a point in an image by its coordinates.
See Region Boundary Point structure in the IPTC Photo Metadata Specification.
Property | Datatype | Data format | Specification link |
---|---|---|---|
Iptc4xmpExt:rbX | Number | N/A | rbX |
Iptc4xmpExt:rbY | Number | N/A | rbY |
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.
Property | Datatype | Data format | Specification link |
---|---|---|---|
Iptc4xmpExt:RegItemId | String | N/A | Registry Item ID |
Iptc4xmpExt:RegOrgId | String | N/A | Registry Organization ID |
Iptc4xmpExt:RegEntryRole | String | URI | Role |