1. Introduction
This document is designed to familiarise developers, architects and video makers with the IPTC Video Metadata Hub, a specification of key metadata fields and a mapping of those fields between commonly-used video formats. It provides a short guideline on the use and meaning of each "field" or "property" in the IPTC Video Metadata Hub.
1.1. What IPTC Video Metadata Hub is For
IPTC’s Video Metadata Hub is a universal metadata schema for video developed with the key goal of storing and exchanging metadata in a safe and reliable way.
It is not a new video metadata standard, in the sense that it does not define any new fields that are not already defined in other formats.
Instead, it defines a common set of video metadata fields, giving precise semantics — so we will know exactly what we mean by "Contributor" or "Creator" — and shows how each of those common fields can be used in existing video standards such as MovieLabs MDDF, DPP’s implementation of the AS-11 profile of MXF, EBUCore, PBCore, IPTC Photo Metadata Standard, Apple Quicktime, MPEG7, and camera-specific formats such as Panasonic P2 and Sony XDCAM.
These properties can be used for describing the visible and audible content, rights and licensing information, administrative details and technical characteristics of a video in a system-independent way.
It’s like Dublin Core, but for video metadata.
1.2. What problem are we solving?
Metadata is stored in different ways in existing video formats. For video editors it is very difficult to move video metadata between systems and the semantics are not always clear.
For example, location information can be described in various existing video metadata formats as:
-
locationwithrole=0in QuickTime -
Creation/locationin MPEG7 -
locatedin NewsML-G2 -
locationCreatedin schema.org -
Shoot/Locationin SMPTE P2
IPTC Video Metadata Hub describes two fields, Location Shot and Location Shown, with very clearly defined semantics, and the fields are mapped to fields of existing video formats, so metadata can be moved between systems from different vendors.
1.3. Using Video Metadata Hub with your video content
The way in which Video Metadata Hub fields are associated with your video content will vary depending on the workflows and technical video structures used in your organisation.
Typically users will choose one of three mechanisms for expressing Video Metadata Hub properties for their content:
- Sidecar files
-
Some organisations will choose to associate metadata in so-called "sidecar files", in a format such as JSON, NewsML-G2 or as an XML component in an IMF package. We have created a JSON Schema for IPTC Video Metadata Hub which makes this easy to do.
- Embedded metadata
-
Other organisations will embed metadata into the video file, using a structure such as an XMP metadata packet in a UUID box in an ISO Base Media File Format (ISOBMFF) or Quicktime file.
- External database
-
A third option is to simply use Video Metadata Hub properties in a database schema describing metadata in a Digital Asset Management system.
2. About the IPTC Video Metadata User Guide
2.1. IPTC Video Metadata Hub version used by this User Guide
This document is based on IPTC Video Metadata Hub version 1.5 which was approved in October 2023. The specification for Video Metadata Hub is separated into two parts: IPTC Video Metadata Hub properties and IPTC Video Metadata Hub mappings showing how to apply these core properties in many existing video standards.
Examples, information and the specification document can be obtained from https://iptc.org/std/videometadatahub/
2.2. What’s new in version 1.4 of Video Metadata Hub?
Version 1.4 introduces several new properties and several changes to add accessibility properties and to align it more closely with the IPTC Photo Metadata Standard:
-
Content Warning: signals to viewers such as drug references, nudity or violence, and health warnings such as flashing lights.
-
Digital Source Type: whether the content was created by a digital camera, scanned from film, or created using or with the assistance of a computer.
-
Review Rating: a third-party review such as a film’s rating on Rotten Tomatoes.
-
Workflow Rating: equivalent to the XMP rating field, a numeric scale generally used by creators to tag shots/takes/videos that are of higher quality.
-
Alt Text (Accessibility): Short text describing the video to those who cannot view it.
-
Extended Description (Accessibility): Longer description more fully describing the purpose and meaning of the video, elaborating on the information given in the Alt Text (Accessibility) property.
-
Timed Text Link: refers to an external file used for text with timing information using a standard such as WebVTT or W3C Timed Text, usually used for subtitles, closed captions or audio description
-
Date Created: modified description to align it with Photo Metadata.
-
Rating: modified description to make it more specifically about audience content classifications such as MPA ratings
-
Data Displayed on Screen: changed description.
-
Keywords: Pluralised label to match the equivalent in Photo Metadata.
-
Title: changed data type to allow multiple languages
-
Transcript: changed data type to allow multiple languages
-
Copyright Year: changed description to add "year of origin of the video"
-
Embedded Encoded Rights Expression: property label changed from "Rights and Licensing Terms (1)" to clarify and align with Photo Metadata
-
Linked Encoded Rights Expression: property label changed from "Rights and Licensing Terms (2)" to clarify and align with Photo Metadata
-
Copyright Owner: label change label from "Rights Owner" to align with Photo Metadata
-
Source (Supply Chain): Change label and XMP property to align it with Photo Metadata
-
Qualified Link with Language: used by Times Text Link, specifies an external file along with its role (eg "audio description") and human language (eg "Spanish")
-
"Embedded Encoded Rights Expression Structure" changed label from "Embedded Rights Expression Structure" to align with Photo Metadata
-
"Linked Encoded Rights Expression Structure" changed label from "Linked Rights Expression Structure" to align with Photo Metadata
-
Data type of "Role" in the "Entity with Role" structure was changed from URI to Text to align with Photo Metadata
2.3. Copyright
Copyright © 2024 IPTC, International Press Telecommunications Council. Rights Reserved.
The IPTC Video Metadata User Guide document is published under the Creative Commons Attribution 4.0 license - see the full license agreement at http://creativecommons.org/licenses/by/4.0/.
By obtaining, using and/or copying this document, you (the licensee) agree that you have read, understood, and will comply with the terms and conditions of the license.
Materials used in this guide are either in the public domain or are available with the permission of their respective copyright holders. All materials of this IPTC standard covered by copyright shall be licensable at no charge.
2.4. Acknowledgements
This document is the result of a team effort by members of the Video Metadata Working Group of the International Press Telecommunications Council (IPTC), with input and assistance from other contributors.
The User Guide up to this version was edited by (in alphabetical order):
Linda Burman (Individual IPTC member), Derek Coller (Getty Images), Pam Fisher (Individual Member and lead of the IPTC Video Metadata Working Group), Mark Milstein (Microstocksolutions) Brendan Quinn (IPTC), David Riecks (www.controlledvocabulary.com/PLUS), Michael Steidl (Honorary IPTC member), Alison Sullivan (Individual Member).
2.5. How to contact IPTC
Join the public IPTC Video Metadata group: https://groups.io/g/iptc-videometadata/
Submit a message on our website: https://iptc.org/about-iptc/contact-us/
Visit IPTC’s website: https://iptc.org/standards/video-metadata-hub/
Follow IPTC on Twitter: @IPTC
2.6. About IPTC
The IPTC, based in London, brings together the world’s leading news agencies, publishers and industry vendors. It develops and promotes efficient technical standards to improve the management and exchange of information between content providers, intermediaries and consumers. The standards enable easy, cost-effective and rapid innovation and include the Photo Metadata standard, the Video Metadata Hub, the news exchange formats NewsML-G2, ninjs, SportsML-G2 and NITF, rNews for marking up online news, the rights expression language RightsML, and NewsCodes taxonomies for categorising news.
IPTC is a not-for-profit membership organisation registered in England - find more about membership.
Business address:
IPTC International Press Telecommunications Council 25 Southampton Buildings London WC2A 1AL United Kingdom
3. Use Cases for Video Metadata Hub
The Video Metadata Hub aims to provide a comprehensive set of properties, however specific applications may not require each of these.
To make Video Metadata Hub easier to understand, a set of six initial use cases has been outlined, each typically requiring only a subset of VMH properties:
- Enterprise Advertising Production
-
Non-broadcast corporate marketing video assets
- Galleries, Libraries, Archives, Museums (GLAM)
-
Moving image material held by cultural institutions, for preservation, exhibition or reference
- Stock Footage
-
Individual film/video footage clips from production or archive, made available for licensing or repurposing
- Long-form Production
-
Finished programming ready for broadcast playout or OTT delivery. (Note that the example video for long-form production will be added to this guide in the future)
- Broadcast Media Management
-
Broadcast asset management for repository and archive. (Note that the example video for Broadcast Media Management will be added to this guide in the future)
- News Agency
-
Individual video news item distributed or published by a news agency
For each of these use cases, we provide an example video below, showing the Video Metadata Hub fields that would apply to that use case in particular.
3.1. Enterprise Advertising Production example
Thanks to Allison Sullivan of MGM Resorts for providing the example footage:
3.1.1. Administrative fields
| Property name | Example value |
|---|---|
2020-04-28 |
|
2021-01-21 |
|
2020-12-10 |
|
MGM Resorts International Operations Inc. |
|
106271516 |
|
v.2 |
3.1.2. Fields describing audio/visual content
| Property name | Example value |
|---|---|
Video; Fountains of Bellagio; Attractions; Entertainment & Attractions; Fountains; Drone; Drone Footage; Night; Exterior; Aerial; Architecture; Drone Footage - Night; Aerial View; Aircraft Point of View; Building - Exterior |
|
Bellagio, Las Vegas |
|
Bellagio, Las Vegas |
|
Fountains of Bellagio |
|
Aerial, exterior, night |
|
BEL106271516 |
|
Color |
3.1.3. Rights fields
| Property name | Example value |
|---|---|
Mark Ott |
|
MGM Resorts International Operations Inc. |
|
2020 |
|
Mark Ott |
|
Mark Ott, 808 Post |
|
MGM Resorts International Operations Inc. |
3.2. Galleries, Libraries, Archives, Museums example
3.2.1. Administrative fields
| Property name | Example value |
|---|---|
1990s |
|
No |
|
Wellcome Library |
|
Yes |
|
b16766246 |
3.2.2. Fields describing audio/visual content
| Property name | Example value |
|---|---|
Public health |
|
A television advertisement asking people to register for a Donor Card in order to donate organs after death. |
|
Public information |
|
A television advertisement asking people to register for a Donor Card in order to donate organs after death. |
|
Organ procurement, Public health, Medical sciences, Organ transplantation, Health education, Health policy, Health services |
|
En |
|
Donor card gift (commercial). |
3.2.3. Rights fields
| Property name | Example value |
|---|---|
This video was made from material preserved by the BFI National Archive. |
|
Crown copyright, managed by BFI; CC-BY-NC |
|
This video was made from material preserved by the BFI National Archive. |
|
Wellcome Library |
3.3. Stock Footage example
Thanks to Mark Milstein of Microstocksolutions for providing the example footage:
3.3.1. Administrative fields
| Property name | Example value |
|---|---|
2020-09-18 |
|
2020-09-18 |
|
2020-09-18 |
|
Mark Milstein |
|
2020-10-21 |
|
IPTC VM Working Group |
|
Mark Milstein |
|
IPTC VM Working Group Authentication Process |
|
{ "manufacturer": "Panasonic", "modelName": "HC-X1"} |
|
VRMETA_101010 |
|
Drone footage |
|
{ "tempCoverageFrom": "2020", "tempCoverageTo": "2020" } |
|
VRMETA_100000 |
3.3.2. Fields describing audio/visual content
| Property name | Example value |
|---|---|
An aerial view of the Budapest Container Port |
|
container port, Budapest, Hungary, railroad, trucking, transportation, logistics, aerial view |
|
Budapest |
|
Budapest |
|
Container port |
|
Aerial, long shot |
|
An aerial view of the Budapest Container Port |
3.3.3. Rights fields
| Property name | Example value |
|---|---|
Copyright VRMETA |
|
2020 |
|
Mark Millstein |
|
VRMETA |
|
VRMETA |
3.4. News Agency example
3.4.1. Administrative fields
| Property name | Example value |
|---|---|
1961-05-25 |
|
1961-05-25 |
|
NASA Video |
|
NASA |
|
Unknown |
3.4.2. Fields describing audio/visual content
| Property name | Example value |
|---|---|
President Kennedy speaks to Congress on May 25, 1961. |
|
? |
|
In an address to Congress on "Urgent National Needs" on May 25, 1961, President John F. Kennedy called for America to send astronauts to the moon and return him safely to Earth before the end of the decade. |
|
In an address to Congress on "Urgent National Needs" on May 25, 1961, President John F. Kennedy called for America to send astronauts to the moon and return him safely to Earth before the end of the decade. |
|
NASA, US Government |
|
News |
|
A President Issues NASA’s First Historic Challenge |
|
president,kennedy,NASA,Moon,Space,Space Race,Congress |
|
EN |
|
Washington DC |
|
Washington DC |
|
President John F Kennedy |
|
President John F Kennedy |
3.4.3. Rights fields
| Property name | Example value |
|---|---|
NASA |
|
1961 |
|
NASA |
4. Properties and Mappings for video metadata
The Video Metadata Hub’s set of metadata properties includes:
-
26 properties describing what can be seen and heard in the video
-
15 properties providing rights-related information
-
30 properties for administrative purposes
-
26 properties covering technical characteristics
-
26 property structures which are used for the properties listed above.
Each property is defined by:
-
its name
-
a definition of its semantics
-
a basic data type
-
a definition how often it may occur in the metadata about a piece of video (its "cardinality")
The properties are defined in detail in the Property Reference Table below.
Each property can be used to describe a clip within a video or the video as a whole.
Below the property table we describe how these properties can be mapped to many existing video structures using our mapping table.
4.1. Core Properties for Video Metadata Hub
Recognising that the alphabetical list of properties can be hard to work with, the IPTC Video Metadata Working Group has identified a "core" set of properties that are recommended to be used in the majority of cases.
There is nothing special about these properties; they have the same status as all other Video Metadata Hub properties. We simply highlight them here for ease of use and recommend that editing tools implement these properties as a minimum set.
| Property name | Description | Format |
|---|---|---|
Title of the video, should be a shorthand reference |
Text + language tag (0..1) |
|
Short description of the content of the video |
Text + language tag (0..1) |
|
Textual description of the content of the video |
Text + language tag (0..1) |
|
What the video is about expressed by a free choice of descriptive phrases or keywords |
Text + language tag (0..unbounded) |
|
Place(s) shown by the video |
Location structure (0..unbounded) |
|
A brief textual description of the purpose and meaning of a video that can be accessed by assistive technology or displayed when the video is disabled in the browser. It should not exceed 250 characters. |
Text + language tag (0..1) |
|
Globally unambiguous identifier of the video regardless of renditions, formats, encodings etc. This identifier should be shared across all renditions. |
Text (0..1) |
|
Designates the date and optionally the time the content of the video was created (rather than the date of the creation of the digital representation) |
Date (0..1) |
|
Party or parties (person or organisation) which created the video, refinement by the role attribute. |
Entity with role structure (0..unbounded) |
|
Any textual notice necessary by legal needs or common use to indicate the current owner of the copyright of this media resource |
Text + language tag (0..1) |
|
Data identifying the individual or organisation owning the rights for this media resource which could be the video as a whole or a clip in a video. The optional role attribute may indicate which facet of rights is covered by this entity. |
Entity with role (0..unbounded) |
|
Year of origin of the video, usually appearing in the copyright notice as a numeric value |
Number/integer (0..1) |
|
Credit to person(s) and/or organisation(s) required by the supplier of the video (clip) to be used when published. |
Text (0..1) |
|
Party or parties (person or organisation) which contributed to the video, refinement by the role attribute. |
Entity with role structure (0..unbounded) |
|
Language version of the video |
Language tag (0..1) |
|
An aesthetic rating given to the video by its creator or editor, for example to mark the best take of a series |
 Rating structure (0..unbounded) |
|
The type of the source of this digital video, including whether the video was captured, digitised or generated. |
Concept structure (0..1) |
|
Data mining prohibition or permission, optionally with constraints. |
PLUS CV Term/URI |
|
IANA Media Type of the video. |
Text (0..1) |
|
Format of the file containing the video data. |
Entity structure (0..1) |
|
Duration of the overall video (from the first to the last frame) |
Video Time structure (0..1) |
5. Property Reference Table
This section provides a reference of property labels and names in alphabetical order for quick location of specific fields and their guidelines.
Each property has a data type such as Text or Date. Where the property requires a more complex structure such as Location Structure, it is hyperlinked to the below section which defines the properties that make up each property structure.
5.1. Administrative fields
5.1.1. Circa Date Created
Property name |
Circa Date Created |
|---|---|
Definition |
Approximate date or range of dates associated with the creation and production of a video. |
Notes |
Primarily for archival use if exact dates are not available. |
Type and cardinality |
Text (0..1) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:CircaDateCreated (Text) |
JSON ID and data type |
circaDateCreated (string//) |
5.1.2. Content Warning
Property name |
Content Warning |
|---|---|
Definition |
Information to warn potential viewers about nudity, violence etc in the video |
Notes |
Use of the CV https://cv.iptc.org/newscodes/contentwarning/ is recommended. |
Type and cardinality |
Concept Structure (0..unbounded) |
Change history |
New 1.4 |
XMP ID and data type |
Iptc4xmpExt:ContentWarning (Bag of CV Term structure) |
JSON ID and data type |
contentWarning (CvTerm//array) |
5.1.3. Date Created
Property name |
Date Created |
|---|---|
Definition |
Designates the date and optionally the time the content of the video was created (rather than the date of the creation of the digital representation) |
Notes |
If exact dates are not available use Circa Date Created. |
Type and cardinality |
Date (0..1) |
Change history |
Changed 1.4 |
XMP ID and data type |
photoshop:DateCreated (Date) |
JSON ID and data type |
dateCreated (string/date-time/) |
5.1.4. Date Modified
Property name |
Date Modified |
|---|---|
Definition |
Date and optionally time when the video was modified last time |
Type and cardinality |
Date (0..1) |
Change history |
New 1.0 |
XMP ID and data type |
xmp:ModifyDate (Date) |
JSON ID and data type |
dateModified (string/date-time/) |
5.1.5. Date Released
Property name |
Date Released |
|---|---|
Definition |
Date and optionally time of the public release of the video |
Type and cardinality |
Date (0..1) (Year only, Year-Month only, Year-Month-Day optional with time) |
Change history |
Changed 1.3 |
XMP ID and data type |
xmpDM:releaseDate (Date) |
JSON ID and data type |
dateReleased (string/date-time/) |
5.1.6. Digital Source Type
Property name |
Digital Source Type |
|---|---|
Definition |
The type of the source of this digital video, including whether the video was captured, digitised or generated. |
Notes |
Use of the CV https://cv.iptc.org/newscodes/digitalsourcetype/ is recommended. |
Type and cardinality |
Concept Structure (0..1) |
Change history |
New 1.4 |
XMP ID and data type |
Iptc4xmpExt:DigitalSourceType (CV Term structure) |
JSON ID and data type |
digitalSourceType (CvTerm) |
5.1.7. Episode
Property name |
Episode |
|---|---|
Definition |
Episode in a specific season of a TV or video series this video is a member of. |
Type and cardinality |
Episode/Season Structure (0..1) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:Episode (Episode structure) |
JSON ID and data type |
episode (EpisodeSeason) |
5.1.8. External Metadata URL
Property name |
External Metadata URL |
|---|---|
Definition |
Link(s) to an external web resource for retrieval of further metadata about this video |
Type and cardinality |
URL (0..unbounded) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:ExternalMetadataLink (Bag of URL) |
JSON ID and data type |
externalMetadataLinks (string/uri/array) |
5.1.9. Feed Identifier
Property name |
Feed Identifier |
|---|---|
Definition |
Identifier of the feed/source this video was delivered by |
Type and cardinality |
Text (0..1) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:FeedIdentifier (Text) |
JSON ID and data type |
feedIdentifier (string//) |
5.1.10. Metadata Edit Date
Property name |
Metadata Edit Date |
|---|---|
Definition |
Date of the last edit of the metadata of this video. |
Type and cardinality |
Date(0..1) |
Change history |
New 1.3 |
XMP ID and data type |
Iptc4xmpExt:metadataLastEdited (Date) |
JSON ID and data type |
metadataLastEdited (string/date-time/) |
5.1.11. Metadata Editor
Property name |
Metadata Editor |
|---|---|
Definition |
Party doing the last edit of the metadata of this video. |
Type and cardinality |
Entity Structure (0..1) |
Change history |
New 1.3 |
XMP ID and data type |
Iptc4xmpExt:metadataLastEditor (Entity structure) |
JSON ID and data type |
metadataLastEditor (Entity//) |
5.1.12. Metadata Authority
Property name |
Metadata Authority |
|---|---|
Definition |
Party responsible for the accuracy of the metadata values. |
Type and cardinality |
Entity Structure (0..1) |
Change history |
New 1.3 |
XMP ID and data type |
Iptc4xmpExt:metadataAuthority (Entity structure) |
JSON ID and data type |
metadataAuthority (Entity//) |
5.1.13. Planning Reference
Property name |
Planning Reference |
|---|---|
Definition |
Reference to a data item used for planning the shooting of this video |
Type and cardinality |
Entity with role Structure (0..unbounded) |
Change history |
New 1.2 |
XMP ID and data type |
Iptc4xmpExt:PlanningRef (Bag Enitity with Role structure) |
JSON ID and data type |
planningRefs (EntityWRole//array) |
5.1.14. Publication Event
Property name |
Publication Event |
|---|---|
Definition |
Date and optionally the time of publishing this video with name and identifier for the event of this publication. |
Type and cardinality |
Publication Event Structure (0..unbounded) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:PublicationEvent (Bag Publication Event structure) |
JSON ID and data type |
publicationEvents (PublicationEvent//array) |
5.1.15. Rating
Property name |
Rating |
|---|---|
Definition |
How the video is classified by a public authority such as MPA |
Type and cardinality |
Rating Structure (0..unbounded) |
Change history |
Changed 1.4 |
XMP ID and data type |
Iptc4xmpExt:Rating (Bag Rating structure) |
JSON ID and data type |
ratings (Rating//array) |
5.1.16. Ready for Release
Property name |
Ready for Release |
|---|---|
Definition |
An indicator if this video is ready for being released to the public. This depends on rules by the party responsible for the publication. |
Type and cardinality |
Boolean (0..1) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:ReleaseReady (Boolean) |
JSON ID and data type |
releaseReady (boolean//) |
5.1.17. Recording Device
Property name |
Recording Device |
|---|---|
Definition |
Device used for recording this video |
Type and cardinality |
Device Structure (0..1) |
Change history |
New 1.2 |
XMP ID and data type |
Iptc4xmpExt:RecDevice (Device structure) |
JSON ID and data type |
recordingDevice (Device) |
5.1.18. Registry Entry
Property name |
Registry Entry |
|---|---|
Definition |
Identifier of the video issued by an identified registry. |
Notes |
What is considered a registry can be interpreted in a wide sense as the controlled management of assets with asset-specific identifiers |
Type and cardinality |
Registry Entry Structure (0..unbounded) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:RegistryId (Bag Registry Entry (structure)) |
JSON ID and data type |
registryEntries (RegistryEntry//array) |
5.1.19. Review Rating
Property name |
Review Rating |
|---|---|
Definition |
An aesthetic rating given to the video by an external reviewer such as a news outlet |
Type and cardinality |
Rating Structure (0..unbounded) |
Change history |
New 1.4 |
XMP ID and data type |
Iptc4xmpExt:ReviewRating (Bag Rating structure) |
JSON ID and data type |
reviewRatings (Rating//array) |
5.1.20. Season
Property name |
Season |
|---|---|
Definition |
Season of a TV or video series this video is a member of. |
Type and cardinality |
Episode/Season Structure (0..1) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:Season (Season structure) |
JSON ID and data type |
season (EpisodeSeason) |
5.1.21. Series
Property name |
Series |
|---|---|
Definition |
TV or video series this video is a member of. |
Type and cardinality |
Series Structure (0..1) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:Series (Series structure) |
JSON ID and data type |
series (Series) |
5.1.22. Storyline Identifier
Property name |
Storyline Identifier |
|---|---|
Definition |
Identifier(s) of a story evolving over time with which this video is associated |
Type and cardinality |
Text (0..unbounded) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:StorylineIdentifier (Bag of Text) |
JSON ID and data type |
storylineIdentifiers (string//array) |
5.1.23. Style Period
Property name |
Style Period |
|---|---|
Definition |
The style, historical or artistic period, movement, group, or school whose characteristics are represented by the video |
Notes |
The Style Period may be different from the Temporal Coverage |
Type and cardinality |
Text (0..1) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:StylePeriod (Text) |
JSON ID and data type |
stylePeriod (string//) |
5.1.24. Temporal Coverage
Property name |
Temporal Coverage |
|---|---|
Definition |
Period of time covered by the video |
Notes |
The period of Temporal Coverage may be different from the Style Period. |
Type and cardinality |
Temporal Coverage Structure (0..1) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:TemporalCoverage (Temporal Coverage Structure) |
JSON ID and data type |
temporalCoverage (TemporalCoverage) |
5.1.25. Parent Video Identifier
Property name |
Parent Video Identifier |
|---|---|
Definition |
Globally unambiguous identifier of the video from which this video was derived. |
Notes |
This video could be a variant in the technical video format, a variant in edit, a variant in language of the referenced video. |
Type and cardinality |
Text/URI (0..1) |
Change history |
New 1.3 |
XMP ID and data type |
Iptc4xmpExt:parentId (Text) |
JSON ID and data type |
parentId (string//) |
5.1.26. Video Identifier
Property name |
Video Identifier |
|---|---|
Definition |
Globally unambiguous identifier of the video regardless of renditions, formats, encodings etc. This identifier should be shared across all renditions. |
Notes |
IPTC advises to follow the guidelines by either EIDR or ISAN (http://www.eidr.org or http://www.isan.org) |
Type and cardinality |
Text (0..1) |
Change history |
New 1.0 |
XMP ID and data type |
dc:identifier (Text) |
JSON ID and data type |
identifier (string//) |
5.1.27. Video Rendition
Property name |
Video Rendition |
|---|---|
Definition |
Unambiguous identifier of the video specific to a rendition. |
Notes |
Definitions of specific renditions are not provided by IPTC. Definitions of renditions may be based on format or encoding etc and can be set by producers of videos and/or system vendors. |
Type and cardinality |
Text (0..1) |
Change history |
New 1.0 |
XMP ID and data type |
xmpMM:RenditionClass (Text) |
JSON ID and data type |
rendition (string//) |
5.1.28. Video Version
Property name |
Video Version |
|---|---|
Definition |
Version of the video identified by the Video Identifier |
Type and cardinality |
Text (0..1) |
Change history |
New 1.0 |
XMP ID and data type |
xmpMM:VersionID (Text) |
JSON ID and data type |
videoVersion (string//) |
5.1.29. Workflow Rating
Property name |
Workflow Rating |
|---|---|
Definition |
An aesthetic rating given to the video by its creator or editor, for example to mark the best take of a series |
Type and cardinality |
Rating Structure (0..unbounded) |
Change history |
New 1.4 |
XMP ID and data type |
xmp:Rating (Closed Choice Real) |
JSON ID and data type |
workflowRating (number//) |
5.1.30. Workflow Tag
Property name |
Workflow Tag |
|---|---|
Definition |
Indicator for the role of this video in a production workflow. |
Notes |
Could be used to indicate footage, edited video, program masters, etc. Values are typically codes defined by a production company. |
Type and cardinality |
Concept Structure (0..1) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:WorkflowTag (CV Term structure) |
JSON ID and data type |
workflowTag (CvTerm) |
5.2. Fields describing audio/visual content
5.2.1. Alt Text (Accessibility)
Property name |
Alt Text (Accessibility) |
|---|---|
Definition |
A brief textual description of the purpose and meaning of a video that can be accessed by assistive technology or displayed when the video is disabled in the browser. It should not exceed 250 characters. |
Notes |
This property should not be confused with the IPTC property Headline, which is a brief synopsis or summary of the contents of the video. This property is required for conformance with the W3C Web Content Accessibility Guidelines (WCAG). |
Type and cardinality |
Text + language tag (0..1) |
Change history |
New 1.4 |
XMP ID and data type |
Iptc4xmpCore:AltTextAccessibility (Lang Alt) |
JSON ID and data type |
altTextAccessibility (AltLang) |
5.2.2. CV Term About the Content
Property name |
CV Term About the Content |
|---|---|
Definition |
What the video is about expressed by term(s) selected from taxonomies or controlled vocabularies |
Type and cardinality |
Concept Structure (0..unbounded) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:AboutCvTerm (Bag CV Term structure) |
JSON ID and data type |
aboutCvTerms (CvTerm//array ) |
5.2.3. Data Displayed on Screen
Property name |
Data Displayed on Screen |
|---|---|
Definition |
Text or other data shown in some region of the video. |
Type and cardinality |
Text with Region Delimiter Structure (0..unbounded) |
Change history |
Changed 1.4 |
XMP ID and data type |
Iptc4xmpExt:DataOnScreen (Bag Text with Region Delimiter structure) |
JSON ID and data type |
dataOnScreen (TextWRegionDelimiter//array) |
5.2.4. Description
Property name |
Description |
|---|---|
Definition |
Textual description of the content of the video |
Type and cardinality |
Text + language tag (0..1) |
Change history |
New 1.0 |
XMP ID and data type |
dc:description (Lang Alt) |
JSON ID and data type |
description (AltLang) |
5.2.5. Dopesheet
Property name |
Dopesheet |
|---|---|
Definition |
Shotlist with descriptions |
Type and cardinality |
Text + language tag (0..1) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:Dopesheet (Lang Alt) |
JSON ID and data type |
dopesheet (AltLang) |
5.2.6. Dopesheet Link
Property name |
Dopesheet Link |
|---|---|
Definition |
Link(s) to an external web resource providing a shotlist with descriptions |
Type and cardinality |
Qualified Link Structure (0..unbounded) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:DopesheetLink (Bag Qualified Link) |
JSON ID and data type |
dopesheetLinks (QualifiedLink//array) |
5.2.7. Extended Description (Accessibility)
Property name |
Extended Description (Accessibility) |
|---|---|
Definition |
A more detailed textual description of the purpose and meaning of a video that elaborates on the information provided by the Alt Text (Accessibility) property. This property does not have a character limitation and is not required if the Alt Text (Accessibility) field sufficiently describes the video. |
Notes |
This property should not be confused with the IPTC property Description, which is the who, what, when, where, why, how of a video. This property can be combined with Alt Text (Accessibility) if and when a brief description is not sufficient to convey the purpose and meaning of a video. It should not repeat the information in the Alt Text (Accessibility) property. It is required for conformance with the W3C Web Content Accessibility Guidelines (WCAG). |
Type and cardinality |
Text + language tag (0..1) |
Change history |
New 1.4 |
XMP ID and data type |
Iptc4xmpCore:ExtDescrAccessibility (Lang Alt) |
JSON ID and data type |
extDescrAccessibility (AltLang) |
5.2.8. Featured Organisation
Property name |
Featured Organisation |
|---|---|
Definition |
Organisation(s) featured by the content of the video |
Type and cardinality |
Entity Structure (0..unbounded) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:OrganisationInImageName Iptc4xmpExt:OrganisationInImageCode (Bag Text Bag Text) |
JSON ID and data type |
featuredOrganisations (Entity//array) |
5.2.9. Genre
Property name |
Genre |
|---|---|
Definition |
Artistic, style, journalistic, product or other genre(s) of the video. |
Type and cardinality |
CV-Term Structure (0..unbounded) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:Genre (Bag CV Term structure) |
JSON ID and data type |
genres (CvTerm//array ) |
5.2.10. Headline
Property name |
*Headline * |
|---|---|
Definition |
Short description of the content of the video |
Type and cardinality |
Text + language tag (0..1) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:Headline (Lang Alt) |
JSON ID and data type |
headline (AltLang) |
5.2.11. Keywords
Property name |
Keywords |
|---|---|
Definition |
What the video is about expressed by a free choice of descriptive phrases or keywords |
Type and cardinality |
Text + language tag (0..unbounded) |
Change history |
Changed 1.4 |
XMP ID and data type |
dc:subject (Bag Lang Alt) |
JSON ID and data type |
keywords (AltLang//array) |
5.2.12. Language Version
Property name |
Language Version |
|---|---|
Definition |
Language version of the video |
Type and cardinality |
Language tag (0..1) |
Change history |
New 1.0 |
XMP ID and data type |
dc:language (Text Closed Choice) |
JSON ID and data type |
language (string//) |
5.2.13. Location Shot
Property name |
Location Shot |
|---|---|
Definition |
Place from where the video was shot, in particular where the camera was located |
Notes |
May be used multiple times for edited videos with clips shot at different locations. |
Type and cardinality |
Location Structure (0..unbounded) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:LocationCreated (Bag Location structure) |
JSON ID and data type |
locationsCreated (Location//array) |
5.2.14. Location Shown
Property name |
Location Shown |
|---|---|
Definition |
Place(s) shown by the video |
Type and cardinality |
Location Structure (0..unbounded) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:LocationShown (Bag Location structure) |
JSON ID and data type |
locationsShown (Location//array) |
5.2.15. Object Shown
Property name |
Object Shown |
|---|---|
Definition |
Object(s) shown by the video |
Type and cardinality |
Entity Structure (0..unbounded) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:ArtworkOrObject (Bag Artwork/Object structure) |
JSON ID and data type |
objectsShown (Entity//array) |
5.2.16. Person Heard
Property name |
Person Heard |
|---|---|
Definition |
Person(s) who can be heard only in the video |
Type and cardinality |
Entity Structure (0..unbounded) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:PersonHeard (Bag Entity structure) |
JSON ID and data type |
personsHeard (Entity//array) |
5.2.17. Person Shown
Property name |
Person Shown |
|---|---|
Definition |
Person(s) shown by the video |
Type and cardinality |
Entity Structure or Person Details Structure (0..unbounded) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:PersonInImageWDetails (Bag PersonWDetails structure) |
JSON ID and data type |
personsShown (PersonWDetails//array) |
5.2.18. Product Shown
Property name |
Product Shown |
|---|---|
Definition |
Product(s) identified by a GTIN code shown by the video |
Type and cardinality |
Product with GTIN Structure (0..unbounded) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:ProductInImage (Bag Product structure) |
JSON ID and data type |
productsShown (ProductWGtin//array) |
5.2.19. Shot Type
Property name |
Shot Type |
|---|---|
Definition |
Visual type(s) of the video |
Type and cardinality |
Concept Structure (0..unbounded) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:VideoShotType (Bag Entity structure) |
JSON ID and data type |
videoShotTypes (Entity//array) |
5.2.20. Shown Event
Property name |
Shown Event |
|---|---|
Definition |
Event(s) shown by the video |
Type and cardinality |
Entity Structure (0..unbounded) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:EventExt (Bag Entity structure) |
JSON ID and data type |
shownEvents (Entity//array) |
5.2.21. Snapshot Link
Property name |
Snapshot Link |
|---|---|
Definition |
A still image representing the video. |
Type and cardinality |
Linked Image Structure (0..unbounded) |
Change history |
New 1.1 |
XMP ID and data type |
Iptc4xmpExt:SnapshotLink (Bag Linked Image) |
JSON ID and data type |
snapshotLinks (LinkedImage//array) |
5.2.22. Timed Text Link
Property name |
Timed Text Link |
|---|---|
Definition |
Link(s) to an external web resource providing a timed text track, used to provide captioning/subtitling or audio description of the video |
Type and cardinality |
Qualified Link with Language Structure (0..unbounded) |
Change history |
New 1.4 |
XMP ID and data type |
Iptc4xmpExt:TimedTextLink (Bag Qualified Link with Language) |
JSON ID and data type |
timedTextLinks (QualifiedLinkWithLanguage//array) |
5.2.23. Title
Property name |
Title |
|---|---|
Definition |
Title of the video, should be a shorthand reference |
Type and cardinality |
Text + language tag (0..1) |
Change history |
Changed 1.4 |
XMP ID and data type |
dc:title (Lang Alt) |
JSON ID and data type |
title (AltLang ) |
5.2.24. Transcript
Property name |
Transcript |
|---|---|
Definition |
Transcription of the video |
Type and cardinality |
Text + language tag (0..1) |
Change history |
Changed 1.4 |
XMP ID and data type |
Iptc4xmpExt:Transcript (Lang Alt) |
JSON ID and data type |
transcript (AltLang) |
5.2.25. Transcript Link
Property name |
Transcript Link |
|---|---|
Definition |
Link(s) to an external web resource providing a transcription of the video |
Type and cardinality |
Qualified Link Structure (0..unbounded) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:TranscriptLink (Bag Qualified Link) |
JSON ID and data type |
transcriptLinks (QualifiedLink//array) |
5.2.26. Visual Colour
Property name |
Visual Colour |
|---|---|
Definition |
The visual colouring of the video. |
Notes |
Technical details of the colours are covered by … |
Type and cardinality |
Text (0..1) Enumeration: - black and white/monochrome - colour |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:VisualColour (Closed Choice - bw-monochrome - colour) |
JSON ID and data type |
visualColour (string//enum) |
5.3. Rights fields
5.3.1. Contributor
Property name |
Contributor |
|---|---|
Definition |
Party or parties (person or organisation) which contributed to the video, refinement by the role attribute. |
Notes |
A distinction between contributor and creator should follow rights laws, contracts or common business rules. Vocabulary of roles of persons contributiong to a video should be based on the use by a video or movie producer assocation. |
Type and cardinality |
Entity with role Structure (0..unbounded) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:Contributor (Bag Entity with Role structure) |
JSON ID and data type |
contributors (EntityWRole//array) |
5.3.2. Copyright Notice
Property name |
*Copyright Notice * |
|---|---|
Definition |
Any textual notice necessary by legal needs or common use to indicate the current owner of the copyright of this media resource |
Type and cardinality |
Text + language tag (0..1) |
Change history |
New 1.0 |
XMP ID and data type |
dc:rights (Lang Alt) |
JSON ID and data type |
copyrightNotice (AltLang) |
5.3.3. Copyright Year
Property name |
Copyright Year |
|---|---|
Definition |
Year of origin of the video, usually appearing in the copyright notice as a numeric value |
Type and cardinality |
Number/integer (0..1) |
Change history |
Changed 1.4 |
XMP ID and data type |
Iptc4xmpExt:CopyrightYear (number) |
JSON ID and data type |
copyrightYear (number//) |
5.3.4. Creator
Property name |
Creator |
|---|---|
Definition |
Party or parties (person or organisation) which created the video, refinement by the role attribute. |
Notes |
A distinction between creator and contributor should follow rights laws, contracts or common business rules. Vocabulary of roles of persons creating a video should be based on the use by a video or movie producer assocation. |
Type and cardinality |
Entity with role Structure (0..unbounded) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:Creator (Bag Entity with Role structure) |
JSON ID and data type |
creators (EntityWRole//array) |
5.3.5. Credit Line
Property name |
Credit Line |
|---|---|
Definition |
Credit to person(s) and/or organisation(s) required by the supplier of the video (clip) to be used when published. |
Type and cardinality |
Text (0..1) |
Change history |
New 1.0 |
XMP ID and data type |
photoshop:Credit (Text) |
JSON ID and data type |
creditLine (string//) |
5.3.6. Data Mining
Property name |
Data Mining |
|---|---|
Definition |
Data mining prohibition or permission, optionally with constraints. |
Notes |
This is a structured PLUS version 2.0 property. The value must be one of the URIs listed in the Controlled Vocabulary section of the PLUS specification for the Data Mining property. NOTE: Regional laws applying to an asset may prohibit, constrain, or allow data mining for certain purposes (such as search indexing or research), and may overrule the value selected for this property. Similarly, the absence of a prohibition does not indicate that the asset owner grants permission for data mining or any other use of an asset. The prohibition “Prohibited except for search engine indexing” only permits data mining by search engines available to the public to identify the URL for an asset and its associated data (for the purpose of assisting the public in navigating to the URL for the asset), and prohibits all other uses, such as AI/ML training. The PLUS Other Constraints property is human readable. The IPTC properties Embedded Encoded Rights Expression and Linked Encoded Rights Expression are machine readable. |
Type and cardinality |
PLUS CV Term/URI |
Change history |
New 1.5 |
XMP ID and data type |
plus:DataMining (see PLUS spec) |
JSON ID and data type |
dataMining (string/uri/) |
5.3.7. Other Constraints
Property name |
Other Constraints |
|---|---|
Definition |
Additional constraints on the use of the asset. |
Notes |
Constraints may limit the scope of usage allowed |
Type and cardinality |
Text + language tag (0..1) |
Change history |
New 1.5 |
XMP ID and data type |
plus:OtherConstraints (see PLUS spec) |
JSON ID and data type |
dataMiningConstraint ? (string//) |
5.3.8. Licensor
Property name |
*Licensor * |
|---|---|
Definition |
Company or person to be contacted for licensing |
Type and cardinality |
Entity Structure (0..1) |
Change history |
New 1.0 |
XMP ID and data type |
plus:Licensor (see PLUS spec) |
JSON ID and data type |
licensor (Entity) |
5.3.9. Model Release Document
Property name |
Model Release Document |
|---|---|
Definition |
Identifier(s) of a Model Release document. |
Type and cardinality |
Text (0..unbounded) |
Change history |
New 1.0 |
XMP ID and data type |
plus:ModelReleaseID (see PLUS spec) |
JSON ID and data type |
modelReleaseDocuments (string//array) |
5.3.10. Model Release Status
Property name |
Model Release Status |
|---|---|
Definition |
Summarises the availability and scope of model releases authorizing usage of the likenesses of persons appearing in the video |
Type and cardinality |
PLUS CV Term/URI |
Change history |
New 1.0 |
XMP ID and data type |
plus:ModelReleaseStatus (see PLUS spec) |
JSON ID and data type |
modelReleaseStatus (CvTerm) |
5.3.11. Property Release Document
Property name |
Property Release Document |
|---|---|
Definition |
Identifier(s) of a Property Release document. |
Type and cardinality |
Text (0..unbounded) |
Change history |
New 1.0 |
XMP ID and data type |
plus:PropertyReleaseID (see PLUS spec) |
JSON ID and data type |
propertyReleaseDocuments (string//array) |
5.3.12. Property Release Status
Property name |
Property Release Status |
|---|---|
Definition |
Summarises the availability and scope of property releases authorising usage of the properties appearing in the photograph. |
Type and cardinality |
PLUS CV Term/URI |
Change history |
New 1.0 |
XMP ID and data type |
plus:PropertyReleaseStatus (see PLUS spec) |
JSON ID and data type |
propertyReleaseStatus (CvTerm) |
5.3.13. Embedded Encoded Rights Expression
Property name |
Embedded Encoded Rights Expression |
|---|---|
Definition |
Structure covering the assertion of rights, the granting of licenses and both in human and a machine readable ways (including restrictions, embargoes, duties …) |
Notes |
Embedded rights expression can cover only machine readable expression. |
Type and cardinality |
Embedded Encoded Rights Expression Structure (0..unbounded) |
Change history |
Changed 1.4 |
XMP ID and data type |
Iptc4xmpExt:EmbdEncRightsExpr (Bag Embedded Encoded Rights Expression structure) |
JSON ID and data type |
embdEncRightsExpr (EmbdEncRightsExpr//array) |
5.3.14. Linked Encoded Rights Expression
Property name |
Linked Encoded Rights Expression |
|---|---|
Definition |
Structure covering the assertion of rights, the granting of licenses and both in human and a machine readable ways (including restrictions, embargoes, duties …) |
Notes |
Embedded rights expression can cover only machine readable expression. |
Type and cardinality |
Linked Encoded Rights Expression Structure (0..unbounded) |
Change history |
Changed 1.4 |
XMP ID and data type |
Iptc4xmpExt:LinkedEncRightsExpr (Bag Linked Encoded Rights Expression structure) |
JSON ID and data type |
linkedEncRightsExpr (LinkedEncRightsExpr//array) |
5.3.15. Copyright Owner
Property name |
*Copyright Owner * |
|---|---|
Definition |
Data identifying the individual or organisation owning the rights for this media resource which could be the video as a whole or a clip in a video. The optional role attribute may indicate which facet of rights is covered by this entity. |
Type and cardinality |
Entity with role (0..unbounded) |
Change history |
Changed 1.4 |
XMP ID and data type |
plus:CopyrightOwner (see PLUS spec) |
JSON ID and data type |
copyrightOwners (EntityWRole//array) |
5.3.16. Supplier
Property name |
*Supplier * |
|---|---|
Definition |
Supplier of this copy of the media resource |
Type and cardinality |
Entity Structure (0..1) |
Change history |
New 1.0 |
XMP ID and data type |
plus:ImageSupplier (see PLUS spec) |
JSON ID and data type |
supplier (Entity) |
5.3.17. Source (Supply Chain)
Property name |
Source (Supply Chain) |
|---|---|
Definition |
Person or party who has a role in the content supply chain. |
Type and cardinality |
Text (0..1) |
Change history |
Changed 1.4 |
XMP ID and data type |
photoshop:Source (Text) |
JSON ID and data type |
supplyChainSources (Entity//array) |
5.4. Technical fields
5.4.1. Audio Bitrate
Property name |
Audio Bitrate |
|---|---|
Definition |
Bit rate of the audio data depending on the Video Bit Rate Type: if fixed the fixed rate, if variable the maximum rate. The unit is bits per second. |
Type and cardinality |
Number (0..1) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:audioBitRate (Integer) |
JSON ID and data type |
audioBitRate (number//) |
5.4.2. Audio Bitrate Type
Property name |
Audio Bitrate Type |
|---|---|
Definition |
Indicates if the bitrate of the audio data is fixed or variable |
Type and cardinality |
Text (0..1) Enumeration - fixed - variable |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:audioBitRateMode (Closed Choice Text - fixed - variable) |
JSON ID and data type |
audioBitRateType (string//enum) |
5.4.3. Audio Bits per Sample
Property name |
Audio Bits per Sample |
|---|---|
Definition |
Number of bits used for an audio sample |
Type and cardinality |
Number (0..1) |
Change history |
New 1.2 |
XMP ID and data type |
Iptc4xmpExt:audioBitsPerSample (Integer) |
JSON ID and data type |
audioBitsPerSample (number//) |
5.4.4. Audio Channel Layout
Property name |
Audio Channel Layout |
|---|---|
Definition |
Term indicating the channel layout |
Type and cardinality |
Text (0..1) |
Change history |
New 1.0 |
XMP ID and data type |
xmpDM:audioChannelType (Closed Choice Text) |
JSON ID and data type |
audioChannelLayout (string//) |
5.4.5. Audio Channels
Property name |
Audio Channels |
|---|---|
Definition |
Number of used audio channels |
Type and cardinality |
Number (0..1) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:audioChannelCount (Closed Choice or Integer) |
JSON ID and data type |
audioChannelCount (number//) |
5.4.6. Audio Coding
Property name |
Audio Coding |
|---|---|
Definition |
Machine readable code and a human readable term for the used audio coding |
Type and cardinality |
Entity Structure (0..1) |
Change history |
New 1.0 |
XMP ID and data type |
xmpDM:audioCompressor (Text) |
JSON ID and data type |
audioCoding (Entity) |
5.4.7. Audio Sample Rate
Property name |
Audio Sample Rate |
|---|---|
Definition |
Rate used for sampling the audio |
Type and cardinality |
Number (0..1) |
Change history |
New 1.0 |
XMP ID and data type |
xmpDM:audioSampleRate (Rational) |
JSON ID and data type |
audioSampleRate (number//) |
5.4.8. Display Aspect Ratio
Property name |
Display Aspect Ratio |
|---|---|
Definition |
Ratio of width and height of the displayed image. (Width and height do not require to be in pixels.) |
Notes |
e.g. 2.39:1 |
Type and cardinality |
Text (0..1) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:videoDisplayAspectRatio (Rational) |
JSON ID and data type |
videoDisplayAspectRatio (string//) |
5.4.9. Editorial Duration
Property name |
Editorial Duration |
|---|---|
Definition |
Duration of the video content proposed for editorial use |
Notes |
Multiple occurrences should be used for the same value in different time formats |
Type and cardinality |
Video Time Structure (0..unbounded) |
Change history |
New 1.0 |
XMP ID and data type |
xmpDM:markers[xmpDM:type= "ivqu:editorialDuration"] /xmpDM:startTime + /xmpDM:duration (Marker) |
JSON ID and data type |
editorialDurations (VideoTime//array ) |
5.4.10. Editorial Duration End
Property name |
Editorial Duration End |
|---|---|
Definition |
The point in time and frames the content proposed for editorial use ends |
Notes |
Multiple occurrences should be used for the same value in different time formats |
Type and cardinality |
Video Time Structure (0..unbounded) |
Change history |
New 1.0 |
XMP ID and data type |
xmpDM:markers[xmpDM:type= "ivqu:editorialDurationEnd"] /xmpDM:startTime (Marker) |
JSON ID and data type |
editorialDurationEnds (VideoTime//array ) |
5.4.11. Editorial Duration Start
Property name |
Editorial Duration Start |
|---|---|
Definition |
The point in time and frames the content proposed for editorial use starts |
Notes |
Multiple occurrences should be used for the same value in different time formats |
Type and cardinality |
Video Time Structure (0..unbounded) |
Change history |
New 1.0 |
XMP ID and data type |
xmpDM:markers[xmpDM:type= "ivqu:editorialDurationStart"] /xmpDM:startTime (Marker) |
JSON ID and data type |
editorialDurationStarts (VideoTime//array ) |
5.4.12. File Bitrate
Property name |
File Bitrate |
|---|---|
Definition |
The total bit rate of the all media streams in this file. |
Type and cardinality |
Number (0..1) |
Change history |
New 1.0 |
XMP ID and data type |
xmpDM:fileDataRate (Rational) |
JSON ID and data type |
fileBitrate (number//) |
5.4.13. File Duration
Property name |
File Duration |
|---|---|
Definition |
Duration of the overall video (from the first to the last frame) |
Notes |
Multiple occurrences should be used for the same value in different time formats |
Type and cardinality |
Video Time Structure (0..1) |
Change history |
New 1.0 |
XMP ID and data type |
xmpDM:duration (Time) |
JSON ID and data type |
fileDuration (VideoTime) |
5.4.14. File Format
Property name |
File Format |
|---|---|
Definition |
Format of the file containing the video data. |
Type and cardinality |
Entity Structure (0..1) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:ContainerFormat (Entity structure) |
JSON ID and data type |
fileFormat (Entity) |
5.4.15. Frame Size
Property name |
Frame Size |
|---|---|
Definition |
Size of the video frame in pixels |
Type and cardinality |
Frame Size Structure (0..1) |
Change history |
New 1.0 |
XMP ID and data type |
xmpDM:videoFrameSize (Dimensions) |
JSON ID and data type |
frameSize (FrameSize) |
5.4.16. Media Type
Property name |
Media Type |
|---|---|
Definition |
IANA Media Type of the video. |
Notes |
e.g. "video/quicktime" |
Type and cardinality |
Text (0..1) |
Change history |
New 1.0 |
XMP ID and data type |
dc:format (MIMEType) |
JSON ID and data type |
mediaType (string//) |
5.4.17. Orientation
Property name |
Orientation |
|---|---|
Definition |
Orientation of the visual content of the video as defined by TIFF. |
Type and cardinality |
Number (0..1) (TIFF 6.0 orientation - with a user guideline ("no flips")) |
Change history |
New 1.0 |
XMP ID and data type |
tiff:orientation (Closed Choice of Integer) |
JSON ID and data type |
orientation (number//) |
5.4.18. Signal Aspect Ratio
Property name |
Signal Aspect Ratio |
|---|---|
Definition |
Ratio of width and height in pixels of a frame |
Notes |
e.g. 16:9 |
Type and cardinality |
Text (0..1) |
Change history |
New 1.0 |
XMP ID and data type |
xmpDM:videoPixelAspectRatio (Rational) |
JSON ID and data type |
signalAspectRatio (string//) |
5.4.19. Signal Format
Property name |
Signal Format |
|---|---|
Definition |
Combined term including the size of the frame, interlaced/progressive, framerate |
Notes |
e.g. "1080p" |
Type and cardinality |
Text (0..1) |
Change history |
New 1.0 |
XMP ID and data type |
xmpDM:videoFieldOrder (Text) |
JSON ID and data type |
signalFormat (string//) |
5.4.20. Stream-ready
Property name |
Stream-ready |
|---|---|
Definition |
Indicates if this video can be used for streaming by the rule of having the key technical data of the video at the start rather than end of the file and that the wrapper and essense format are suitable for streaming |
Type and cardinality |
Text (0..1) Enumeration: - true - false - unknown |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:StreamReady (Closed Choice of Text - true - false - unknown) |
JSON ID and data type |
streamReady (string//enum) |
5.4.21. Video Bitrate
Property name |
Video Bitrate |
|---|---|
Definition |
Bit rate of the video data depending on the Video Bit Rate Type: if fixed the fixed rate, if variable the maximum rate. The unit is bits per second. |
Type and cardinality |
Number (0..1) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:videoBitRate (Integer) |
JSON ID and data type |
videoBitrate (number//) |
5.4.22. Video Bitrate Type
Property name |
Video Bitrate Type |
|---|---|
Definition |
Indicates if the bitrate of the video data is fixed or variable |
Type and cardinality |
Text (0..1) Enumeration - fixed - variable |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:videoBitRateMode (Closed Choice Text - fixed - variable) |
JSON ID and data type |
videoBitrateType (string//enum) |
5.4.23. Video Coding
Property name |
Video Coding |
|---|---|
Definition |
Machine readable code and a human readable term for the used video coding |
Type and cardinality |
Entity Structure (0..1) |
Change history |
New 1.0 |
XMP ID and data type |
xmpDM:videoCompressor (Text) |
JSON ID and data type |
videoCoding (Entity) |
5.4.24. Video Frame Rate
Property name |
Video Frame Rate |
|---|---|
Definition |
Used frame rate |
Type and cardinality |
Number (0..1) |
Change history |
New 1.0 |
XMP ID and data type |
xmpDM:videoFrameRate (Real) |
JSON ID and data type |
videoFrameRate (number//) |
5.4.25. Video Profile
Property name |
Video Profile |
|---|---|
Definition |
Name of the used video profile as defined by the maker of the encoding standard. |
Notes |
e.g. "High 4:2:2" |
Type and cardinality |
Text (0..1) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:videoEncodingProfile (Text) |
JSON ID and data type |
videoEncodingProfile (string//) |
5.4.26. Video Streams Count
Property name |
Video Streams Count |
|---|---|
Definition |
Count of video streams in a video file. |
Type and cardinality |
Number (0..1) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:videoStreamsCount (Integer) |
JSON ID and data type |
videoStreamsCount (number//) |
5.5. Time marker
5.5.1. Markers
Property name |
Markers |
|---|---|
Definition |
A marker describes a location in an audio or video sequence. It is used to identify for which part of the video (a clip of the video as a whole) a set of IPTC Video Metadata properties is used. |
Type and cardinality |
XMP specific type |
Change history |
New 1.0 |
XMP ID and data type |
xmpDM:markers (Marker) |
JSON ID and data type |
NA (NA) |
6. Property Structures
This section describes the structures used in the above properties. Some properties are single-valued and have a simple datatype suich as "string". Others have a more complex structure with nested values. These types are sometimes shared between more than one property. They are documented below.
6.1. Concept Structure
6.1.1. Identifier
Property name |
Identifier |
|---|---|
Definition |
Globally unique identifier of the concept |
Type and cardinality |
Text/URI (0..unbounded) |
Change history |
New 1.0 |
XMP ID and data type |
xmp:Identifier (Bag Text) |
JSON ID and data type |
identifiers (string/uri/array) |
6.1.2. Name
Property name |
Name |
|---|---|
Definition |
Full name of the concept |
Type and cardinality |
Text + language tag (0..1) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:Name (Lang Alt) |
JSON ID and data type |
name (AltLang ) |
6.2. Concept with role Structure
6.2.1. Identifier
Property name |
Identifier |
|---|---|
Definition |
Globally unique identifier of the concept |
Type and cardinality |
Text/URI (0..unbounded) |
Change history |
New 1.0 |
XMP ID and data type |
xmp:Identifier (Bag Text) |
JSON ID and data type |
identifiers (string/uri/array) |
6.2.2. Name
Property name |
Name |
|---|---|
Definition |
Full name of the concept |
Type and cardinality |
Text + language tag (0..1) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:Name (Lang Alt) |
JSON ID and data type |
name (AltLang ) |
6.2.3. Role
Property name |
Role |
|---|---|
Definition |
Identifier of the role the concept has in the context of the metadata property |
Type and cardinality |
URI (0..unbounded) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:Role (Bag URI) |
JSON ID and data type |
role (string/uri/array) |
6.3. CV-Term Structure
Used in: Genre
6.3.1. CV-Term CV ID
Property name |
CV-Term CV ID |
|---|---|
Definition |
Globally unique identifier of the Controlled Vocabulary the term is from. |
Type and cardinality |
Text/URI (0..1) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:CvId (URI) |
JSON ID and data type |
cvId (string/uri/) |
6.3.2. CV-Term ID
Property name |
CV-Term ID |
|---|---|
Definition |
Globally unique identifier of the term from a Controlled Vocabulary. |
Type and cardinality |
Text/URI (1) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:CvTermId (URI) |
JSON ID and data type |
cvTermId (string/uri/-MANDATORY) |
6.3.3. CV-Term name
Property name |
CV-Term name |
|---|---|
Definition |
Natural language name of the term from a Controlled Vocabulary. |
Type and cardinality |
Text + language tag (0..1) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:CvTermName (LangAlt) |
JSON ID and data type |
cvTermName (AltLang) |
6.3.4. Refined 'aboutness' of the CV-Term
Property name |
Refined 'aboutness' of the CV-Term |
|---|---|
Definition |
Refinement of the 'about' relationship of the term with the content. |
Notes |
E.g. an identifier for "shown emotion" could be used to indicate that the CV-Term covers this facet. |
Type and cardinality |
Text/URI (0..1) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:CvTermRefinedAbout (URI) |
JSON ID and data type |
cvTermRefinedAbout (string/uri/) |
6.4. Device Structure
Used in: Recording Device
6.4.1. Manufacturer
Property name |
Manufacturer |
|---|---|
Definition |
Name of the manufacturer of the device |
Type and cardinality |
Text (0..1) |
Change history |
New 1.2 |
XMP ID and data type |
Iptc4xmpExt:Manufacturer (Text) |
JSON ID and data type |
manufacturer (string//) |
6.4.2. Model Name
Property name |
Model Name |
|---|---|
Definition |
Name of the device model |
Type and cardinality |
Text (0..1) |
Change history |
New 1.2 |
XMP ID and data type |
Iptc4xmpExt:ModelName (Text) |
JSON ID and data type |
modelName (string//) |
6.4.3. Serial Number
Property name |
Serial Number |
|---|---|
Definition |
Serial number, assigned by manufacturer |
Type and cardinality |
Text (0..1) |
Change history |
New 1.2 |
XMP ID and data type |
Iptc4xmpExt:SerialNumber (Text) |
JSON ID and data type |
serialNumber (string//) |
6.4.4. Attached Lens Description
Property name |
Attached Lens Description |
|---|---|
Definition |
Short description of the lens used with the device at the time of the recording |
Type and cardinality |
Text (0..1) |
Change history |
New 1.2 |
XMP ID and data type |
Iptc4xmpExt:AttLensDescription (Text) |
JSON ID and data type |
attLensDescription (string//) |
6.4.5. Owner´s Device ID
Property name |
Owner´s Device ID |
|---|---|
Definition |
Identifier assigned by the owner of the device |
Type and cardinality |
Text (0..1) |
Change history |
New 1.2 |
XMP ID and data type |
Iptc4xmpExt:OwnersDeviceId (Text) |
JSON ID and data type |
ownerDeviceId (string//) |
6.5. Embedded Encoded Rights Expression Structure
Used in: Embedded Encoded Rights Expression
6.5.1. Rights Expression Language ID
Property name |
Rights Expression Language ID |
|---|---|
Definition |
Identifier of the rights expression language used by the rights expression. |
Type and cardinality |
Text/URI (1) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:RightsExprLangId (URI) |
JSON ID and data type |
rightsExprLangId (string/uri/-MANDATORY) |
6.5.2. Encoding type
Property name |
Encoding type |
|---|---|
Definition |
Encoding type of the rights expression, identified by an IANA Media Type. |
Type and cardinality |
Text (1) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:RightsExprEncType (MIMEtype) |
JSON ID and data type |
rightsExprEncType (string//-MANDATORY) |
6.5.3. Encoded Rights Expression
Property name |
Encoded Rights Expression |
|---|---|
Definition |
Embedded serialized rights expression using a rights expression language which is encoded as a string. |
Type and cardinality |
Text (1) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:EncRightsExpr (Text) |
JSON ID and data type |
encRightsExpr (string//-MANDATORY) |
6.6. Entity Structure
Used in: Metadata Editor, Metadata Authority, Featured Organisation, Object Shown, Person Heard, Person Shown, Shown Event, Licensor , Supplier , Audio Coding, File Format, Video Coding
6.6.1. Identifier
Property name |
Identifier |
|---|---|
Definition |
Globally unique identifier of the entity |
Type and cardinality |
Text/URI (0..unbounded) |
Change history |
New 1.0 |
XMP ID and data type |
xmp:Identifier (Bag Text) |
JSON ID and data type |
identifiers (string/uri/array) |
6.6.2. Name
Property name |
Name |
|---|---|
Definition |
Full name of the entity |
Type and cardinality |
Text + language tag (0..1) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:Name (Lang Alt) |
JSON ID and data type |
name (AltLang ) |
6.7. Entity with role Structure
Used in: Planning Reference, Contributor, Creator
6.7.1. Identifier
Property name |
Identifier |
|---|---|
Definition |
Globally unique identifier of the entity |
Type and cardinality |
Text/URI (0..unbounded) |
Change history |
New 1.0 |
XMP ID and data type |
xmp:Identifier (Bag Text) |
JSON ID and data type |
identifiers (string/uri/array) |
6.7.2. Name
Property name |
Name |
|---|---|
Definition |
Full name of the entity |
Type and cardinality |
Text + language tag (0..1) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:Name (Lang Alt) |
JSON ID and data type |
name (AltLang ) |
6.7.3. Role
Property name |
Role |
|---|---|
Definition |
Identifier of the role the entity has in the context of the metadata property |
Type and cardinality |
Text (0..unbounded) |
Change history |
Changed 1.4 |
XMP ID and data type |
Iptc4xmpExt:Role (Bag Text) |
JSON ID and data type |
role (string//array) |
6.8. Episode/Season Structure
6.8.1. Name
Property name |
Name |
|---|---|
Definition |
Name of the episode or season of a series |
Type and cardinality |
Text + language tag (0..1) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:Name (Text) |
JSON ID and data type |
name (AltLang) |
6.8.2. Number
Property name |
Number |
|---|---|
Definition |
Number of the episode or season of a series |
Type and cardinality |
Integer (0..1) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:Number (Text) |
JSON ID and data type |
number (number//) |
6.8.3. Identifier
Property name |
Identifier |
|---|---|
Definition |
Identifier of the episode or season of a series |
Type and cardinality |
URI (0..1) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:Identifier (URI) |
JSON ID and data type |
identifier (string/uri/) |
6.9. Frame Size Structure
Used in: Frame Size
6.9.1. Width
Property name |
Width |
|---|---|
Definition |
Width of the video frame in pixels |
Type and cardinality |
Number (1) |
Change history |
New 1.0 |
XMP ID and data type |
stDim:w (integer) |
JSON ID and data type |
widthPixels (number//) |
6.9.2. Height
Property name |
Height |
|---|---|
Definition |
Height of the video frame in pixels |
Type and cardinality |
Number (1) |
Change history |
New 1.0 |
XMP ID and data type |
stDim:h (integer) |
JSON ID and data type |
heightPixels (number//) |
6.9.3. Measure Unit
Property name |
Measure Unit |
|---|---|
Definition |
Units of width and height values, fixed value "pixels" |
Type and cardinality |
Text(1) |
Change history |
New 1.0 |
XMP ID and data type |
stDim:unit (Text) |
JSON ID and data type |
unitPixels (string//) |
6.10. Linked Encoded Rights Expression Structure
Used in: Linked Encoded Rights Expression
6.10.1. Rights Expression Language ID
Property name |
Rights Expression Language ID |
|---|---|
Definition |
Identifier of the rights expression language used by the rights expression. |
Type and cardinality |
Text/URI (1) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:RightsExprLangId (URI) |
JSON ID and data type |
rightsExprLangId (string/uri/-MANDATORY) |
6.10.2. Encoding type
Property name |
Encoding type |
|---|---|
Definition |
Encoding type of the rights expression, identified by an IANA Media Type. |
Type and cardinality |
Text (0..1) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:RightsExprEncType (MIMEtype) |
JSON ID and data type |
rightsExprEncType (string//-MANDATORY) |
6.10.3. Link to Encoded Rights Expression
Property name |
Link to Encoded Rights Expression |
|---|---|
Definition |
Link to a rights expression using a rights expression language. |
Type and cardinality |
URL (1) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:LinkedRightsExpr (Text/URL) |
JSON ID and data type |
linkedRightsExpr (string/uri/-MANDATORY) |
6.11. Linked Image Structure
Used in: Snapshot Link
6.11.1. Image Link
Property name |
Image Link |
|---|---|
Definition |
Link URL locating the image resource |
Type and cardinality |
URL (1) |
Change history |
New 1.1 |
XMP ID and data type |
Iptc4xmpExt:Link (URL) |
JSON ID and data type |
link (string/uri/) |
6.11.2. Image Qualifier
Property name |
Image Qualifier |
|---|---|
Definition |
Qualifier of the relationship of the image with the video |
Type and cardinality |
URI (0..unbounded) |
Change history |
New 1.1 |
XMP ID and data type |
Iptc4xmpExt:LinkQualifier (Bag URI) |
JSON ID and data type |
linkQualifiers (string/uri/array) |
6.11.3. Image Role
Property name |
Image Role |
|---|---|
Definition |
Role of this image in the context of the video |
Type and cardinality |
Text (0..1) |
Change history |
New 1.1 |
XMP ID and data type |
Iptc4xmpExt:ImageRole (Text) |
JSON ID and data type |
role (string//) |
6.11.4. Media Type
Property name |
Media Type |
|---|---|
Definition |
IANA Media (MIME) Type |
Type and cardinality |
Text (0..1) |
Change history |
New 1.1 |
XMP ID and data type |
dc:format () |
JSON ID and data type |
mediaType (string//) |
6.11.5. Image Width
Property name |
Image Width |
|---|---|
Definition |
Width of the image, in pixels |
Type and cardinality |
Integer (0..1) |
Change history |
New 1.1 |
XMP ID and data type |
Iptc4xmpExt:WidthPixels (integer) |
JSON ID and data type |
widthPixels (number//) |
6.11.6. Image Height
Property name |
Image Height |
|---|---|
Definition |
Height of the image, in pixels |
Type and cardinality |
Integer (0..1) |
Change history |
New 1.1 |
XMP ID and data type |
Iptc4xmpExt:HeightPixels (integer) |
JSON ID and data type |
heightPixels (number//) |
6.11.7. Used Video Frame
Property name |
Used Video Frame |
|---|---|
Definition |
Frame of the video used for this still image. |
Type and cardinality |
Video Time Structure (0..1) |
Change history |
New 1.1 |
XMP ID and data type |
Iptc4xmpExt:UsedVideoFrame (Video Time) |
JSON ID and data type |
usedVideoFrame (VideoTime) |
6.12. Location Structure
Used in: Location Shot, Location Shown
6.12.1. Identifier
Property name |
Identifier |
|---|---|
Definition |
Globally unique identifier of the location |
Type and cardinality |
Text/URI (0..unbounded) |
Change history |
New 1.0 |
XMP ID and data type |
xmp:Identifier (Bag Text) |
JSON ID and data type |
identifiers (string/uri/array) |
6.12.2. Name
Property name |
Name |
|---|---|
Definition |
Full name of the location |
Type and cardinality |
Text + language tag (0..1) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:LocationName (Lang Alt) |
JSON ID and data type |
name (AltLang) |
6.12.3. Sublocation name
Property name |
Sublocation name |
|---|---|
Definition |
Name of a sub location the Location is located in |
Type and cardinality |
Text + language tag (0..1) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:Sublocation (Text) |
JSON ID and data type |
sublocation (AltLang ) |
6.12.4. City name
Property name |
City name |
|---|---|
Definition |
Name of the city the Location is located in |
Type and cardinality |
Text + language tag (0..1) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:City (Text) |
JSON ID and data type |
city (AltLang ) |
6.12.5. State/Province name
Property name |
State/Province name |
|---|---|
Definition |
Name of the state or province the Location is located in |
Type and cardinality |
Text + language tag (0..1) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:ProvinceState (Text) |
JSON ID and data type |
provinceState (AltLang ) |
6.12.6. Country name
Property name |
Country name |
|---|---|
Definition |
Name of the country the Location is located in |
Type and cardinality |
Text + language tag (0..1) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:CountryName (Text) |
JSON ID and data type |
countryName (AltLang ) |
6.12.7. Country ISO code
Property name |
Country ISO code |
|---|---|
Definition |
ISO code of the country the Location is located in |
Type and cardinality |
Text + language tag (0..1) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:CountryCode (Text) |
JSON ID and data type |
countryCode (string//) |
6.12.8. World region name
Property name |
World region name |
|---|---|
Definition |
Name of the world region the Location is located in |
Type and cardinality |
Text + language tag (0..1) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:WorldRegion (Text) |
JSON ID and data type |
worldRegion (AltLang ) |
6.12.9. GPS-Longitude
Property name |
GPS-Longitude |
|---|---|
Definition |
Longitude of a WGS84 based position of this Location |
Type and cardinality |
Number/decimal (0..1) |
Change history |
New 1.0 |
XMP ID and data type |
exif:GPSLongitude (Exif GPSCoordinate) |
JSON ID and data type |
gpsLongitude (number//) |
6.12.10. GPS-Latitude
Property name |
GPS-Latitude |
|---|---|
Definition |
Latitude of a WGS84 based position of this Location |
Type and cardinality |
Number/decimal (0..1) |
Change history |
New 1.0 |
XMP ID and data type |
exif:GPSLatitude (Exif GPSCoordinate) |
JSON ID and data type |
gpsLatitude (number//) |
6.12.11. GPS-Altitude
Property name |
GPS-Altitude |
|---|---|
Definition |
Altitude in meters of a WGS84 based position of this Location |
Type and cardinality |
Number/decimal (0..1) |
Change history |
New 1.0 |
XMP ID and data type |
exif:GPSAltitude (Exif Rational) |
JSON ID and data type |
gpsAltitude (number//) |
6.13. Person Details Structure
6.13.1. Identifier
Property name |
Identifier |
|---|---|
Definition |
Globally unique identifier of the person |
Type and cardinality |
Text/URI (0..unbounded) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:PersonId (Bag URI) |
JSON ID and data type |
identifiers (string/uri/array) |
6.13.2. Name
Property name |
Name |
|---|---|
Definition |
Name of the person |
Type and cardinality |
Text + language tag (0..1) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:PersonName (Lang Alt) |
JSON ID and data type |
name (AltLang) |
6.13.3. Description
Property name |
Description |
|---|---|
Definition |
A textual description of the person |
Type and cardinality |
Text + language tag (0..1) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:PersonDescription (Lang Alt) |
JSON ID and data type |
description (AltLang) |
6.13.4. Characteristics
Property name |
Characteristics |
|---|---|
Definition |
A property or trait of the person |
Type and cardinality |
Concept Structure (0..unbounded) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:PersonCharacteristic (Bag CV-Term structure) |
JSON ID and data type |
characteristics (CvTerm//array) |
6.14. Product with GTIN Structure
Used in: Product Shown
6.14.1. GTIN
Property name |
GTIN |
|---|---|
Definition |
A 14 digit GTIN (Global Trade Item Number) of the product (GTIN-8 to GTIN-14 codes are used). |
Type and cardinality |
Text (1) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:ProductGTIN (Text) |
JSON ID and data type |
gtin (string//-MANDATORY) |
6.14.2. Name
Property name |
Name |
|---|---|
Definition |
Name of the product. |
Type and cardinality |
Text + language tag (0..1) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:ProductName (Lang Alt) |
JSON ID and data type |
name (AltLang) |
6.14.3. Description
Property name |
Description |
|---|---|
Definition |
A textual description of the product. |
Type and cardinality |
Text + language tag (0..1) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:ProductDescription (Lang Alt) |
JSON ID and data type |
description (AltLang) |
6.15. Publication Event Structure
Used in: Publication Event
6.15.1. Publication Date
Property name |
Publication Date |
|---|---|
Definition |
Date and optionally the time of publishing the video |
Type and cardinality |
Date (1) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:Date (Date) |
JSON ID and data type |
date (string/date-time/-MANDATORY) |
6.15.2. Publication Event Name
Property name |
Publication Event Name |
|---|---|
Definition |
Name of the event for publishing this video. |
Notes |
The name may include the broadcasting company, the country, if this is a (regional) first publication etc |
Type and cardinality |
Text + language tag (0..1) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:Name (Text) |
JSON ID and data type |
name (AltLang) |
6.15.3. Publication Event Identifier
Property name |
Publication Event Identifier |
|---|---|
Definition |
Identifier of the event for publishing this video |
Type and cardinality |
URI (0..1) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:Identifier (URI) |
JSON ID and data type |
identifier (string/uri/) |
6.16. Qualified Link Structure
Used in: Dopesheet Link, Transcript Link
6.16.1. Link
Property name |
Link |
|---|---|
Definition |
URL of the link |
Type and cardinality |
URL (1) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:Link (URL) |
JSON ID and data type |
link (string/uri/) |
6.16.2. Qualifier
Property name |
Qualifier |
|---|---|
Definition |
Term qualifying the use of the link |
Type and cardinality |
URI (0..1) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:LinkQualifier (URI) |
JSON ID and data type |
linkQualifier (string/uri/) |
6.17. Qualified Link with Language Structure
Used in: Timed Text Link
6.17.1. Link
Property name |
Link |
|---|---|
Definition |
URL of the link |
Type and cardinality |
URL (1) |
Change history |
New 1.4 |
XMP ID and data type |
Iptc4xmpExt:Link (URL) |
JSON ID and data type |
link (string/uri/) |
6.17.2. Qualifier
Property name |
Qualifier |
|---|---|
Definition |
Term qualifying the use of the link |
Type and cardinality |
URI (0..1) |
Change history |
New 1.4 |
XMP ID and data type |
Iptc4xmpExt:LinkQualifier (URI) |
JSON ID and data type |
linkQualifier (string/uri/) |
6.17.3. Language
Property name |
Language |
|---|---|
Definition |
Language of the content at the link location |
Type and cardinality |
Text (0..1) |
Change history |
New 1.4 |
XMP ID and data type |
Iptc4xmpExt:LinkLanguage (Text) |
JSON ID and data type |
linkLanguage (string//) |
6.18. Rating Structure
Used in: Rating, Review Rating, Workflow Rating
6.18.1. Rating Value
Property name |
Rating Value |
|---|---|
Definition |
Rating value as issued by the rating source |
Type and cardinality |
Text (1) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:RatingValue (Text) |
JSON ID and data type |
ratingValue (string//-MANDATORY) |
6.18.2. Rating Source Link
Property name |
Rating Source Link |
|---|---|
Definition |
Link to the site and optionally the page of the party which has issued the rating value, linked resource should explain the rating rules. |
Type and cardinality |
URL (1) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:RatingSourceLink (Text (URI)) |
JSON ID and data type |
ratingSourceLink (string/uri/-MANDATORY) |
6.18.3. Rating Scale Min Value
Property name |
Rating Scale Min Value |
|---|---|
Definition |
The value of the rating scale used for the lowest/worst rating |
Type and cardinality |
Text (0..1) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:RatingScaleMinValue (Text) |
JSON ID and data type |
ratingScaleMinValue (string//) |
6.18.4. Rating Scale Max Value
Property name |
Rating Scale Max Value |
|---|---|
Definition |
The value of the rating scale used for the highest/best rating |
Type and cardinality |
Text (0..1) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:RatingScaleMaxValue (Text) |
JSON ID and data type |
ratingScaleMaxValue (string//) |
6.18.5. Rating Value Logo
Property name |
Rating Value Logo |
|---|---|
Definition |
Visualisation of the rating value referenced by a link |
Type and cardinality |
URL (0..1) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:RatingValueLogoLink (Text (URL)) |
JSON ID and data type |
ratingValueLogoLink (string/uri/) |
6.18.6. Rating Region
Property name |
Rating Region |
|---|---|
Definition |
Geopolitical region to which this rating applies. |
Type and cardinality |
[Location Entity Structure] (0..unbounded) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:RatingRegion (Bag Location structure) |
JSON ID and data type |
ratingRegions (Location//array) |
6.19. Registry Entry Structure
Used in: Registry Entry
6.19.1. Asset Identifier
Property name |
Asset Identifier |
|---|---|
Definition |
Unique identifier of the video as issued by a registry |
Notes |
This value shall not be changed after being applied. |
Type and cardinality |
Text (preferred: URI) (1) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:RegItemId (Text) |
JSON ID and data type |
assetIdentifier (string//-MANDATORY) |
6.19.2. Registry Identifier
Property name |
Registry Identifier |
|---|---|
Definition |
An identifier for the registry which issued the identifier of the video. |
Type and cardinality |
Text (preferred: URI) (1) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:RegOrgId (Text) |
JSON ID and data type |
registryIdentifier (string/uri/-MANDATORY) |
6.19.3. Role
Property name |
Role |
|---|---|
Definition |
An identifier of the reason and/or purpose for this Registry Entry. |
Notes |
Could indicated e.g. "Id of the previous supplier", "Id of the original copyright owner", "Id used by the archive", etc |
Type and cardinality |
Text/URI (0..1) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:RegEntryRole (Text) |
JSON ID and data type |
role (string/uri/) |
6.20. Series Structure
Used in: Series
6.20.1. Series name
Property name |
Series name |
|---|---|
Definition |
Name of the series |
Type and cardinality |
Text + language tag (0..1) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:Name (Text) |
JSON ID and data type |
name (AltLang) |
6.20.2. Series identifier
Property name |
Series identifier |
|---|---|
Definition |
Identifier for the series |
Type and cardinality |
URI (0..1) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:Identifier (URI) |
JSON ID and data type |
identifier (string/uri/) |
6.21. Temporal Coverage Structure
Used in: Temporal Coverage
6.21.1. From Date
Property name |
From Date |
|---|---|
Definition |
Optionally truncated date when the temporal coverage starts |
Notes |
Truncated date means: the date value can be year + month + day OR year + month OR year only |
Type and cardinality |
Date(1) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:tempCoverageFrom (Date) |
JSON ID and data type |
tempCoverageFrom (string/date-time/) |
6.21.2. To Date
Property name |
To Date |
|---|---|
Definition |
Optionally truncated date when the temporal coverage ends |
Type and cardinality |
Date(1) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:tempCoverageTo (Date) |
JSON ID and data type |
tempCoverageTo (string/date-time/) |
6.22. Text with Region Delimiter Structure
Used in: Data Displayed on Screen
6.22.1. Text
Property name |
Text |
|---|---|
Definition |
Text or textual data |
Type and cardinality |
Text (1) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:RegionText (Text) |
JSON ID and data type |
regionText (string//-MANDATORY) |
6.22.2. Measure Type
Property name |
Measure Type |
|---|---|
Definition |
How the measures of the rectangle are expressed |
Notes |
Absolute pixels: measured from the upper left corner of the frame Ratio: percentage of the width or height, reference point upper left corner of the frame |
Type and cardinality |
Text (0..1) - enumeration - absolutePixels - ratio |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:Region/stArea:unit (Closed Choice: - pixel - normalized {=ratio}) |
JSON ID and data type |
measureType (string//enum) |
6.22.3. Rectangle, upper left X
Property name |
Rectangle, upper left X |
|---|---|
Definition |
Horizontal axis value of the upper left corner of the rectange |
Type and cardinality |
Decimal (0..1) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:Region/stArea:x (Real) |
JSON ID and data type |
regionAreaX (number//) |
6.22.4. Rectangle, upper left Y
Property name |
Rectangle, upper left Y |
|---|---|
Definition |
Vertical axis value of the upper left corner of the rectange |
Type and cardinality |
Decimal (0..1) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:Region/stArea:y (Real) |
JSON ID and data type |
regionAreaY (number//) |
6.22.5. Rectangle, horizontal size
Property name |
Rectangle, horizontal size |
|---|---|
Definition |
Horizontal width of the rectangle |
Type and cardinality |
Decimal (0..1) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:Region/stArea:w (Real) |
JSON ID and data type |
regionAreaWidth (number//) |
6.22.6. Rectangle, vertical size
Property name |
Rectangle, vertical size |
|---|---|
Definition |
Vertical height of the rectangle |
Type and cardinality |
Decimal (0..1) |
Change history |
New 1.0 |
XMP ID and data type |
Iptc4xmpExt:Region/stArea:h (Real) |
JSON ID and data type |
regionAreaHeight (number//) |
6.23. Video Time Structure
6.23.1. Time Format
Property name |
Time Format |
|---|---|
Definition |
Identifier of the time format. For time code formats following SMPTE specifications. |
Type and cardinality |
Text value from CV (1) Enumeration: - normalPlayTime - smpteTC24 - smpteTC25 - smpteTC2997 - smpteTC2997drop - smpteTC30 - smpteTC50 - smpteTC5994 - smpteTC5994drop - smpteTC60 - smpteTC23976 |
Change history |
New 1.0 |
XMP ID and data type |
xmpDM:timeFormat (Closed choice Text 24Timecode 25Timecode 2997DropTimecode 2997NonDropTimecode 30Timecode 50Timecode 5994DropTimecode 5994NonDropTimecode 60Timecode 23976Timecode) |
JSON ID and data type |
timeFormat (string//enum-MANDATORY) |
6.23.2. Time Value
Property name |
Time Value |
|---|---|
Definition |
Formated string including hours, minutes, seconds, fractions of seconds or frames, depending on the Time Format |
Type and cardinality |
Text (1) |
Change history |
New 1.0 |
XMP ID and data type |
xmpDM:timeValue (Text) |
JSON ID and data type |
timeValue (string//-MANDATORY) |
6.24. PLUS basic entity structure Structure
6.24.1. Identifier
Property name |
Identifier |
|---|---|
Definition |
Globally unique identifier of the entity |
Type and cardinality |
Text (0..1) |
Change history |
New 1.3 |
XMP ID and data type |
() |
JSON ID and data type |
identifier (string//) |
6.24.2. Name
Property name |
Name |
|---|---|
Definition |
Full name of the entity |
Type and cardinality |
Text (0..1) |
Change history |
New 1.3 |
XMP ID and data type |
() |
JSON ID and data type |
name (string//) |
6.25. Artwork or Object in the Image Structure
6.25.1. Circa Date Created
Property name |
Circa Date Created |
|---|---|
Definition |
Approximate date or range of dates associated with the creation and production of an artwork or object or its components. |
Type and cardinality |
Text (0..1) |
Change history |
New 1.3 |
XMP ID and data type |
() |
JSON ID and data type |
circaDateCreated (string//) |
6.25.2. Content Description
Property name |
Content Description |
|---|---|
Definition |
A textual description of the content depicted in the artwork or object. |
Notes |
|
Type and cardinality |
Text (0..1) |
Change history |
New 1.3 |
XMP ID and data type |
() |
JSON ID and data type |
contentDescription (AltLang ) |
6.25.3. Contribution Description
Property name |
Contribution Description |
|---|---|
Definition |
A textual description about a contribution made to an artwork or an object. |
Notes |
Should include the type, date and location of contribution, and details about the contributor. |
Type and cardinality |
Text (0..1) |
Change history |
New 1.3 |
XMP ID and data type |
() |
JSON ID and data type |
contributionDescription (AltLang ) |
6.25.4. Copyright Notice
Property name |
Copyright Notice |
|---|---|
Definition |
Contains any necessary copyright notice for claiming the intellectual property for artwork or an object in the image and should identify the current owner of the copyright of this work with associated intellectual property rights. |
Type and cardinality |
Text (0..1) |
Change history |
New 1.3 |
XMP ID and data type |
() |
JSON ID and data type |
copyrightNotice (AltLang) |
6.25.5. Creator
Property name |
Creator |
|---|---|
Definition |
Contains the name of the artist who has created artwork or an object in the image. In cases where the artist could or should not be identified the name of a company or organisation may be appropriate. |
Type and cardinality |
Text (0..unbounded) |
Change history |
New 1.3 |
XMP ID and data type |
() |
JSON ID and data type |
creatorNames (string//array) |
6.25.6. Creator ID
Property name |
Creator ID |
|---|---|
Definition |
Globally unique identifier for the creator of artwork or object. |
Notes |
Add the IDs in the same sequence as the Creator names |
Type and cardinality |
URL (0..unbounded) |
Change history |
New 1.3 |
XMP ID and data type |
() |
JSON ID and data type |
creatorIdentifiers (string/uri/array ) |
6.25.7. Current Copyright Owner ID
Property name |
Current Copyright Owner ID |
|---|---|
Definition |
Globally unique identifier for the current owner of the copyright of the artwork or object. |
Type and cardinality |
URI (0..1) |
Change history |
New 1.3 |
XMP ID and data type |
() |
JSON ID and data type |
currentCopyrightOwnerIdentifier (string/uri/) |
6.25.8. Current Copyright Owner Name
Property name |
Current Copyright Owner Name |
|---|---|
Definition |
Name of the current owner of the copyright of the artwork or object. |
Type and cardinality |
Text (0..1) |
Change history |
New 1.3 |
XMP ID and data type |
() |
JSON ID and data type |
currentCopyrightOwnerName (string//) |
6.25.9. Current Licensor ID
Property name |
Current Licensor ID |
|---|---|
Definition |
Globally unique identifier for the current licensor of the artwork or object. |
Type and cardinality |
URI (0..1) |
Change history |
New 1.3 |
XMP ID and data type |
() |
JSON ID and data type |
currentLicensorIdentifier (string/uri/) |
6.25.10. Current Licensor Name
Property name |
Current Licensor Name |
|---|---|
Definition |
Name of the current licensor of the artwork or object. |
Type and cardinality |
Text (0..1) |
Change history |
New 1.3 |
XMP ID and data type |
() |
JSON ID and data type |
currentLicensorName (string//) |
6.25.11. Date Created
Property name |
Date Created |
|---|---|
Definition |
Designates the date and optionally the time the artwork or object in the image was created. This relates to artwork or objects with associated intellectual property rights. |
Type and cardinality |
DateTime (preferred: truncated DateTime) (0..1) |
Change history |
New 1.3 |
XMP ID and data type |
() |
JSON ID and data type |
dateCreated (string/date-time/) |
6.25.12. Physical Description
Property name |
Physical Description |
|---|---|
Definition |
A textual description of the physical characteristics of the artwork or object, without reference to the content depicted. |
Notes |
Object type, materials-techniques and measurements may be described. |
Type and cardinality |
Text (0..1) |
Change history |
New 1.3 |
XMP ID and data type |
() |
JSON ID and data type |
physicalDescription (AltLang) |
6.25.13. Source
Property name |
Source |
|---|---|
Definition |
The organisation or body holding and registering the artwork or object in the image for inventory purposes. |
Type and cardinality |
Text (0..1) |
Change history |
New 1.3 |
XMP ID and data type |
() |
JSON ID and data type |
source (string//) |
6.25.14. Source Inventory Number
Property name |
Source Inventory Number |
|---|---|
Definition |
The inventory number issued by the organisation or body holding and registering the artwork or object in the image. |
Type and cardinality |
Text (0..1) |
Change history |
New 1.3 |
XMP ID and data type |
() |
JSON ID and data type |
sourceInventoryNr (string//) |
6.25.15. Source Inventory URL
Property name |
Source Inventory URL |
|---|---|
Definition |
URL reference to the metadata record of the inventory maintained by the Source. |
Type and cardinality |
URL (0..1) |
Change history |
New 1.3 |
XMP ID and data type |
() |
JSON ID and data type |
sourceInventoryUrl (string/uri/) |
6.25.16. Style Period
Property name |
Style Period |
|---|---|
Definition |
The style, historical or artistic period, movement, group, or school whose characteristics are represented in the artwork or object. |
Notes |
It is advised to take the terms from a Controlled Vocabulary. |
Type and cardinality |
Text (0..unbounded) |
Change history |
New 1.3 |
XMP ID and data type |
() |
JSON ID and data type |
stylePeriod (string//array ) |
6.25.17. Title
Property name |
Title |
|---|---|
Definition |
A reference for the artwork or object in the image. |
Type and cardinality |
Text (0..1) |
Change history |
New 1.3 |
XMP ID and data type |
() |
JSON ID and data type |
title (AltLang) |
6.26. Time Structure
6.26.1. Scale
Property name |
Scale |
|---|---|
Definition |
|
Type and cardinality |
|
Change history |
New 1.3 |
XMP ID and data type |
() |
JSON ID and data type |
scale (string//) |
6.26.2. Value
Property name |
Value |
|---|---|
Definition |
|
Type and cardinality |
|
Change history |
New 1.3 |
XMP ID and data type |
() |
JSON ID and data type |
value (string//) |
7. Recommended Property Mappings
Many Video Metadata Hub properties are mapped to properties defined by one or more of the below standards, to make implementation easier for vendors:
-
Apple QuickTime
-
Canon VideoClip XML (as of Video Metadata Hub 1.2)
-
DPP profile of the AS-11 specification, built on MXF (added in Video Metadata Hub 1.4)
-
EBUCore (updated in Video Metadata Hub 1.3)
-
EIDR Data Fields
-
IPTC NewsML-G2
-
MovieLabs MDDF (added in Video Metadata Hub 1.4)
-
MPEG 7 (ISO 15938-5)
-
PBCore 2.1
-
Schema.org
-
SMPTE P2 as used by Panasonic
-
Sony XDCAM & planning (as of Video Metadata Hub 1.2)
The mappings can be obtained from the IPTC Video Metadata Hub mappings table.
7.1. Using the mapping table
For example, if an organisation uses NewsML-G2 as its main metadata format, and wants to describe the unique identifier for the video file (Video Identifier in VM Hub).
Looking up the appropriate row in
the mapping table,
and then consulting the NewsML-G2 column,
we can see that the recommended mapping is contentMeta/altId[@role="altidrole:vmhVideoId"].
So this means that the video identifier should be represented as follows in the NewsML-G2 file:
<contentMeta>
<altId role="altidrole:vmhVideoId">xxxx</altId>
</contentMeta>
8. JSON Schema for Video Metadata Hub
The IPTC Video Metadata Working Group has created a JSON Schema to help users create metadata packages in the JSON format. These could be embedded into a video file, or used as a separate file accompanying the video, known as a "sidecar" file.
We recommend that the JSON format could be used for lightweight exchage of video metadata, e.g. by APIs.
The JSON Schema for this format is located at https://www.iptc.org/std/videometadatahub/recommendation/iptc-vmhub-1.5-schema.json. A JSON Schema-aware editor can help users to create metadata files in that format, or tool makers could write software that outputs that format from a graphical user interface.
The IPTC’s interactive IPTC Video Metadata Hub Generator tool can be used to create Video Metadata Hub metadata in JSON format for testing and prototyping purposes. (Note that the generator tool does not currently support all VMHub properties.)
See also the JSON Example Files section below.
9. Usage examples and reference images
9.1. Example and reference videos using embedded XMP and exiftool
We have created some sample video files with IPTC Video Metadata Hub properties embedded into video files using the XMP format.
The example files can be found at https://iptc.org/std/videometadatahub/examples/.
File names starting with IPTC-VMHub-RefVideo-Rec are "reference videos".
They have a value for each and every Video Metadata Hub property, embedded using
the XMP format. Currently only properties specified in VMHub versions 1.0 to 1.2
are included due to exiftool support.
View the embedded metadata by downloading and examining the file, for example using the command-line tool exiftool:
$ curl --output refvideo.mp4 https://www.iptc.org/std/videometadatahub/examples/IPTC-VMHub-RefVideo-Rec0100.mp4 $ exiftool -G1 -json -struct refvideo.mp4
Below we show an extract of the embedded metadata resulting from the above command, showing the Video Metadata Hub tags extracted by exiftool:
{
[ ... ]
"LinkedEncRightsExpr": [{
"LinkedRightsExpr": "http://example.org/linkedrightsexpression/id986/Rec0100",
"RightsExprEncType": "IANA Media Type of ERE (Rec0100)",
"RightsExprLangId": "http://example.org/RELids/id4712/Rec0100"
}],
"LocationCreated": [{
"City": "City (Location created1) (Rec0100)",
"CountryCode": "R16",
"CountryName": "CountryName (Location created1) (Rec0100)",
"GPSAltitude": "180 m",
"GPSLatitude": "16 deg 20' 1.20\" N",
"GPSLongitude": "48 deg 14' 1.80\" E",
"LocationId": ["Location Id (Location created1) (Rec0100)"],
"LocationName": "Name of Location Created 1 (Rec0100)",
"ProvinceState": "Province/State (Location created1) (Rec0100)",
"Sublocation": "Sublocation (Location created1) (Rec0100)",
"WorldRegion": "Worldregion (Location created1) (Rec0100)"
}],
"LocationShown": [{
"City": "City (Location shown1) (Rec0100)",
"CountryCode": "R16",
[ ... ]Please note that the field names used by exiftool do not exactly match the names in the Video Metadata Hub specification.
To view the raw XMP data, use the command:
$ exiftool -xmp -b refvideo.mp4
9.2. JSON Example Files
Example JSON files aligning with our standard use cases are available at https://iptc.org/std/videometadatahub/examples/json/.
Here is an extract of the example that relates to the Galleries, Libraries, Archives and Museums (GLAM) use case:
[...]
"photoVideoMetadataIPTC": {
"circaDateCreated": "1990s",
"dateModified": "No",
"episode": {
"name": {
"en": "https://wellcomelibrary.org/item/b16766246"
}
},
"externalMetadataLinks": [
"https://wellcomelibrary.org/data/b16766246"
],
"metadataAuthority": {
"name": {
"en": "Wellcome Library"
}
},
"releaseReady": true,
"identifier": "b16766246",
"aboutCvTerms": "Public health",
"description": {
"en": "A television advertisement asking people to register for a Donor Card in order to donate organs after death. "
},
"dopesheetLinks": "https://wellcomelibrary.org/data/b16766246",
"genres": "Public information",
"headline": {
"en": "A television advertisement asking people to register for a Donor Card in order to donate organs after death. "
},
[...]
9.3. IPTC Video Metadata Hub Generator
The IPTC’s interactive IPTC Video Metadata Hub Generator tool can be used to create Video Metadata Hub metadata in various formats for testing and prototyping purposes.
A web form allows users to enter sample metadata values and a file is automatically generated in any of a variety of output formats.
Formats available include: * JSON - following the IPTC VMHub JSON Schema described above , users can create JSON files that can be used as sidecar documents in video applications. * JSON XMP (for Exiftool) - using exiftool’s JSON property names, this creates a JSON file that can be embedded into a video file using exiftool with the following command:
$ exiftool -v -XMP:all= -j=<JSON file> <videofile>
(Note that the -XMP:all= argument removes all existing XMP metadata before the new metadata is added. If this behaviour is not desired, that part can be omitted.)
* NewsML-G2 - using IPTC’s NewsML-G2 format which is heavily used in the news industry, especially for content syndication.
* c2patool - Generates a JSON-LD block containing a C2PA assertion that can be embedded using c2patool. See the C2PA section for details.
Note that the generator tool does not currently support all VMHub properties.
9.4. Using c2patool to embed IPTC Video Metadata
The C2PA specification defines a method that can be used to embed metadata into media files in a way that is cryptographically verifiable and therefore tamper-evident. See more at the C2PA website.
IPTC Video Metadata Hub metadata is the standard way to add video metadata to C2PA files (see the IPTC metadata section of the C2PA technical specification.
Using the IPTC Video Metadata Hub Generator, the IPTC has developed an easy way to create metadata records that can be embedded into video files using the C2PA specification. This is achieved using the command-line tool c2patool which was developed by the Content Authenticity Initiative.
To add C2PA-enabled metadata to a video file, follow these steps:
-
Using the Video Metadata Hub generator tool, enter the desired values into the appropriate metadata form fields.
-
Select "C2PA assertion (for c2patool)" as the output format.
-
Save the generated JSON-LD block to a file (for example, by copying it to clipboard and pasting it into a simple text editor such as Notepad or TextEdit).
-
Add the metadata to your video using the c2patool command:
$ c2patool <input video file> -m iptc-vmhub-assertion.json -o <output video file>
9.5. Using c2patool to view IPTC Video Metadata
Currently, the standard Content Authenticity Initiative tools such as verify.contentauthenticity.org do not display IPTC Video Metadata properties.
To view IPTC embedded metadata, you must also use c2patool on the command line:
$ c2patool <output video file>
This should show the full contents of all assertions in the video file, including those that you just added.
9.6. Example video files using embedded C2PA video metadata
At http://iptc.org/std/videometadatahub/examples/c2pa/ we show some example files using the above technique to embed video metadata. These include:
-
a "minimal assertion" using only the core set of properties
-
a "generator assertion" using all properties exposed via the IPTC Video Metadata Hub Generator
-
a "maximal assertion" that uses all Video Metadata Hub properties.
Both the assertions (as JSON files) and the video files (including the embedded assertion, signed using a C2PA test certificate) are included.
10. How can you help?
-
Software vendors: implement the standard in your systems to support interoperability. The standard is freely available and free to implement.
-
Broadcasters and video producers: encourage your software vendors and manufacturers to implement IPTC Video Metadata Hub in their systems.
-
Media managers: as you configure your Digital Asset Management systems' metadata fields, consider using the Video Metadata Hub properties as the basis for your metadata schema, to ensure easy supply chain interchange and compatibility with other systems in the future.
11. Contact us
If you would like to implement IPTC Video Metadata Hub, suggest changes or help us spread the word, please contact the IPTC Video Metadata Working Group via the public discussion list https://groups.io/g/iptc-videometadata .