org.apache.tika.metadata
Interface IPTC

public interface IPTC

IPTC photo metadata schema. A collection of property definition constants for the photo metadata properties defined in the IPTC standard.

Since:

Apache Tika 1.1

See Also:

IPTC Photo Metadata

Field Summary

static Property	ADDITIONAL_MODEL_INFO Information about the ethnicity and other facets of the model(s) in a model-released image.
static Property	ARTWORK_OR_OBJECT A set of metadata about artwork or an object in the item
static Property	ARTWORK_OR_OBJECT_DETAIL_COPYRIGHT_NOTICE 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.
static Property	ARTWORK_OR_OBJECT_DETAIL_CREATOR Contains the name of the artist who has created artwork or an object in the image.
static Property	ARTWORK_OR_OBJECT_DETAIL_DATE_CREATED Designates the date and optionally the time the artwork or object in the image was created.
static Property	ARTWORK_OR_OBJECT_DETAIL_SOURCE The organisation or body holding and registering the artwork or object in the image for inventory purposes.
static Property	ARTWORK_OR_OBJECT_DETAIL_SOURCE_INVENTORY_NUMBER The inventory number issued by the organisation or body holding and registering the artwork or object in the image.
static Property	ARTWORK_OR_OBJECT_DETAIL_TITLE A reference for the artwork or object in the image.
static Property	CATEGORY Deprecated.
static Property	CITY Name of the city the content is focussing on -- either the place shown in visual media or referenced by text or audio media.
static Property	CONTACT_INFO_ADDRESS The contact information address part.
static Property	CONTACT_INFO_CITY The contact information city part.
static Property	CONTACT_INFO_COUNTRY The contact information country part.
static Property	CONTACT_INFO_EMAIL The contact information email address part.
static Property	CONTACT_INFO_PHONE The contact information phone number part.
static Property	CONTACT_INFO_POSTAL_CODE The contact information part denoting the local postal code.
static Property	CONTACT_INFO_STATE_PROVINCE The contact information part denoting regional information such as state or province.
static Property	CONTACT_INFO_WEB_URL The contact information web address part.
static Property	CONTROLLED_VOCABULARY_TERM A term to describe the content of the image by a value from a Controlled Vocabulary.
static Property	COPYRIGHT_NOTICE Contains any necessary copyright notice for claiming the intellectual property for this item and should identify the current owner of the copyright for the item.
static Property	COPYRIGHT_OWNER Owner or owners of the copyright in the licensed image.
static Property	COPYRIGHT_OWNER_ID The ID of the owner or owners of the copyright in the licensed image.
static Property	COPYRIGHT_OWNER_NAME The name of the owner or owners of the copyright in the licensed image.
static Property	COUNTRY Full name of the country the content is focussing on -- either the country shown in visual media or referenced in text or audio media.
static Property	COUNTRY_CODE Code of the country the content is focussing on -- either the country shown in visual media or referenced in text or audio media.
static Property	CREATOR Contains the name of the person who created the content of this item, a photographer for photos, a graphic artist for graphics, or a writer for textual news, but in cases where the photographer should not be identified the name of a company or organisation may be appropriate.
static Property	CREATORS_CONTACT_INFO The creator's contact information provides all necessary information to get in contact with the creator of this item and comprises a set of sub-properties for proper addressing.
static Property	CREATORS_JOB_TITLE Contains the job title of the person who created the content of this item.
static Property	CREDIT_LINE The credit to person(s) and/or organisation(s) required by the supplier of the item to be used when published.
static Property	DATE_CREATED Designates the date and optionally the time the intellectual content was created rather than the date of the creation of the physical representation.
static Property	DESCRIPTION A textual description, including captions, of the item's content, particularly used where the object is not text.
static Property	DESCRIPTION_WRITER Identifier or the name of the person involved in writing, editing or correcting the description of the content.
static Property	DIGITAL_IMAGE_GUID Globally unique identifier for the item.
static Property	DIGITAL_SOURCE_FILE_TYPE Deprecated.
static Property	DIGITAL_SOURCE_TYPE The type of the source of this digital image
static Property	EVENT Names or describes the specific event the content relates to.
static Property	HEADLINE A brief synopsis of the caption.
static Property	IMAGE_CREATOR Creator or creators of the image.
static Property	IMAGE_CREATOR_ID The ID of the creator or creators of the image.
static Property	IMAGE_CREATOR_NAME The name of the creator or creators of the image.
static Property	IMAGE_REGISTRY_ENTRY Both a Registry Item Id and a Registry Organisation Id to record any registration of this item with a registry.
static Property	IMAGE_SUPPLIER Identifies the most recent supplier of the item, who is not necessarily its owner or creator.
static Property	IMAGE_SUPPLIER_ID Identifies the most recent supplier of the item, who is not necessarily its owner or creator.
static Property	IMAGE_SUPPLIER_IMAGE_ID Optional identifier assigned by the Image Supplier to the image.
static Property	IMAGE_SUPPLIER_NAME Identifies the most recent supplier of the item, who is not necessarily its owner or creator.
static Property	INSTRUCTIONS Any of a number of instructions from the provider or creator to the receiver of the item.
static Property	INTELLECTUAL_GENRE Describes the nature, intellectual, artistic or journalistic characteristic of a item, not specifically its content.
static Property	IPTC_LAST_EDITED The date and optionally time when any of the IPTC photo metadata fields has been last edited
static Property	JOB_ID Number or identifier for the purpose of improved workflow handling.
static Property	KEYWORDS Keywords to express the subject of the content.
static Property	LICENSOR A person or company that should be contacted to obtain a licence for using the item or who has licensed the item.
static Property	LICENSOR_CITY The city of a person or company that should be contacted to obtain a licence for using the item or who has licensed the item.
static Property	LICENSOR_COUNTRY The country of a person or company that should be contacted to obtain a licence for using the item or who has licensed the item.
static Property	LICENSOR_EMAIL The email of a person or company that should be contacted to obtain a licence for using the item or who has licensed the item.
static Property	LICENSOR_EXTENDED_ADDRESS The extended address of a person or company that should be contacted to obtain a licence for using the item or who has licensed the item.
static Property	LICENSOR_ID The ID of the person or company that should be contacted to obtain a licence for using the item or who has licensed the item.
static Property	LICENSOR_NAME The name of the person or company that should be contacted to obtain a licence for using the item or who has licensed the item.
static Property	LICENSOR_POSTAL_CODE The postal code of a person or company that should be contacted to obtain a licence for using the item or who has licensed the item.
static Property	LICENSOR_REGION The region of a person or company that should be contacted to obtain a licence for using the item or who has licensed the item.
static Property	LICENSOR_STREET_ADDRESS The street address of a person or company that should be contacted to obtain a licence for using the item or who has licensed the item.
static Property	LICENSOR_TELEPHONE_1 The phone number of a person or company that should be contacted to obtain a licence for using the item or who has licensed the item.
static Property	LICENSOR_TELEPHONE_2 The phone number of a person or company that should be contacted to obtain a licence for using the item or who has licensed the item.
static Property	LICENSOR_URL The URL of a person or company that should be contacted to obtain a licence for using the item or who has licensed the item.
static Property	LOCATION_CREATED The location the content of the item was created.
static Property	LOCATION_CREATED_CITY Name of the city of a location.
static Property	LOCATION_CREATED_COUNTRY_CODE The ISO code of a country of a location.
static Property	LOCATION_CREATED_COUNTRY_NAME The name of a country of a location.
static Property	LOCATION_CREATED_PROVINCE_OR_STATE The name of a subregion of a country - a province or state - of a location.
static Property	LOCATION_CREATED_SUBLOCATION Name of a sublocation.
static Property	LOCATION_CREATED_WORLD_REGION The name of a world region of a location.
static Property	LOCATION_SHOWN A location the content of the item is about.
static Property	LOCATION_SHOWN_CITY Name of the city of a location.
static Property	LOCATION_SHOWN_COUNTRY_CODE The ISO code of a country of a location.
static Property	LOCATION_SHOWN_COUNTRY_NAME The name of a country of a location.
static Property	LOCATION_SHOWN_PROVINCE_OR_STATE The name of a subregion of a country - a province or state - of a location.
static Property	LOCATION_SHOWN_SUBLOCATION Name of a sublocation.
static Property	LOCATION_SHOWN_WORLD_REGION The name of a world region of a location.
static Property	MAX_AVAIL_HEIGHT The maximum available height in pixels of the original photo from which this photo has been derived by downsizing.
static Property	MAX_AVAIL_WIDTH The maximum available width in pixels of the original photo from which this photo has been derived by downsizing.
static Property	MINOR_MODEL_AGE_DISCLOSURE Age of the youngest model pictured in the image, at the time that the image was made.
static Property	MODEL_AGE Age of the human model(s) at the time this image was taken in a model released image.
static Property	MODEL_RELEASE_ID Optional identifier associated with each Model Release.
static Property	MODEL_RELEASE_STATUS Summarizes the availability and scope of model releases authorizing usage of the likenesses of persons appearing in the photograph.
static String	NAMESPACE_URI_IPTC_CORE
static String	NAMESPACE_URI_IPTC_EXT
static String	NAMESPACE_URI_PLUS
static Property	ORGANISATION_CODE A set of metadata about artwork or an object in the item
static Property	ORGANISATION_NAME Name of the organisation or company which is featured in the content.
static Property	PERSON Name of a person the content of the item is about.
static Property	PLUS_VERSION The version number of the PLUS standards in place at the time of the transaction.
static String	PREFIX_IPTC_CORE
static String	PREFIX_IPTC_EXT
static String	PREFIX_PLUS
static Property[]	PROPERTY_GROUP_IPTC_CORE
static Property[]	PROPERTY_GROUP_IPTC_EXT
static Property	PROPERTY_RELEASE_ID Optional identifier associated with each Property Release.
static Property	PROPERTY_RELEASE_STATUS Summarises the availability and scope of property releases authorizing usage of the properties appearing in the photograph.
static Property	PROVINCE_OR_STATE Name of the subregion of a country -- either called province or state or anything else -- the content is focussing on -- either the subregion shown in visual media or referenced by text or audio media.
static Property	REGISTRY_ENTRY_CREATED_ITEM_ID A unique identifier created by a registry and applied by the creator of the item.
static Property	REGISTRY_ENTRY_CREATED_ORGANISATION_ID An identifier for the registry which issued the corresponding Registry Image Id.
static Property	RIGHTS_USAGE_TERMS The licensing parameters of the item expressed in free-text.
static Property	SCENE_CODE Describes the scene of a news content.
static Property	SOURCE Identifies the original owner of the copyright for the intellectual content of the item.
static Property	SUBJECT_CODE Specifies one or more Subjects from the IPTC Subject-NewsCodes taxonomy to categorise the content.
static Property	SUBLOCATION Name of a sublocation the content is focussing on -- either the location shown in visual media or referenced by text or audio media.
static Property	SUPPLEMENTAL_CATEGORIES Deprecated.
static Property	TITLE A shorthand reference for the item.
static Property	URGENCY Deprecated.

Field Detail

NAMESPACE_URI_IPTC_CORE

static final String NAMESPACE_URI_IPTC_CORE

See Also:

Constant Field Values

NAMESPACE_URI_IPTC_EXT

static final String NAMESPACE_URI_IPTC_EXT

See Also:

Constant Field Values

NAMESPACE_URI_PLUS

static final String NAMESPACE_URI_PLUS

See Also:

Constant Field Values

PREFIX_IPTC_CORE

static final String PREFIX_IPTC_CORE

See Also:

Constant Field Values

PREFIX_IPTC_EXT

static final String PREFIX_IPTC_EXT

See Also:

Constant Field Values

PREFIX_PLUS

static final String PREFIX_PLUS

See Also:

Constant Field Values

CITY

static final Property CITY

Name of the city the content is focussing on -- either the place shown in visual media or referenced by text or audio media. This element is at the third level of a top-down geographical hierarchy.

This is a detail of a location with blurred semantics as it does not clearly indicate whether it is the location in the image or the location the photo was taken - which can be different. Two more concise properties are available in IPTC Extension with Location Created and Location Shown in the Image.

Maps to this IIM property: 2:90 City

See Also:

Photoshop.CITY

COUNTRY

static final Property COUNTRY

Full name of the country the content is focussing on -- either the country shown in visual media or referenced in text or audio media. This element is at the top/first level of a top- down geographical hierarchy. The full name should be expressed as a verbal name and not as a code, a code should go to the element "CountryCode"

This is a detail of a location with blurred semantics as it does not clearly indicate whether it is the location in the image or the location the photo was taken - which can be different. Two more concise properties are available in IPTC Extension with Location Created and Location Shown in the Image.

Maps to this IIM property: 2:101 Country/Primary Location Name

See Also:

Photoshop.COUNTRY

COUNTRY_CODE

static final Property COUNTRY_CODE

Code of the country the content is focussing on -- either the country shown in visual media or referenced in text or audio media. This element is at the top/first level of a top-down geographical hierarchy. The code should be taken from ISO 3166 two or three letter code. The full name of a country should go to the "Country" element.

This is a detail of a location with blurred semantics as it does not clearly indicate whether it is the location in the image or the location the photo was taken - which can be different. Two more concise properties are available in IPTC Extension with Location Created and Location Shown in the Image.

Maps to this IIM property: 2:100 Country/Primary Location Code

DESCRIPTION

static final Property DESCRIPTION

A textual description, including captions, of the item's content, particularly used where the object is not text.

Note: the XMP property (dc:description) which stores the value of this IPTC Core property is of type Lang Alt. Hence any software agent dealing with this property must abide to the processing rules for Lang Alt value type as specified by the XMP specifications.

Maps to this IIM property: 2:120 Caption/Abstract

See Also:

DublinCore.DESCRIPTION

HEADLINE

static final Property HEADLINE

A brief synopsis of the caption. Headline is not the same as Title.

Maps to this IIM property: 2:105 Headline

See Also:

Photoshop.HEADLINE

INTELLECTUAL_GENRE

static final Property INTELLECTUAL_GENRE

Describes the nature, intellectual, artistic or journalistic characteristic of a item, not specifically its content.

The IPTC recognizes that the corresponding IPTC Genre NewsCodes needs photo specific extension to be better usable with this field (as of the release of this standard in the year 2008).

Maps to this IIM property: 2:04 Object Attribute Reference

KEYWORDS

static final Property KEYWORDS

Keywords to express the subject of the content. Keywords may be free text and don't have to be taken from a controlled vocabulary. Codes from the controlled vocabulary IPTC Subject NewsCodes must go to the "Subject Code" field.

Single values of this field should not be restricted to single words but must allow for phrases as well.

Maps to this IIM property: 2:25 Keywords

See Also:

DublinCore.SUBJECT

PROVINCE_OR_STATE

static final Property PROVINCE_OR_STATE

Name of the subregion of a country -- either called province or state or anything else -- the content is focussing on -- either the subregion shown in visual media or referenced by text or audio media. This element is at the second level of a top-down geographical hierarchy.

This is a detail of a location with blurred semantics as it does not clearly indicate whether it is the location in the image or the location the photo was taken - which can be different. Two more concise properties are available in IPTC Extension with Location Created and Location Shown in the Image.

Maps to this IIM property: 2:95 Province/State

See Also:

Photoshop.STATE

SCENE_CODE

static final Property SCENE_CODE

Describes the scene of a news content. Specifies one or more terms from the IPTC "Scene-NewsCodes". Each Scene is represented as a string of 6 digits in an unordered list.

Note: Only Scene values from this IPTC taxonomy should be used here. More about the IPTC Scene-NewsCodes at www.newscodes.org.

SUBJECT_CODE

static final Property SUBJECT_CODE

Specifies one or more Subjects from the IPTC Subject-NewsCodes taxonomy to categorise the content. Each Subject is represented as a string of 8 digits in an unordered list.

Note: Only Subjects from a controlled vocabulary should be used here, free text has to be put into the Keyword element. More about IPTC Subject-NewsCodes at www.newscodes.org.

SUBLOCATION

static final Property SUBLOCATION

Name of a sublocation the content is focussing on -- either the location shown in visual media or referenced by text or audio media. This location name could either be the name of a sublocation to a city or the name of a well known location or (natural) monument outside a city. In the sense of a sublocation to a city this element is at the fourth level of a top-down geographical hierarchy.

This is a detail of a location with blurred semantics as it does not clearly indicate whether it is the location in the image or the location the photo was taken - which can be different. Two more concise properties are available in IPTC Extension with Location Created and Location Shown in the Image.

Maps to this IIM property: 2:92 Sublocation

DATE_CREATED

static final Property DATE_CREATED

Designates the date and optionally the time the intellectual content was created rather than the date of the creation of the physical representation.

If a software system requires explicit time values and no time is given by the Date Created property the software system should default the time to 00:00:00. If the software system does not require an explicit time value the time part should be left empty as it is.

Note 1: Any content of the IIM dataset 2:60, Time Created, should be merged to this element. Note 2: Implementers are encouraged to provide the creation date and time from the EXIF data of a digital camera to the user for entering this date for the first time.

Maps to this IIM property: 2:55 Date Created

See Also:

Photoshop.DATE_CREATED

DESCRIPTION_WRITER

static final Property DESCRIPTION_WRITER

Identifier or the name of the person involved in writing, editing or correcting the description of the content.

Maps to this IIM property: 2:122 Writer/Editor

See Also:

Photoshop.CAPTION_WRITER

INSTRUCTIONS

static final Property INSTRUCTIONS

Any of a number of instructions from the provider or creator to the receiver of the item.

Maps to this IIM property: 2:40 Special Instruction

See Also:

Photoshop.INSTRUCTIONS

JOB_ID

static final Property JOB_ID

Number or identifier for the purpose of improved workflow handling. This is a user created identifier related to the job for which the item is supplied.

Note: As this identifier references a job of the receiver's workflow it must first be issued by the receiver, then transmitted to the creator or provider of the news object and finally added by the creator to this field.

Maps to this IIM property: 2:103 Original Transmission Reference

See Also:

Photoshop.TRANSMISSION_REFERENCE

TITLE

static final Property TITLE

A shorthand reference for the item. Title provides a short human readable name which can be a text and/or numeric reference. It is not the same as Headline.

Many use the Title field to store the filename of the image, though the field may be used in many ways. Formal identifiers are provided by the Digital Image Id, or the Registry Entry property of the IPTC Extension.

Note 1: This element aligns with the use of Dublin Core's "Title" element. Note 2: the XMP property (dc:title) which stores the value of this IPTC Core property is of type Lang Alt. Hence any software agent dealing with this property must abide to the processing rules for Lang Alt value type as specified by the XMP specifications.

Maps to this IIM property: 2:05 Object Name

See Also:

DublinCore.TITLE

COPYRIGHT_NOTICE

static final Property COPYRIGHT_NOTICE

Contains any necessary copyright notice for claiming the intellectual property for this item and should identify the current owner of the copyright for the item. Other entities like the creator of the item may be added in the corresponding field. Notes on usage rights should be provided in "Rights usage terms".

Copyright ownership can be expressed in a more controlled way using the PLUS fields "Copyright Owner", "Copyright Owner ID", "Copyright Owner Name" of the IPTC Extension. It is the user's responsibility to keep the values of the four fields in sync.

Note: the XMP property (dc:rights) which stores the value of this IPTC Core property is of type Lang Alt. Hence any software agent dealing with this property must abide to the processing rules for Lang Alt value type as specified by the XMP specifications.

Maps to this IIM property: 2:116 Copyright Notice

See Also:

DublinCore.RIGHTS

CREATOR

static final Property CREATOR

Contains the name of the person who created the content of this item, a photographer for photos, a graphic artist for graphics, or a writer for textual news, but in cases where the photographer should not be identified the name of a company or organisation may be appropriate.

The creator can be expressed in a more controlled way using the "Image Creator" of PLUS in the IPTC Extension additionally. It is the user's responsibility to keep the values of the IPTC Core and the PLUS fields in sync.

Maps to this IIM property: 2:80 By-line

See Also:

DublinCore.CREATOR

CREATORS_CONTACT_INFO

static final Property CREATORS_CONTACT_INFO

The creator's contact information provides all necessary information to get in contact with the creator of this item and comprises a set of sub-properties for proper addressing.

The IPTC Extension Licensor fields should be used instead of these Creator's Contact Info fields if you are using IPTC Extension fields. If the creator is also the licensor his or her contact information should be provided in the Licensor fields.

Note 1 to user interface implementers: All sub-properties of "Creator's contact information" should be shown as group on the form. Note 2: the CreatorContactInfo sub-properties' naming aligns with the vCard specification RFC 2426.

CREATORS_JOB_TITLE

static final Property CREATORS_JOB_TITLE

Contains the job title of the person who created the content of this item. As this is sort of a qualifier the Creator element has to be filled in as mandatory prerequisite for using Creator's Jobtitle.

Maps to this IIM property: 2:85 By-line Title

See Also:

Photoshop.AUTHORS_POSITION

CREDIT_LINE

static final Property CREDIT_LINE

The credit to person(s) and/or organisation(s) required by the supplier of the item to be used when published. This is a free-text field.

Note 1: For more formal identifications of the creator or the owner of the copyrights of this image other rights properties may be used. Note 2: This property was named "Credit" by the IIM metadata, then it was renamed to "Provider" in IPTC Core 1.0. In IPTC Core 1.1. it has been renamed to "Credit Line" as the field is used for this purpose by many users.

Maps to this IIM property: 2:110 Credit

See Also:

Photoshop#CREDIT_LINE

RIGHTS_USAGE_TERMS

static final Property RIGHTS_USAGE_TERMS

The licensing parameters of the item expressed in free-text.

The PLUS fields of the IPTC Extension can be used in parallel to express the licensed usage in more controlled terms.

SOURCE

static final Property SOURCE

Identifies the original owner of the copyright for the intellectual content of the item. This could be an agency, a member of an agency or an individual. Source could be different from Creator and from the entities in the CopyrightNotice.

The original owner can never change. For that reason the content of this property should never be changed or deleted after the information is entered following the news object's initial creation.

Maps to this IIM property: 2:115 Source

See Also:

Photoshop.SOURCE

CONTACT_INFO_ADDRESS

static final Property CONTACT_INFO_ADDRESS

The contact information address part. Comprises an optional company name and all required information to locate the building or postbox to which mail should be sent. To that end, the address is a multiline field.

Note 1: to user interface implementers: This field should be part of a "Contact information" group on the form. Note 2: the ContactInfo naming aligns with the vCard specification RFC 2426.

CONTACT_INFO_CITY

static final Property CONTACT_INFO_CITY

The contact information city part.

Note 1: to user interface implementers: This field should be part of a "Contact information" group on the form. Note 2: the ContactInfo naming aligns with the vCard specification RFC 2426.

CONTACT_INFO_COUNTRY

static final Property CONTACT_INFO_COUNTRY

The contact information country part.

Note 1: to user interface implementers: This field should be part of a "Contact information" group on the form. Note 2: the ContactInfo naming aligns with the vCard specification RFC 2426.

CONTACT_INFO_EMAIL

static final Property CONTACT_INFO_EMAIL

The contact information email address part.

Multiple email addresses can be given. May have to be separated by a comma in the user interface.

Note 1: to user interface implementers: This field should be part of a "Contact information" group on the form. Note 2 to user interface implementers: provide sufficient space to fill in multiple e-mail addresses. Note 3: the ContactInfo naming aligns with the vCard specification RFC 2426.

CONTACT_INFO_PHONE

static final Property CONTACT_INFO_PHONE

The contact information phone number part.

Multiple numbers can be given. May have to be separated by a comma in the user interface.

Note 1: to user interface implementers: This field should be part of a "Contact information" group on the form. Note 2 to user interface implementers: provide sufficient space to fill in multiple international numbers. Note 3: the ContactInfo naming aligns with the vCard specification RFC 2426.

CONTACT_INFO_POSTAL_CODE

static final Property CONTACT_INFO_POSTAL_CODE

The contact information part denoting the local postal code.

Note 1: to user interface implementers: This field should be part of a "Contact information" group on the form. Note 2: the ContactInfo naming aligns with the vCard specification RFC 2426.

CONTACT_INFO_STATE_PROVINCE

static final Property CONTACT_INFO_STATE_PROVINCE

The contact information part denoting regional information such as state or province.

Note 1: to user interface implementers: This field should be part of a "Contact information" group on the form. Note 2: the ContactInfo naming aligns with the vCard specification RFC 2426.

CONTACT_INFO_WEB_URL

static final Property CONTACT_INFO_WEB_URL

The contact information web address part. Multiple addresses can be given, separated by a comma.

Note 1: to user interface implementers: This field should be part of a "Contact information" group on the form. Note 2 to user interface implementers: provide sufficient space to fill in multiple URLs. Note 3: the ContactInfo naming aligns with the vCard specification RFC 2426.

URGENCY

static final Property URGENCY

Deprecated.

As this metadata element pertains to distribution management, it was not adopted. However, this data is still synchronised with the XMP property [photoshop:Urgency], and hence, available for future use, but outside the IPTC Core.

CATEGORY

static final Property CATEGORY

Deprecated.

As this metadata element was earmarked as deprecated already for IIM 4.1, it was not adopted. However, this data is still synchronised with the XMP property [photoshop:Category], and hence available for future use - but outside the IPTC Core. For migrating from Category codes to Subject Codes please read the Guideline for mapping Category Codes to Subject NewsCodes section below.

SUPPLEMENTAL_CATEGORIES

static final Property SUPPLEMENTAL_CATEGORIES

Deprecated.

As this metadata element was earmarked as deprecated already for IIM 4.1, it was not adopted. However, this data is still synchronised with the XMP property [photoshop:SupplementalCategories], and hence available for future use - but outside the IPTC Core.

ADDITIONAL_MODEL_INFO

static final Property ADDITIONAL_MODEL_INFO

Information about the ethnicity and other facets of the model(s) in a model-released image.

Use the Model Age field for the age of model(s).

ARTWORK_OR_OBJECT

static final Property ARTWORK_OR_OBJECT

A set of metadata about artwork or an object in the item

ORGANISATION_CODE

static final Property ORGANISATION_CODE

A set of metadata about artwork or an object in the item

CONTROLLED_VOCABULARY_TERM

static final Property CONTROLLED_VOCABULARY_TERM

A term to describe the content of the image by a value from a Controlled Vocabulary.

This property is part of the Photo Metadata 2008 specifications, but should not released to the public on the standard Adobe Custom Panels for IPTC metadata or other user interfaces unless agreed by the IPTC.

LOCATION_SHOWN

static final Property LOCATION_SHOWN

A location the content of the item is about. For photos that is a location shown in the image.

If the location the image was taken in is different from this location the property Location Created should be used too.

MODEL_AGE

static final Property MODEL_AGE

Age of the human model(s) at the time this image was taken in a model released image.

The user should be aware of any legal implications of providing ages for young models. Ages below 18 years should not be included.

ORGANISATION_NAME

static final Property ORGANISATION_NAME

Name of the organisation or company which is featured in the content.

May be supplemented by values from a controlled vocabulary in the Organisation Code field.

PERSON

static final Property PERSON

Name of a person the content of the item is about. For photos that is a person shown in the image.

DIGITAL_IMAGE_GUID

static final Property DIGITAL_IMAGE_GUID

Globally unique identifier for the item. It is created and applied by the creator of the item at the time of its creation . This value shall not be changed after that time.

The identifier will probably be generated by the technical means of an imaging device or software and should be applied to the digital image file as early as possible in its life cycle. This identifier does not identify any pictured content, particularly in case of a scan of non- digital images, only this digital representation.

Any algorithm to create this identifier has to comply with the technical requirements to create a globally unique id. Any device creating digital images - e.g. still image cameras, video cameras, scanners - should create such an identifer right at the time of the creation of the digital data and add the id to the set of metadata without compromising performance. It is recommended that this image identifier allows identifying the device by which the image data and the GUID were created. IPTC's basic requirements for unique ids are: - It must be globally unique. Algorithms for this purpose exist. - It should identify the camera body. - It should identify each individual photo from this camera body. - It should identify the date and time of the creation of the picture. - It should be secured against tampering. This field should be implemented in a way to prove it has not been changed since its value has been applied. If the identifier has been created by the imaging device its type and brand can be found in the Exif/technical metadata.

DIGITAL_SOURCE_FILE_TYPE

static final Property DIGITAL_SOURCE_FILE_TYPE

Deprecated.

The type of the source digital file.

The IPTC recommends not to implement this property any longer.

DIGITAL_SOURCE_TYPE

static final Property DIGITAL_SOURCE_TYPE

The type of the source of this digital image

EVENT

static final Property EVENT

Names or describes the specific event the content relates to.

Examples are: a press conference, dedication ceremony, etc. If this is a sub-event of a larger event both can be provided by the field: e.g. XXXIX Olympic Summer Games (Beijing): opening ceremony. Unplanned events could be named by this property too.

IMAGE_REGISTRY_ENTRY

static final Property IMAGE_REGISTRY_ENTRY

Both a Registry Item Id and a Registry Organisation Id to record any registration of this item with a registry.

Typically an id from a registry is negotiated and applied after the creation of the digital image.

Any user interface implementation must show both sub-properties - Item Id and Organisation Id - as corresponding values. Further an input to both fields should be made mandatory.

IMAGE_SUPPLIER

static final Property IMAGE_SUPPLIER

Identifies the most recent supplier of the item, who is not necessarily its owner or creator.

For identifying the supplier either a well known and/or registered company name or a URL of the company's web site may be used. This property succeeds the Provider property of IPTC Core 1.0 by its semantics as that Provider was renamed to Credit Line.

This is a PLUS version 1.2 property included in the IPTC Extension schema.

IMAGE_SUPPLIER_ID

static final Property IMAGE_SUPPLIER_ID

Identifies the most recent supplier of the item, who is not necessarily its owner or creator.

For identifying the supplier either a well known and/or registered company name or a URL of the company's web site may be used. This property succeeds the Provider property of IPTC Core 1.0 by its semantics as that Provider was renamed to Credit Line.

This is a PLUS version 1.2 property included in the IPTC Extension schema.

IMAGE_SUPPLIER_NAME

static final Property IMAGE_SUPPLIER_NAME

Identifies the most recent supplier of the item, who is not necessarily its owner or creator.

For identifying the supplier either a well known and/or registered company name or a URL of the company's web site may be used. This property succeeds the Provider property of IPTC Core 1.0 by its semantics as that Provider was renamed to Credit Line.

This is a PLUS version 1.2 property included in the IPTC Extension schema.

IMAGE_SUPPLIER_IMAGE_ID

static final Property IMAGE_SUPPLIER_IMAGE_ID

Optional identifier assigned by the Image Supplier to the image.

This is a PLUS version 1.2 property included in the IPTC Extension schema.

IPTC_LAST_EDITED

static final Property IPTC_LAST_EDITED

The date and optionally time when any of the IPTC photo metadata fields has been last edited

The public use of this property is deprecated by IPTC Extension version 1.1. It may only still be used by a private user interface for a use scoped to a company. If used this field should be a timestamp of the latest change applied to any of the fields.

The value of this property should never be set by software. XMP-aware software should reflect any changes to metadata by the xmp:MetadataDate property of the XMP Basic scheme.

LOCATION_CREATED

static final Property LOCATION_CREATED

The location the content of the item was created.

If the location in the image is different from the location the photo was taken the IPTC Extension property Location Shown in the Image should be used.

MAX_AVAIL_HEIGHT

static final Property MAX_AVAIL_HEIGHT

The maximum available height in pixels of the original photo from which this photo has been derived by downsizing.

MAX_AVAIL_WIDTH

static final Property MAX_AVAIL_WIDTH

The maximum available width in pixels of the original photo from which this photo has been derived by downsizing.

PLUS_VERSION

static final Property PLUS_VERSION

The version number of the PLUS standards in place at the time of the transaction.

This property was included into the IPTC Extension schema from PLUS version 1.2 as all other PLUS properties. To reflect this the value of "PLUS Version" should be set to the string "1.2.0"

COPYRIGHT_OWNER

static final Property COPYRIGHT_OWNER

Owner or owners of the copyright in the licensed image.

Serves to identify the rights holder/s for the image. The Copyright Owner, Image Creator and Licensor may be the same or different entities.

This is a PLUS version 1.2 property included in the IPTC Extension schema.

COPYRIGHT_OWNER_ID

static final Property COPYRIGHT_OWNER_ID

The ID of the owner or owners of the copyright in the licensed image.

Serves to identify the rights holder/s for the image. The Copyright Owner, Image Creator and Licensor may be the same or different entities.

This is a PLUS version 1.2 property included in the IPTC Extension schema.

COPYRIGHT_OWNER_NAME

static final Property COPYRIGHT_OWNER_NAME

The name of the owner or owners of the copyright in the licensed image.

Serves to identify the rights holder/s for the image. The Copyright Owner, Image Creator and Licensor may be the same or different entities.

This is a PLUS version 1.2 property included in the IPTC Extension schema.

IMAGE_CREATOR

static final Property IMAGE_CREATOR

Creator or creators of the image.

The creator can be additionally expressed in free-text using the IPTC Core Creator field. In many countries, the Image Creator must be attributed in association with any use of the image. The Image Creator, Copyright Owner, Image Supplier and Licensor may be the same or different entities.

This is a PLUS version 1.2 property included in the IPTC Extension schema.

IMAGE_CREATOR_ID

static final Property IMAGE_CREATOR_ID

The ID of the creator or creators of the image.

The creator can be additionally expressed in free-text using the IPTC Core Creator field. In many countries, the Image Creator must be attributed in association with any use of the image. The Image Creator, Copyright Owner, Image Supplier and Licensor may be the same or different entities.

This is a PLUS version 1.2 property included in the IPTC Extension schema.

IMAGE_CREATOR_NAME

static final Property IMAGE_CREATOR_NAME

The name of the creator or creators of the image.

The creator can be additionally expressed in free-text using the IPTC Core Creator field. In many countries, the Image Creator must be attributed in association with any use of the image. The Image Creator, Copyright Owner, Image Supplier and Licensor may be the same or different entities.

This is a PLUS version 1.2 property included in the IPTC Extension schema.

LICENSOR

static final Property LICENSOR

A person or company that should be contacted to obtain a licence for using the item or who has licensed the item.

This is a PLUS version 1.2 property included in the IPTC Extension schema.

LICENSOR_ID

static final Property LICENSOR_ID

The ID of the person or company that should be contacted to obtain a licence for using the item or who has licensed the item.

This is a PLUS version 1.2 property included in the IPTC Extension schema.

LICENSOR_NAME

static final Property LICENSOR_NAME

The name of the person or company that should be contacted to obtain a licence for using the item or who has licensed the item.

This is a PLUS version 1.2 property included in the IPTC Extension schema.

LICENSOR_CITY

static final Property LICENSOR_CITY

The city of a person or company that should be contacted to obtain a licence for using the item or who has licensed the item.

This is a PLUS version 1.2 property included in the IPTC Extension schema.

LICENSOR_COUNTRY

static final Property LICENSOR_COUNTRY

The country of a person or company that should be contacted to obtain a licence for using the item or who has licensed the item.

This is a PLUS version 1.2 property included in the IPTC Extension schema.

LICENSOR_EMAIL

static final Property LICENSOR_EMAIL

The email of a person or company that should be contacted to obtain a licence for using the item or who has licensed the item.

This is a PLUS version 1.2 property included in the IPTC Extension schema.

LICENSOR_EXTENDED_ADDRESS

static final Property LICENSOR_EXTENDED_ADDRESS

The extended address of a person or company that should be contacted to obtain a licence for using the item or who has licensed the item.

This is a PLUS version 1.2 property included in the IPTC Extension schema.

LICENSOR_POSTAL_CODE

static final Property LICENSOR_POSTAL_CODE

The postal code of a person or company that should be contacted to obtain a licence for using the item or who has licensed the item.

This is a PLUS version 1.2 property included in the IPTC Extension schema.

LICENSOR_REGION

static final Property LICENSOR_REGION

The region of a person or company that should be contacted to obtain a licence for using the item or who has licensed the item.

This is a PLUS version 1.2 property included in the IPTC Extension schema.

LICENSOR_STREET_ADDRESS

static final Property LICENSOR_STREET_ADDRESS

The street address of a person or company that should be contacted to obtain a licence for using the item or who has licensed the item.

This is a PLUS version 1.2 property included in the IPTC Extension schema.

LICENSOR_TELEPHONE_1

static final Property LICENSOR_TELEPHONE_1

The phone number of a person or company that should be contacted to obtain a licence for using the item or who has licensed the item.

This is a PLUS version 1.2 property included in the IPTC Extension schema.

LICENSOR_TELEPHONE_2

static final Property LICENSOR_TELEPHONE_2

The phone number of a person or company that should be contacted to obtain a licence for using the item or who has licensed the item.

This is a PLUS version 1.2 property included in the IPTC Extension schema.

LICENSOR_URL

static final Property LICENSOR_URL

The URL of a person or company that should be contacted to obtain a licence for using the item or who has licensed the item.

This is a PLUS version 1.2 property included in the IPTC Extension schema.

MINOR_MODEL_AGE_DISCLOSURE

static final Property MINOR_MODEL_AGE_DISCLOSURE

Age of the youngest model pictured in the image, at the time that the image was made.

This age should not be displayed to the public on open web portals and the like. But it may be used by image repositories in a B2B enviroment.

This is a PLUS version 1.2 property included in the IPTC Extension schema.

MODEL_RELEASE_ID

static final Property MODEL_RELEASE_ID

Optional identifier associated with each Model Release.

This is a PLUS version 1.2 property included in the IPTC Extension schema.

MODEL_RELEASE_STATUS

static final Property MODEL_RELEASE_STATUS

Summarizes the availability and scope of model releases authorizing usage of the likenesses of persons appearing in the photograph.

It is recommended to apply the PLUS controlled value Unlimited Model Releases (MR- UMR) very carefully and to check the wording of the model release thoroughly before applying it.

This is a PLUS version 1.2 property included in the IPTC Extension schema.

PROPERTY_RELEASE_ID

static final Property PROPERTY_RELEASE_ID

Optional identifier associated with each Property Release.

This is a PLUS version 1.2 property included in the IPTC Extension schema.

PROPERTY_RELEASE_STATUS

static final Property PROPERTY_RELEASE_STATUS

Summarises the availability and scope of property releases authorizing usage of the properties appearing in the photograph.

It is recommended to apply the value PR-UPR very carefully and to check the wording of the property release thoroughly before applying it.

This is a PLUS version 1.2 property included in the IPTC Extension schema.

ARTWORK_OR_OBJECT_DETAIL_COPYRIGHT_NOTICE

static final Property ARTWORK_OR_OBJECT_DETAIL_COPYRIGHT_NOTICE

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.

ARTWORK_OR_OBJECT_DETAIL_CREATOR

static final Property ARTWORK_OR_OBJECT_DETAIL_CREATOR

Contains the name of the artist who has created artwork or an object in the image.

ARTWORK_OR_OBJECT_DETAIL_DATE_CREATED

static final Property ARTWORK_OR_OBJECT_DETAIL_DATE_CREATED

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.

ARTWORK_OR_OBJECT_DETAIL_SOURCE

static final Property ARTWORK_OR_OBJECT_DETAIL_SOURCE

The organisation or body holding and registering the artwork or object in the image for inventory purposes.

ARTWORK_OR_OBJECT_DETAIL_SOURCE_INVENTORY_NUMBER

static final Property ARTWORK_OR_OBJECT_DETAIL_SOURCE_INVENTORY_NUMBER

The inventory number issued by the organisation or body holding and registering the artwork or object in the image.

ARTWORK_OR_OBJECT_DETAIL_TITLE

static final Property ARTWORK_OR_OBJECT_DETAIL_TITLE

A reference for the artwork or object in the image.

LOCATION_SHOWN_CITY

static final Property LOCATION_SHOWN_CITY

Name of the city of a location. This element is at the fourth level of a top-down geographical hierarchy.

LOCATION_SHOWN_COUNTRY_CODE

static final Property LOCATION_SHOWN_COUNTRY_CODE

The ISO code of a country of a location. This element is at the second level of a top-down geographical hierarchy.

Note 1: an implementer would have to derive from the length of the value string whether this is the country code from the two or three letter scheme as no explicit indication can be provided.

LOCATION_SHOWN_COUNTRY_NAME

static final Property LOCATION_SHOWN_COUNTRY_NAME

The name of a country of a location. This element is at the second level of a top-down geographical hierarchy.

LOCATION_SHOWN_PROVINCE_OR_STATE

static final Property LOCATION_SHOWN_PROVINCE_OR_STATE

The name of a subregion of a country - a province or state - of a location. This element is at the third level of a top-down geographical hierarchy.

LOCATION_SHOWN_SUBLOCATION

static final Property LOCATION_SHOWN_SUBLOCATION

Name of a sublocation. This sublocation name could either be the name of a sublocation to a city or the name of a well known location or (natural) monument outside a city. In the sense of a sublocation to a city this element is at the fifth level of a top-down geographical hierarchy.

LOCATION_SHOWN_WORLD_REGION

static final Property LOCATION_SHOWN_WORLD_REGION

The name of a world region of a location. This element is at the first (topI) level of a top- down geographical hierarchy.

LOCATION_CREATED_CITY

static final Property LOCATION_CREATED_CITY

Name of the city of a location. This element is at the fourth level of a top-down geographical hierarchy.

LOCATION_CREATED_COUNTRY_CODE

static final Property LOCATION_CREATED_COUNTRY_CODE

The ISO code of a country of a location. This element is at the second level of a top-down geographical hierarchy.

Note 1: an implementer would have to derive from the length of the value string whether this is the country code from the two or three letter scheme as no explicit indication can be provided.

LOCATION_CREATED_COUNTRY_NAME

static final Property LOCATION_CREATED_COUNTRY_NAME

The name of a country of a location. This element is at the second level of a top-down geographical hierarchy.

LOCATION_CREATED_PROVINCE_OR_STATE

static final Property LOCATION_CREATED_PROVINCE_OR_STATE

The name of a subregion of a country - a province or state - of a location. This element is at the third level of a top-down geographical hierarchy.

LOCATION_CREATED_SUBLOCATION

static final Property LOCATION_CREATED_SUBLOCATION

Name of a sublocation. This sublocation name could either be the name of a sublocation to a city or the name of a well known location or (natural) monument outside a city. In the sense of a sublocation to a city this element is at the fifth level of a top-down geographical hierarchy.

LOCATION_CREATED_WORLD_REGION

static final Property LOCATION_CREATED_WORLD_REGION

The name of a world region of a location. This element is at the first (topI) level of a top- down geographical hierarchy.

REGISTRY_ENTRY_CREATED_ITEM_ID

static final Property REGISTRY_ENTRY_CREATED_ITEM_ID

A unique identifier created by a registry and applied by the creator of the item. This value shall not be changed after being applied. This identifier is linked to a corresponding Registry Organisation Identifier.

REGISTRY_ENTRY_CREATED_ORGANISATION_ID

static final Property REGISTRY_ENTRY_CREATED_ORGANISATION_ID

An identifier for the registry which issued the corresponding Registry Image Id.

PROPERTY_GROUP_IPTC_CORE

static final Property[] PROPERTY_GROUP_IPTC_CORE

PROPERTY_GROUP_IPTC_EXT

static final Property[] PROPERTY_GROUP_IPTC_EXT