# description
A news item as JSON object -- copyright 2025 IPTC - International Press Telecommunications Council - www.iptc.org - This document is published under the Creative Commons Attribution 4.0 license, see  http://creativecommons.org/licenses/by/4.0/

# properties.uri.description
The identifier for this news object. nar:newsItem@guid

# properties.type.description
The generic news type of this news object. (Value 'component' added in version 1.2 as issue #21.). nar:itemClass

# properties.mimetype.description
A MIME type which applies to this news object. nar:contentType

# properties.representationtype.description
Indicates how complete this representation of a news item is. No mapping to nar. Specific for ninjs.

# properties.profile.description
An identifier for the structure of the news object. This can be any string but we suggest something identifying the structure of the content such as 'text-only' or 'text-photo'. Profiles are typically provider-specific. nar:profile

# properties.version.description
The version of the news object which is identified by the uri property. nar:newsItem@version

# properties.firstcreated.description
Indicates when the first version of the item was created. (Added in version 1.2 from issue #5). nar:firstCreated

# properties.versioncreated.description
The date and time when this version of the news object was created. nar:versionCreated

# properties.contentcreated.description
The date and time when the content of this ninjs object was originally created. For example an old photo that is now handled as a ninjs object. nar:contentCreated (Added in 1.4)

# properties.embargoed.description
The date and time before which all versions of the news object are embargoed. If absent, this object is not embargoed. nar:embargoed

# properties.pubstatus.description
The publishing status of the news object, its value is *usable* by default. nar:pubStatus

# properties.urgency.description
The editorial urgency of the content from 1 to 9. 1 represents the highest urgency, 9 the lowest. nar:urgency

# properties.copyrightholder.description
The person or organisation claiming the intellectual property for the content. nar:copyrightHolder

# properties.copyrightnotice.description
Any necessary copyright notice for claiming the intellectual property for the content. nar:copyrightNotice

# properties.usageterms.description
A natural-language statement about the usage terms pertaining to the content. nar:usageTerms

# properties.ednote.description
A note that is intended to be read by internal staff at the receiving organisation, but not published to the end-user. (Added in version 1.2 from issue #6.) . ednote: nar:edNote

# properties.language.description
The human language used by the content. The value should follow IETF BCP47. nar:language

# properties.person.items.properties.rel.description
The relationship of the content of the news object to the person

# properties.person.items.properties.scheme.description
The identifier of a scheme (= controlled vocabulary) which includes a code for the person

# properties.person.items.properties.code.description
The code for the person in a scheme (= controlled vocabulary) which is identified by the scheme property

# properties.organisation.description
An administrative and functional structure which may act as a business, as a political party or not-for-profit party. nar:subject

# properties.organisation.items.properties.rel.description
The relationship of the content of the news object to the organisation

# properties.organisation.items.properties.scheme.description
The identifier of a scheme (= controlled vocabulary) which includes a code for the organisation

# properties.organisation.items.properties.code.description
The code for the organisation in a scheme (= controlled vocabulary) which is identified by the scheme property

# properties.organisation.items.properties.symbols.description
Symbols used for a financial instrument linked to the organisation at a specific market place

# properties.organisation.items.properties.symbols.items.properties.ticker.description
Ticker symbol used for the financial instrument

# properties.organisation.items.properties.symbols.items.properties.exchange.description
Identifier for the marketplace which uses the ticker symbols of the ticker property

# properties.organisation.items.properties.symbols.items.properties.symbol.description
Compare with hasInstrument in NewsML-G2. Same as symbol in G2.

# properties.place.items.properties.rel.description
The relationship of the content of the news object to the place

# properties.place.items.properties.scheme.description
The identifier of a scheme (= controlled vocabulary) which includes a code for the place

# properties.place.items.properties.code.description
The code for the place in a scheme (= controlled vocabulary) which is identified by the scheme property

# properties.place.items.patternProperties.^geometry_[a-zA-Z0-9_]+.description
An object holding geo data of this place. Could be of any relevant geo data JSON object definition.

# properties.subject.description
A concept with a relationship to the content. nar:subject

# properties.subject.items.properties.rel.description
The relationship of the content of the news object to the subject

# properties.subject.items.properties.scheme.description
The identifier of a scheme (= controlled vocabulary) which includes a code for the subject

# properties.subject.items.properties.code.description
The code for the subject in a scheme (= controlled vocabulary) which is identified by the scheme property

# properties.subject.items.properties.creator.description
Specifies which entity (person, organisation or system) that has created or last edited the property.

# properties.subject.items.properties.relevance.description
The relevance of the metadata to the news content to which it is attached.

# properties.subject.items.properties.confidence.description
The confidence with which the metadata has been assigned.

# properties.event.description
Something which happens in a planned or unplanned manner. nar:?

# properties.event.items.properties.rel.description
The relationship of the content of the news object to the event

# properties.event.items.properties.scheme.description
The identifier of a scheme (= controlled vocabulary) which includes a code for the event

# properties.event.items.properties.code.description
The code for the event in a scheme (= controlled vocabulary) which is identified by the scheme property

# properties.object.items.properties.rel.description
The relationship of the content of the news object to the object

# properties.object.items.properties.scheme.description
The identifier of a scheme (= controlled vocabulary) which includes a code for the object

# properties.object.items.properties.code.description
The code for the object in a scheme (= controlled vocabulary) which is identified by the scheme property

# properties.infosource.description
A party (person or organisation) which originated, modified, enhanced, distributed, aggregated or supplied the content or provided some information used to create or enhance the content. (Added in version 1.2 according to issue #15.) .    infosource:  nar:infoSource

# properties.infosource.items.properties.rel.description
The relationship of the content of the news object to the infosource

# properties.infosource.items.properties.scheme.description
The identifier of a scheme (= controlled vocabulary) which includes a code for the infosource

# properties.infosource.items.properties.code.description
The code for the infosource in a scheme (= controlled vocabulary) which is identified by the scheme property

# properties.title.description
A short natural-language name for the item. (Added in version 1.2 according to issue #9). nar:itemMeta/title

# properties.byline.description
The name(s) of the creator(s) of the content. nar:by

# properties.headline.description
A brief and snappy introduction to the content, designed to catch the reader's attention. nar:headline

# properties.slugline.description
A human-readable identifier for the item. (Added in version 1.2 from issue #4.). nar:slugline

# properties.located.description
The name of the location from which the content originates. nar:located

# properties.charcount.description
The total character count in the article excluding figure captions. (Added in version 1.2 according to issue #27.). nar:charcount

# properties.wordcount.description
The total number of words in the article excluding figure captions. (Added in version 1.2 according to issue #27.). nar:wordcount

# properties.renditions.description
Wrapper for different renditions of the news object. nar:remoteContent

# properties.renditions.patternProperties.^[a-zA-Z0-9_]+.description
A specific rendition of the content of the news object. (Description changed in version 1.2 according to issue #17.)

# properties.renditions.patternProperties.^[a-zA-Z0-9_]+.properties.href.description
The URL for accessing the rendition as a resource. nar:remoteContent@ref

# properties.renditions.patternProperties.^[a-zA-Z0-9_]+.properties.mimetype.description
A MIME type which applies to the rendition. nar:remoteContent@contenttype

# properties.renditions.patternProperties.^[a-zA-Z0-9_]+.properties.title.description
A title for the link to the rendition resource

# properties.renditions.patternProperties.^[a-zA-Z0-9_]+.properties.height.description
For still and moving images: the height of the display area measured in pixels. nar:remoteContent@height

# properties.renditions.patternProperties.^[a-zA-Z0-9_]+.properties.width.description
For still and moving images: the width of the display area measured in pixels. nar:remoteContent@width

# properties.renditions.patternProperties.^[a-zA-Z0-9_]+.properties.sizeinbytes.description
The size of the rendition resource in bytes

# properties.renditions.patternProperties.^[a-zA-Z0-9_]+.properties.duration.description
The total time duration of the content in seconds. (Added in version 1.2. Issue #18). nar:remoteContent@duration

# properties.renditions.patternProperties.^[a-zA-Z0-9_]+.properties.format.description
A refinement of a generic content type (i.e. IANA MIME type) by a literal string value. (Added in version 1.2. Issue #18). nar:remoteContent@contenttypevariant and nar:remoteContent@format

# properties.associations.description
Content of news objects which are associated with this news object. nar:link

# properties.altids.description
Alternative identifiers of the item. It is up to the individual provider to name and set type on the alternative identifiers they like to use. nar:altId issue #3. (Added in version 1.3)

# properties.trustindicator.description
An array of objects to allow links to documents about trust indicators. (nar:link) issue #44. (Added in version 1.3)

# properties.trustindicator.items.properties.scheme.description
The identifier of a scheme (= controlled vocabulary) which includes a code for the trust indicator

# properties.trustindicator.items.properties.code.description
The code for the trust indicator in a scheme (= controlled vocabulary) which is identified by the scheme property

# properties.trustindicator.items.properties.title.description
The title of the resource being referenced.

# properties.trustindicator.items.properties.href.description
The URL for accessing the trust indicator resource.

# properties.$standard.description
An object with information about standard, version and schema this instance is valid against. nar:standard, nar:standardversion and xml:schema issue #43. (Added in version 1.3)

# properties.$standard.properties.schema.description
The uri of the json schema to use for validation.

# properties.genre.description
A nature, intellectual or journalistic form of the content. nar:genre. (Added in version 1.3)

# properties.genre.items.properties.scheme.description
The identifier of a scheme (= controlled vocabulary) which includes a code for the genre. Normally  http://cv.iptc.org/newscodes/genre/

# properties.genre.items.properties.code.description
The code for the genre in a scheme (= controlled vocabulary) which is identified by the scheme property

# properties.expires.description
The date and time after which the Item is no longer considered editorially relevant by its provider. nar:expires (Added in 1.4)

# properties.rightsinfo.description
Expression of rights to be applied to content. nar:rightsInfo (Added in 1.4)

# properties.rightsinfo.properties.langid.description
Identifier for the Rights Expression language used. nar:@langid

# properties.rightsinfo.properties.linkedrights.description
A link from the current Item to Web resource with rights related information. nar:link

# properties.rightsinfo.properties.encodedrights.description
Contains a rights expression as defined by a Rights Expression Language. nar:rightsExpressionXML or nar:rightsExpressionData

# properties.digitalsourcetype.description
Indicates the type of the source of this content

# properties.digitalsourcetype.properties.uri.description
The identifier of the digital source type as a complete URI. Suggested CV: http://cv.iptc.org/newscodes/digitalsourcetype/

# properties.digitalsourcetype.properties.literal.description
An identifier for the digital source type as a free-text string.

# patternProperties.^description_[a-zA-Z0-9_]+.description
A free-form textual description of the content of the item. (The string appended to description_ in the property name should reflect the format and/or the purpose of the text, separating the parts with _). nar:description

# patternProperties.^body_[a-zA-Z0-9_]+.description
The textual content of the news object. (The string appended to body_ in the property name should reflect the format and/or the purpose of the text, separating the parts with _). nar:inlineData or nar:inlineXML

# patternProperties.^headline_[a-zA-Z0-9_]+.description
Additional headlines or strings of that type can be handled here. This is not replacing the main headline-property in ninjs. (The string appended to headline_ in the property name should reflect the format and/or the purpose of the text, separating the parts with _) nar:headline with roles issue #13. (Added in 1.3)

# definitions.contactinfoType.properties.type.description
Type would be method of communication like phone, mobile, address etc.

# definitions.contactinfoType.properties.role.description
Role refers to type and could be private, office etc

# definitions.contactinfoType.properties.lang.description
If this contactinfo object need to be qualified with what language it is in. The value should follow IETF BCP47.

# definitions.contactinfoType.properties.name.description
Human readable name of the contact method, like name for a web page, name of persons twitter account etc

# definitions.contactinfoType.properties.value.description
Actual phone number, email address, web url etc.

# definitions.contactinfoType.properties.address.description
The address of a person, place or organisation.

# definitions.contactinfoType.properties.address.properties.lines.description
An array of lines to construct an address. The order is important to construct a correct address.

# definitions.contactinfoType.properties.address.properties.locality.description
A city/town/village etc. part of the address.

# definitions.contactinfoType.properties.address.properties.area.description
A subdivision of a country part of the address.