Valeria Metadata Model
Valeria uses a structured metadata model for describing an image, its creator, rights, and declared digital source. Valeria Metadata Compiled (VMC) is the resolved asset-level metadata record. Valeria publishes VMC as YAML for readable inspection and tooling, and serializes the same record as JSON-LD for embedding in C2PA assertions and other JSON-based processing. This page documents the Valeria metadata model and its mappings to standardized fields.
Model structure
The Valeria metadata model currently supports these metadata fields:
| Path | Type | Description |
|---|---|---|
metadata.gallery.title | String | Human-readable gallery title. |
metadata.collection.title | String | Human-readable collection title. |
metadata.image.title | String | Descriptive title of the image. |
metadata.image.description | String | Optional description of the image. |
metadata.image.content_warning | String | Optional IPTC Content Warning code. Currently supports nudity, which obscures gallery thumbnails with a Nude label. |
metadata.image.curation_level | Enumeration | Valeria curation classification: curated, extended, or complete. |
metadata.creator.name | String | Name of the creator or declared creator. |
metadata.creator.organization | String | Organization associated with the creator. |
metadata.creator.identifier | URI | Identifier for the creator. |
metadata.rights.copyright_notice | String | Human-readable copyright notice. |
metadata.rights.rights_holder.name | String | Human-readable name of the rights holder. |
metadata.rights.rights_holder.organization | String | Organization associated with the rights holder. |
metadata.rights.rights_holder.identifier | URI | Identifier for the rights holder. |
metadata.rights.license.identifier | String | Optional identifier for the licence. |
metadata.rights.license.name | String | Optional human-readable licence name. |
metadata.rights.license.uri | URI | Canonical URI for the licence. |
metadata.rights.rights_statement.identifier | String | Optional identifier for a rights statement. |
metadata.rights.rights_statement.name | String | Optional human-readable rights-statement name. |
metadata.rights.rights_statement.uri | URI | URI for a rights statement. A rights statement is distinct from a licence. |
metadata.source.digital_source_type.label | String | Human-readable label for the digital source classification. |
metadata.source.digital_source_type.uri | URI | Controlled-vocabulary URI for the digital source classification. |
The model uses structured terms where identity or semantics matter. Human-readable labels and names support presentation; canonical URIs are used for interoperable identity and controlled-vocabulary values. The VMC 3.0 JSON-LD serialization uses a versioned JSON-LD context that defines the VMC terms, and a JSON Schema that defines the document structure.
The following sections map VMC fields to standardized metadata properties and C2PA assertions. Compact IRIs such as dc:title identify properties in a target metadata or assertion vocabulary, not VMC field names.
Technical noteThe mappings are projections, not claims that source and target fields are semantically identical. Each projection should preserve the meaning of the source field within the vocabulary and structure of the target format.
The optional metadata.image.content_warning value is an authored declaration, not a JPEG Trust compliance result. nudity maps to the IPTC Content Warning term http://cv.iptc.org/newscodes/contentwarning/nudity. It is carried in the standard CV-Term About Image structure in XMP and signed CAWG metadata, with URI-valued CvId and CvTermId. There is no invented Iptc4xmpExt:ContentWarning property or legacy IIM mapping. VMC retains the authored code. Trust Profiles translate the extracted term into jpt:profile_label: Nude; an empty label does not establish suitability for every audience. Use null in a sidecar to remove an inherited warning. This field replaces the former nsfw boolean.
Conventional metadata
VMC can be mapped to conventional embedded metadata formats, such as XMP. The following table uses the namespace-qualified property names defined by the relevant XMP schemas.
| VMC field | Conventional property | Notes |
|---|---|---|
asset.identifier | dc:identifier | Stable identifier for the asset. |
metadata.image.title | dc:title | XMP language alternative; the default language is x-default. |
metadata.image.description | dc:description | Optional XMP language alternative; the default language is x-default. |
metadata.image.content_warning | Iptc4xmpExt:AboutCvTerm | Bag of CV-term structures with Content Warning vocabulary and term URIs. |
metadata.creator.name | dc:creator | XMP sequence containing the creator name. |
metadata.creator.organization | photoshop:Credit | Organization or credit line associated with the creator. |
metadata.rights.copyright_notice | dc:rights | XMP language alternative; the default language is x-default. |
metadata.rights.license.uri | xmpRights:WebStatement | URI of the applicable licence statement. |
metadata.rights.rights_holder.identifier | xmpRights:Owner | XMP bag containing the rights-holder identifier. |
metadata.source.digital_source_type.uri | Iptc4xmpExt:DigitalSourceType | IPTC Digital Source Type controlled-vocabulary URI. |
The namespace prefixes used in this table are:
dc http://purl.org/dc/elements/1.1/
xmpRights http://ns.adobe.com/xap/1.0/rights/
photoshop http://ns.adobe.com/photoshop/1.0/
Iptc4xmpExt http://iptc.org/std/Iptc4xmpExt/2008-02-29/
Fields without a listed conventional mapping remain available in VMC but are not assigned an equivalent XMP property by this model.
C2PA provenance
C2PA assertions can carry both descriptive metadata and provenance. The assertion label and the property path are part of the mapping; they should not be conflated with ordinary embedded metadata.
Descriptive assertions
| VMC field | C2PA assertion | Assertion property |
|---|---|---|
asset.identifier | cawg.metadata | dc:identifier |
asset.identifier | stds.schema-org.CreativeWork | identifier |
metadata.image.title | cawg.metadata | dc:title |
metadata.image.title | stds.schema-org.CreativeWork | name |
metadata.image.description | cawg.metadata | dc:description |
metadata.image.content_warning | cawg.metadata | Iptc4xmpExt:AboutCvTerm |
metadata.image.description | stds.schema-org.CreativeWork | description |
metadata.creator.name | cawg.metadata | dc:creator |
metadata.creator.name | stds.schema-org.CreativeWork | author[0].name |
metadata.creator.organization | stds.schema-org.CreativeWork | author[0].affiliation.name |
metadata.rights.copyright_notice | stds.schema-org.CreativeWork | copyrightNotice |
metadata.rights.license.uri | stds.schema-org.CreativeWork | license |
metadata.rights.rights_holder.identifier | stds.schema-org.CreativeWork | copyrightHolder.identifier |
metadata.source.digital_source_type.uri | cawg.metadata | Iptc4xmpExt:DigitalSourceType |
cawg.metadata uses CAWG/IPTC compact-IRI properties. The stds.schema-org.CreativeWork assertion uses the Schema.org JSON-LD context; for example, license expands to the Schema.org license property. The assertion label stds.schema-org.CreativeWork identifies the assertion type; it is not itself a VMC field.
Rights assertion
| VMC field | C2PA assertion | Assertion property |
|---|---|---|
asset.identifier | jpt.rights | ODRL target |
metadata.rights.license.uri | jpt.rights | dcterms:license |
metadata.rights.rights_holder.identifier | jpt.rights | ODRL permission[0].assigner |
The current jpt.rights assertion is an ODRL rights expression. It records the licence, target, assigner, permitted reproduction/display/distribution actions, an attribution duty, and the configured prohibitions. A rights_statement is retained in VMC but is not currently projected into jpt.rights.
Publication provenance
The publication event is represented separately from descriptive metadata and rights:
| C2PA assertion | Property | Meaning |
|---|---|---|
c2pa.actions.v2 | action: c2pa.published | Records publication of the asset. The software agent identifies the publishing service. |
gallery.valeria.vmc | Complete VMC 3.0 document | Preserves the full structured metadata record, including fields without a standardized projection. |
metadata.source.digital_source_type is a source classification, not a creation action. A value such as the IPTC URI for “Created using Generative AI” expresses a declared digital source type; it does not by itself prove how, when, or by which system the image pixels were created. The model therefore does not use it to invent a c2pa.created action.