ISCC Terms¶
Mapped Terms¶
The following terms used in the ISCC metadata vocabulary are mapped to equivalents in other schemas. We added comments to the original term descriptions to clarify the definition in context with ISCC metadata.
name¶
The name of the item.
Comment: The title or name of the intangible creation manifested by the identified digital content. Used as input for ISCC Meta-Code generation.
Embedding: Use Iptc.Application2.Headline and Xmp.photoshop.Headline for image embedding
Standard: ISO 24138:2024
Status: stable
description¶
http://schema.org/disambiguatingDescription
A sub property of description. A short description of the item used to disambiguate from other, similar items. Information from other properties (in particular, name) may be necessary for the description to be useful for disambiguation.
Comment: Description of the digital content identified by the ISCC. Used as input for ISCC Meta-Code generation. Any user presentable text string (including Markdown text) indicative of the identity of the referent may be used.
Embedding: Use Exif.Image.ImageDescription, Iptc.Application2.Caption and Xmp.dc.description for image embedding.
Standard: ISO 24138:2024
Status: stable
creator¶
The creator/author of this CreativeWork. This is the same as the Author property for CreativeWork.
Comment: An entity primarily responsible for making the resource.
Embedding: Use Exif.Image.Artist, Iptc.Application2.Byline and Xmp.dc.creator for emedding this field into image metadata.
Status: draft
license¶
A license document that applies to this content, typically indicated by URL.
Comment: URI of license for the identified digital content.
Embedding: Use Xmp.xmpRights.WebStatement for embedding as image metadata.
Status: stable
acquire¶
http://schema.org/acquireLicensePage
Indicates a page documenting how licenses can be purchased or otherwise acquired, for the current item.
Comment: This field must contain a valid URL referring to a page showing information about how one can acquire a license for the item. This may be a page of a web shop or NFT marketplace ready for providing a license.
Embedding: Use Xmp.plus.Licensor[1]/plus:LicensorURL for embedding in images.
Status: stable
credit¶
Text that can be used to credit person(s) and/or organization(s) associated with a published Creative Work.
Comment: A line of text that you expect users of the image (such as Google Images) to display alongside the image.
Embedding: Use Iptc.Application2.Credit and Xmp.photoshop.Credit for metadata embedding.
Status: draft
rights¶
http://schema.org/copyrightNotice
Text of a notice appropriate for describing the copyright aspects of this Creative Work, ideally indicating the owner of the copyright for the Work.
Comment: Contains any necessary copyright notice and should identify the current owner of the copyright of this work with associated intellectual property rights.
Embedding: Use Exif.Image.Copyright, Iptc.Application2.Copyright and Xmp.dc.rights for embedding.
Status: draft
image¶
An image of the item. This can be a URL or a fully described ImageObject.
Comment: URI for a user-presentable image that serves as a preview of the digital content. The URI may be a Data-URL RFC2397. If ISCC metadata is used as NFT metadata according to ERC-721 or ERC-1155 the URI should reference the actual digital content represented by the NFT.
Status: draft
identifier¶
The identifier property represents any kind of identifier for any kind of Thing, such as ISBNs, GTIN codes, UUIDs etc. Schema.org provides dedicated properties for representing many of these, either as textual strings or as URL (URI) links. See background notes for more details.
Comment: Other identifier(s) referencing the work, product or other abstraction of which the referenced digital content is a full or partial manifestation. Accepts a bare string, a typed Identifier object, or a list mixing both forms.
Standard: ISO 24138:2024
Status: draft
content¶
Actual bytes of the media object, for example the image file or video file.
Comment: URI of the digital content that was used to create this ISCC.
Status: draft
keywords¶
Keywords or tags used to describe this content. Multiple entries in a keywords list are typically delimited by commas.
Comment: Keywords or tags used to describe this content. Either a list of keywords or a string with comma separated keywords.
Standard: ISO 24138:2024
Status: stable
form¶
http://schema.org/additionalType
An additional type for the item, typically used for adding more specific types from external vocabularies in microdata syntax. This is a relationship between something and a class that the thing is in.
Comment: The form or kind of content identified, using a Schema.org CreativeWork subtype. While @type provides a coarse modality classification (text, image, audio, video) and mode/mediatype describe technical aspects, form captures what the content is — a book, scholarly article, presentation, report, photograph, etc.
Status: draft
version¶
The version of the digital content identified by the ISCC.
Comment: The version of the CreativeWork embodied by a specified resource.
Status: draft
created¶
The date on which the CreativeWork was created or the item was added to a DataFeed.
Comment: Datetime the ISCC was created for the item.
filesize¶
Size of the application / package (e.g. 18MB). In the absence of a unit (MB, KB etc.), KB will be assumed.
Comment: File size of media asset in number of bytes.
Standard: ISO 24138:2024
Status: stable
mediatype¶
http://schema.org/encodingFormat
Media type typically expressed using a MIME format (see IANA site and MDN reference) e.g. application/zip for a SoftwareApplication binary, audio/mpeg for .mp3 etc.). In cases where a CreativeWork has several media type representations, encoding can be used to indicate each MediaObject alongside particular encodingFormat information. Unregistered or niche encoding and file formats can be indicated instead via the most appropriate URL, e.g. defining Web page or a Wikipedia/Wikidata entry.
Comment: An IANA Media Type (MIME type)
Standard: ISO 24138:2024
Status: stable
duration¶
The duration of the item (movie, audio recording, event, etc.) in ISO 8601 date format.
Comment: Duration of audio-visual media in seconds.
Standard: ISO 24138:2024
Status: stable
pages¶
http://schema.org/numberOfPages
The number of pages in the book.
Comment: Number of pages (for paged documents only)
Status: draft
language¶
The language of the content or performance or used in an action. Please use one of the language codes from the IETF BCP 47 standard. See also availableLanguage.
Comment: Language(s) of content BCP 47.
Standard: ISO 24138:2024
Status: stable
thumbnail¶
http://schema.org/thumbnailUrl
A thumbnail image relevant to the Thing.
Comment: URI of an autogenerated user-presentable thumbnail-image that serves as a preview of the digital content. The URI may be a Data-URL RFC2397.
Standard: ISO 24138:2024
Status: stable
credentials¶
https://www.w3.org/2018/credentials#VerifiableCredential
A credential is a set of one or more claims made by an issuer. A verifiable credential is a tamper-evident credential that has authorship that can be cryptographically verified. Verifiable credentials can be used to build verifiable presentations, which can also be cryptographically verified. The claims in a credential can be about different subjects.
Comment: One or more Verifiable Credentials or one or more URIs pointing to one or more VCs. A reader of ISCC metadata must interpret the value according to the following rules
- If the value is a JSON
stringinterpret it as an URI. The expectation is that the URI dereferences to a response with Content-typeapplication/jsonwhere the data is a VC or anarrayof VCs. - If the value is a JSON
objectinterpret it as a VC according to the Verifiable Credentials JSON Schema. - If the value is an
arrayand an item in thearrayis a JSONobjectinterpret it as a VC. - If the value is an
arrayand an items is astringinterpret the item as an URI that dereferences to VC(s) - Credentials should only be taken into account if the
credentialSubjectmatches with the declarer (e.g.did:pkhrepresentation of the declarers address).
Status: draft
ISCC Terms¶
The ISCC metadata introduces the following additional properties specific to ISCC use-cases.
iscc¶
http://purl.org/iscc/terms/#iscc
An ISCC-CODE in canonical representation. A valid ISCC Metadata object should include at least one of the iscc, iscc_id, or iscc_code fields.
Standard: ISO 24138:2024
Status: stable
meta¶
http://purl.org/iscc/terms/#meta
Subject, industry, or use-case specific metadata encoded as Data-URL.
Standard: ISO 24138:2024
Status: stable
media_id¶
http://purl.org/iscc/terms/#media_id
Vendor specific (internal) identifier for the source media file.
Status: draft
iscc_id¶
http://purl.org/iscc/terms/#iscc_id
The ISCC-ID of the digital content in canonical representation. A valid ISCC Metadata object should include at least one of the iscc, iscc_id, or iscc_code fields.
Status: stable
iscc_code¶
http://purl.org/iscc/terms/#iscc
A composite ISCC-CODE in canonical representation. Explicit alternative to the more compact iscc field. A valid ISCC Metadata object should include at least one of the iscc, iscc_id, or iscc_code fields.
Status: stable
previous¶
genai¶
http://purl.org/iscc/terms/#genai
Machine-readable generative AI disclosure signals for content transparency. Omitted fields indicate that the disclosure status has not been determined.
Status: draft
mode¶
filename¶
http://purl.org/iscc/terms/#filename
Filename of the referenced digital content (automatically used as fallback if the name field was not specified for ISCC processing)
Standard: ISO 24138:2024
Status: stable
datasize¶
http://purl.org/iscc/terms/#datasize
Size of the data processed for ISCC generation in number of bytes. Use this field when the ISCC is computed over data that is not a standalone file, such as an individual plane within a bioimage, a scene within a multi-scene container, or a data stream extracted from a composite format.
Status: draft
fps¶
http://purl.org/iscc/terms/#fps
Frames per second of video assets.
Standard: ISO 24138:2024
Status: stable
width¶
http://purl.org/iscc/terms/#width
Width of visual media in number of pixels.
Standard: ISO 24138:2024
Status: stable
height¶
http://purl.org/iscc/terms/#height
Height of visual media in number of pixels.
Standard: ISO 24138:2024
Status: stable
characters¶
http://purl.org/iscc/terms/#characters
Number of text characters (code points after Unicode normalization)
Standard: ISO 24138:2024
Status: stable
parts¶
http://purl.org/iscc/terms/#parts
Indicates items that are part of this item via Content-Codes (inverse-property belongs).
Status: draft
part_of¶
http://purl.org/iscc/terms/#part_of
Indicates that this item is part of other items via their Content-Code.
Status: draft
features¶
units¶
http://purl.org/iscc/terms/#units
Individual ISCC-UNITs that make up a composite ISCC-CODE.
Status: draft
generator¶
http://purl.org/iscc/terms/#generator
Name and version of the software that generated the ISCC
Status: stable
text¶
external_url¶
http://purl.org/iscc/terms/#external_url
This is the URL that will appear below the asset's image on some NFT Marketplaces and will allow users to leave the site and view the item on your site. Supports URI template (iscc-id).
Status: draft
animation_url¶
http://purl.org/iscc/terms/#animation_url
A URL to a multi-media attachment for the item.
Status: draft
properties¶
http://purl.org/iscc/terms/#properties
Arbitrary properties. Values may be strings, numbers, object or arrays. Properties defined here may show up on NFT marketplaces. See ERC-1155
Status: draft
attributes¶
http://purl.org/iscc/terms/#attributes
Similar to properties but as an array of objects. These attributes will show up on some NFT marketplaces.
Status: draft
nft¶
http://purl.org/iscc/terms/#nft
A unique URI for a non-fungible token of the identified content. The URI must contain references to the blockchain, smart-contract and token. The recommended schemes are CAIP-22 and CAIP-29.
Status: draft
tophash¶
http://purl.org/iscc/terms/#tophash
A Multihash of the concatenation (binding) of metahash and datahash (default blake3).
Standard: ISO 24138:2024
Status: draft
metahash¶
http://purl.org/iscc/terms/#metahash
A Multiformats multihash or IPFS CIDv1 of the supplied metadata. The hash is created from name and description fields or meta if supplied.
Standard: ISO 24138:2024
Status: stable
datahash¶
http://purl.org/iscc/terms/#datahash
A Multihash of the digital content (default blake3).
Standard: ISO 24138:2024
Status: stable
nonce¶
http://purl.org/iscc/terms/#nonce
Cryptographic nonce for replay protection. A 128-bit random value encoded as lowercase hexadecimal.
Status: stable
signature¶
http://purl.org/iscc/terms/#signature
Cryptographic signature over ISCC metadata, conforming to the iscc-crypto signing protocol. Uses EdDSA (Ed25519) with JCS canonicalization.
Status: stable
original¶
http://purl.org/iscc/terms/#original
The signee of the declaring transaction claims to be the original creator of the work manifested by the identified digital content.
Status: stable
redirect¶
http://purl.org/iscc/terms/#redirect
URL to which an ISCC resolver should redirect the ISCC-ID. Supports URI template (iscc-id)
Status: stable
chain¶
wallet¶
verifications¶
http://purl.org/iscc/terms/#verifications
A list of self-verifications. Self-verifications are public URLs under the account/authority of the signee. The verification URL must respond to a GET request with text that contains a multihash of the ISCC declaration signees wallet address in the format of verify:<multihash-of-wallet-address>:verify.
Status: draft
Seed Metadata Terms¶
Terms used in industry-specific seed metadata schemas for interoperable Meta-Code generation. See IEP-0002 for details.
isbn¶
International Standard Book Number in 13-digit format, without spaces or hyphens.
productform¶
http://purl.org/iscc/terms/#productform
Product form code indicating the medium and format of the publication (ONIX codelist 150).
title¶
The title of the publication.
language¶
ISO 639-2/B three-letter language code.
imprint¶
http://schema.org/publisherImprint
The brand name under which the publication is published.
publisher¶
The person or organization that owns the imprint at the date of publication.
country¶
http://schema.org/countryOfOrigin
Country of publication in accordance with ISO 3166-1 alpha-2 country codes.
pubdate¶
http://schema.org/datePublished
The date of first publication under this ISBN in ISO 8601 basic format (YYYYMMDD).
isrc¶
The International Standard Recording Code assigned to this recording.
main_artist¶
The name of the featured artist or band.
track_title¶
The title of the recording.
version_title¶
http://schema.org/alternativeHeadline
Additional information about the recording, such as 'live' or 'remastered'.
duration¶
The elapsed playing time of the recording in seconds.
doi¶
http://purl.org/ontology/bibo/doi
Digital Object Identifier of the work, lowercased, in bare prefix form (without the https://doi.org/ resolver prefix).
resource_type¶
http://schema.org/additionalType
The kind of research output as a readable token. Tokens follow the DataCite resource-type vocabulary and are populated from the Crossref/DataCite work type (for example, journal-article maps to JournalArticle). Each token is mapped to a resolvable schema.org or FaBiO class IRI in the JSON-LD context (see x-iscc-enum-context). This is the work-kind axis; version_type is the orthogonal version-stage axis.
pubyear¶
http://schema.org/datePublished
Year of publication. Crossref guarantees year-level precision only; using an integer avoids the false precision of a full date.
version_type¶
http://purl.org/iscc/terms/#version_type
Manifestation version using the NISO JAV (RP-8-2008) vocabulary. Publisher-specific version taxonomies are mapped into these values. Lets a Version-of-Record and an Accepted-Manuscript of the same work produce different Meta-Codes while a shared work-level doi links them.
container_title¶
http://prismstandard.org/namespaces/basic/2.0/publicationName
Title of the serial or collection the work is part of (journal, proceedings, book). Not guaranteed for standalone works.
issn¶
ISSN of the container serial. Only present for serial publications.
Service Metadata Terms¶
Terms used in use-case-specific service metadata schemas served by ISCC registries.
TDM¶
http://purl.org/iscc/terms/#TDM
Machine-readable TDM rights signals conformant with W3C TDMRep, providing content-addressed delivery of tdm-reservation and tdm-policy properties via ISCC. Designed for content identification and discovery where identity, provenance, and trust context complement the reservation signal.
tdm_reservation¶
http://www.w3.org/ns/tdmrep#reservation
Blanket TDM reservation flag, semantically equivalent to W3C TDMRep tdm-reservation. 1 = rights reserved (EU DSM Art. 4 opt-out), 0 = not reserved, absent = undeclared.
Status: stable
tdm_policy¶
http://www.w3.org/ns/tdmrep#policy
URL of a TDM Policy document (typically a JSON-LD ODRL Offer profiling TDMRep). Semantically equivalent to W3C TDMRep tdm-policy.
GenAI¶
http://purl.org/iscc/terms/#GenAI
Machine-readable generative AI disclosure signals for content transparency. Designed for AI providers to declare the level of AI involvement in content creation, supporting compliance with transparency regulations (e.g., EU AI Act Art. 50) and enabling end users to verify AI-generated content. These signals are designed for use within content identification and discovery protocols that provide additional identity, provenance, and trust context.
involvement¶
http://purl.org/iscc/terms/#involvement
Level of generative AI involvement in content creation. 'human' indicates content created purely by human effort without generative AI. 'ai_assisted' indicates content created by human effort with support from generative AI. 'human_supervised' indicates content created by generative AI but supervised or reviewed by humans. 'ai_generated' indicates content created by generative AI without human supervision.
ai_system¶
http://purl.org/iscc/terms/#ai_system
Name or identifier of the generative AI system used for content creation. Aligns with IPTC Photo Metadata 2025.1 'AI System Used' property.
digital_source_type¶
http://purl.org/iscc/terms/#digital_source_type
IPTC Digital Source Type URI for granular content source classification. This optional field bridges to the IPTC controlled vocabulary, an external evolving standard that offers finer-grained source type distinctions than the 'involvement' field. Also used by C2PA Content Credentials. See https://cv.iptc.org/newscodes/digitalsourcetype/
Identifiers¶
http://purl.org/iscc/terms/#Identifiers
Set of typed external identifiers served for an asset identified by an ISCC.
scheme¶
Lowercase token naming the identifier namespace, such as doi, isrc, iswc, isbn, issn, ror, or orcid.
Status: draft
code¶
Identifier value within the declared scheme, normalized by the producer according to the scheme's conventions.
Status: draft
scope¶
http://purl.org/iscc/terms/#scope
Optional lowercase token naming the level the identifier applies to, such as work, series, manifestation, asset, organization, or person.
Status: draft
primary¶
http://purl.org/iscc/terms/#primary
Preferred identifier flag within the same scope. True means preferred; false is equivalent to omission and is normalized away by the model construction path.
Status: draft
Protocol Schema Terms¶
Terms used in ISCC Discovery Protocol records exchanged with ISCC-HUBs and registries.
datahash¶
http://purl.org/iscc/terms/#datahash
A blake3 multihash of the digital content, hex-encoded with the 1e20 multihash prefix (blake3, 32-byte digest). Binds the declaration to the exact content bytes.
nonce¶
http://purl.org/iscc/terms/#nonce
Cryptographic nonce for replay protection. A 128-bit random value encoded as lowercase hexadecimal.
timestamp¶
http://purl.org/iscc/terms/#timestamp
RFC 3339 timestamp of declaration creation in UTC with millisecond precision. Optional on submission - an ISCC-HUB assigns the authoritative timestamp on receipt.
signature¶
http://purl.org/iscc/terms/#signature
Cryptographic signature over the IsccNote, conforming to the iscc-crypto signing protocol. Uses EdDSA (Ed25519) with JCS canonicalization.
units¶
http://purl.org/iscc/terms/#units
The individual full-length ISCC-UNITs that compose the declared ISCC-CODE, enabling similarity matching against the declaration. One to four 256-bit ISCC-UNITs.
metahash¶
http://purl.org/iscc/terms/#metahash
A blake3 multihash of the seed metadata, hex-encoded with the 1e20 multihash prefix (blake3, 32-byte digest). Same format as datahash.
gateway¶
http://purl.org/iscc/terms/#gateway
An HTTP(S) URL or RFC 6570 URI template of a gateway that serves metadata for the declared ISCC. Used by ISCC resolvers to discover content metadata.