Projekt:CommonsDB registry/Metadata mapping
These tables map the metadata used in the registry with what we can retrieve for media in Wikimedia Commons. The full schema is available at https://docs.google.com/spreadsheets/d/1ddBYr7ucaiYLJ_RYN8BgeLwGkGFoogvKRU21Me-5dx4/edit?pli=1&gid=2055328000#gid=2055328000 and is described at https://www.commonsdb.org/docs/metadata-schema/
| declarationMetadata | Format | CommonsDB Notion | Description | Example or accepted enum values | How to get on Wikimedia Commons |
|---|---|---|---|---|---|
| publicMetadata | object | ||||
| iscc | string | Unique identifier for the media asset generated by the ISCC Generator | "ISCC:KEC3HW7VA6FLYI7YXEZ6COGHYIPMNMG3HJGXJZOBEJ2SROVHJKYWHNY" | ||
| version | string | Technical | Version of the declaration or metadata schema | "1.0" | |
| entryUUID | string | Work ID | Unique identifier for the entry from an authority source, could be a UUID | "d9bfa832-102a-4e0a-9fd9-e231db8a74f1" | |
| createdAt | string (date-time) | Timestamp when the record was first created | "2024-06-14T16:38:13.575Z" | ||
| updatedAt | string (date-time) | Timestamp of the most recent update | "2025-01-01T10:15:45.123Z" | ||
| timestamp | string (date-time) | Time Stamp | General-purpose timestamp of the event | "2025-04-14T12:00:00Z" | |
| declarerId | string | Identifier for the person or system making the declaration. | "did:key:z6Mkw..." | ||
| regId | string | Registry identifier | "000042" | ||
| declarationIdVersion | string | Version of the declarationID | "01" | ||
| $schema | string (URI) | URI of the JSON schema used to validate the structure | "https://schemas.example.org/declaration/v1.json" | ||
| mediatype | string | Media type of the declared content (MIME type) | "image/png" or "text/markdown" | ||
| thumbnail | string (data URI) | Base64-encoded image embedded as a Data URI, typically a small preview of the original content. | "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..." | ||
| original | boolean | Indicates whether the declaring party claims to be the original creator or rightsholder of the content. | TRUE | ||
| credentials | array (object[]) | [See array of objects below] | |||
| supplierData | object | [See object below] |
| supplierMetadata | Format | Required? | CommonsDB Notion | Description | Example or accepted enum values | How to get on Wikimedia Commons | Phabricator |
|---|---|---|---|---|---|---|---|
| rightsStatement | Enum | Yes | Rights Statement | A machine readable statement indicating the copyright and re-use status of a Work | https://creativecommons.org/publicdomain/mark/1.0/ https://creativecommons.org/publicdomain/zero/1.0/ |
|
|
| location | URL | Yes | Source URL* | Reference URL for the Work (e.g. a Europeana data URIs) | Europeana: http://data.europeana.eu/item/11608/BRXBR0000020147860
Wikimedia: https://commons.wikimedia.org/entity/M74116006" |
||
| name | string | Yes | Title | Title of the Work | "Portrait of Ada Lovelace" |
|
|
| creationDate | The value must be a literal, expressed ISO 8601. | No | Date | Date on which the Work was created | "2020-02-12T12:13:53Z" | DateTimeOriginal from the API (query>imageinfo>extmetadata)
unless it is free text, then don't submitt |
|
| pdRationale | string | No | PD Rationale | Rationale for determination that a work is in the Public Domain. Only used if Rights Statement = Public Domain Mark. | "This work is in the public domain in its country of origin and other countries and areas where the copyright term is the author's life plus 70 years or fewer." | Se Projekt:CommonsDB registry/Mallmappning | |
| description | string | No | Description | Description of the Work | "A historical painting depicting Ada Lovelace with analytical engine notes." | ImageDescription from the API (query>imageinfo>extmetadata) | |
| creator | string | No | Creator | Creator of the Work | "Alfred Edward Chalon" | Artist from the API (query>imageinfo>extmetadata) | T404082 |
| cdbTdmOptout | string | No | TDM Opt-Out | Information on possible TDM reservation. | To be defined, e.g. "tdm": "allowed" | ||
| attributionString | string | No | Attribution | The attribution string (byline) for using the digital asset. Required if license requires attribution; otherwise this is optional. | "© National Gallery, Photo by John Doe" | ||
| steward | string | No | Steward | Name of the person/organisation making the work available, if different from the Declaring Party | "British Library" |