{"id":"linked-art/api/schema-org-mapping","relativePath":"linked-art/api/schema-org-mapping.md","title":"Linked Art: Schema.org Mapping","markdown":"# Linked Art: Schema.org Mapping\n\n**Last refreshed:** 2026-07-06\n\nSource: Linked Art to Schema.org mapping notes supplied for project reference. This is a project summary; the upstream mapping notes and Schema.org vocabulary remain authoritative.\n\n## Purpose\n\nThis mapping describes how Linked Art records can be projected into Schema.org for web-indexing, structured-data, and broad consumer discovery use cases. Linked Art remains the canonical semantic model for Meta Museum; Schema.org should be treated as a derivative public-web projection.\n\n## Shared Properties\n\nCommon Linked Art fields map across many Schema.org entity types:\n\n- `id` maps to `url`.\n- Description Statements map to `description`.\n- `classified_as.id` maps to `additionalType`.\n- Primary `Name` content maps to `name`; other `Name` content maps to `alternateName`.\n- `Identifier` content maps to `identifier`.\n- `equivalent.id` maps to `sameAs`.\n- Representation image access points map to `image`.\n- Subject web pages map to `mainEntityOfPage`.\n\n## People And Organizations\n\nLinked Art `Person` records project to Schema.org `Person`:\n\n- Birth and death timespans map to `birthDate` and `deathDate`.\n- Birth and death places map to `birthPlace` and `deathPlace`.\n- Email contact points map to `email`.\n- Gender, occupation, and nationality classifications map to `gender`, `hasOccupation`, and `nationality`.\n- Residence maps to `homeLocation`.\n- Group membership maps to `memberOf`.\n\nLinked Art `Group` records project to Schema.org `Organization`:\n\n- Email and address contact points map to `email` and `address`.\n- Formation and dissolution dates map to `foundingDate` and `dissolutionDate`.\n- Formation place maps to `foundingLocation`.\n- Formation actors map to `founder`.\n- Residence maps to `location`.\n- Membership maps to `memberOf`; hierarchical membership can map to `parentOrganization`.\n\n## Places And Concepts\n\nLinked Art `Place` records project to Schema.org `Place`:\n\n- `part_of.id` maps to `containedInPlace`.\n- `defined_by` geometry maps to `geo`, or to `latitude`/`longitude` when the value is a point.\n- If a representation is specifically a map, use `hasMap` rather than generic `image`.\n\nLinked Art concept records project to Schema.org `DefinedTerm` and `CreativeWork`; language concepts also carry the `Language` additional type:\n\n- `broader` maps to `isPartOf`.\n- `member_of` maps to `inDefinedTermSet`.\n\n## Human-Made Objects\n\nLinked Art `HumanMadeObject` records project to Schema.org `VisualArtwork` or `ArchiveComponent` depending on object type:\n\n- Object classification maps to `artform`.\n- Description Statements map to `abstract` for human-made objects.\n- Rights, access, credit, and material Statements map to `copyrightNotice`, `conditionsOfAccess`, `creditText`, and `artMedium`.\n- Production actors map to `creator` or `artist`; contributor-classified production parts map to `contributor`.\n- Production country maps to `countryOfOrigin`; production timespan maps to `dateCreated`; production place maps to `locationCreated`.\n- Part hierarchy maps to `isPartOf`.\n- Shown or carried content maps to `exampleOfWork`.\n- Materials map to `material`.\n- Text content maps to `text`.\n- Height, width, and depth dimensions map to `height`, `width`, and `depth`.\n- Current owner maps to `holdingArchive`; current location maps to `itemLocation`.\n\n## Digital Objects\n\nLinked Art `DigitalObject` records project to Schema.org `CreativeWork` and `DataSet`:\n\n- Digitally shown or carried content maps to `exampleOfWork`.\n- Height, width, and depth dimensions map to `height`, `width`, and `depth`; other dimensions can map to `size`.\n- Part hierarchy maps to `isPartOf`.\n- Format maps to `encodingFormat`.\n- Access points map to `distribution`.\n- Creation actors map to `creator`.\n- Publishing activity actors map to `publisher`.\n\n## Visual And Textual Works\n\nLinked Art `VisualItem` and `LinguisticObject` records project to Schema.org `CreativeWork`:\n\n- `about` maps to `about`.\n- Represented places map to `contentLocation`.\n- Other represented entities map to `mainEntity`.\n- Language maps to `inLanguage`.\n- Genre classifications map to `genre`.\n- Creation actors map to `author`, `artist`, or `creator` depending on work type and role.\n- Publishing activity actors map to `publisher`.\n- Content maps to `text`.\n- Dimensions map to `size`.\n- Format maps to `encodingFormat`.\n\n## Events And Sets\n\nLinked Art `Event` records project to Schema.org `Event`, with exhibitions projecting to `ExhibitionEvent` where appropriate:\n\n- Responsible actors map to `organizer`, `performer`, or `contributor`.\n- Places map to `location`.\n- Event hierarchy maps to `superEvent`.\n- Timespan bounds map to `startDate` and `endDate`.\n- Used specific objects map to `workFeatured`.\n- Influences can map to `about` when the relationship is suitable for broad web discovery.\n\nLinked Art `Set` records project to Schema.org `ArchiveComponent` for archives or `Collection` for other sets:\n\n- `member_of` maps to `isPartOf`.\n- Creation actors map to `author`, `artist`, or `creator`.\n- Publishing activity actors map to `publisher`.\n- `about` maps to `about`.\n- Dimensions map to `size`.\n\n## Meta Museum Notes\n\nMeta Museum should generate Schema.org from canonical Linked Art records, not maintain it as a second source of truth. The projection is useful for search engines, simple external clients, and evaluator-facing web-readability checks, but it is intentionally less precise than Linked Art.\n\nUse `sameAs` from `equivalent` carefully: it is suitable for broad web structured data, but Linked Art reconciliation still keeps `equivalent` semantics separate from a hard identity-collapse model.\n\n## Test Ideas\n\n- Derive Schema.org JSON-LD from Linked Art records at render/export time rather than storing duplicate assertions.\n- Preserve Schema.org `sameAs` projection from Linked Art `equivalent` without weakening internal reconciliation semantics.\n- Map object dimensions, image access points, names, identifiers, and descriptions from structured Linked Art fields.\n- Keep human-made object, digital object, visual/textual work, event, set, person/group, place, and concept projections type-specific.\n- Verify Schema.org output does not replace or mutate canonical Linked Art JSON-LD.\n","sections":[{"level":2,"heading":"Purpose","anchor":"purpose"},{"level":2,"heading":"Shared Properties","anchor":"shared-properties"},{"level":2,"heading":"People And Organizations","anchor":"people-and-organizations"},{"level":2,"heading":"Places And Concepts","anchor":"places-and-concepts"},{"level":2,"heading":"Human-Made Objects","anchor":"human-made-objects"},{"level":2,"heading":"Digital Objects","anchor":"digital-objects"},{"level":2,"heading":"Visual And Textual Works","anchor":"visual-and-textual-works"},{"level":2,"heading":"Events And Sets","anchor":"events-and-sets"},{"level":2,"heading":"Meta Museum Notes","anchor":"meta-museum-notes"},{"level":2,"heading":"Test Ideas","anchor":"test-ideas"}],"html":"<h1 id=\"linked-art-schema-org-mapping\">Linked Art: Schema.org Mapping</h1>\n<p><strong>Last refreshed:</strong> 2026-07-06</p>\n<p>Source: Linked Art to Schema.org mapping notes supplied for project reference. This is a project summary; the upstream mapping notes and Schema.org vocabulary remain authoritative.</p>\n<h2 id=\"purpose\">Purpose</h2>\n<p>This mapping describes how Linked Art records can be projected into Schema.org for web-indexing, structured-data, and broad consumer discovery use cases. Linked Art remains the canonical semantic model for Meta Museum; Schema.org should be treated as a derivative public-web projection.</p>\n<h2 id=\"shared-properties\">Shared Properties</h2>\n<p>Common Linked Art fields map across many Schema.org entity types:</p>\n<ul><li>`id` maps to `url`.</li><li>Description Statements map to `description`.</li><li>`classified_as.id` maps to `additionalType`.</li><li>Primary `Name` content maps to `name`; other `Name` content maps to `alternateName`.</li><li>`Identifier` content maps to `identifier`.</li><li>`equivalent.id` maps to `sameAs`.</li><li>Representation image access points map to `image`.</li><li>Subject web pages map to `mainEntityOfPage`.</li></ul>\n<h2 id=\"people-and-organizations\">People And Organizations</h2>\n<p>Linked Art `Person` records project to Schema.org `Person`:</p>\n<ul><li>Birth and death timespans map to `birthDate` and `deathDate`.</li><li>Birth and death places map to `birthPlace` and `deathPlace`.</li><li>Email contact points map to `email`.</li><li>Gender, occupation, and nationality classifications map to `gender`, `hasOccupation`, and `nationality`.</li><li>Residence maps to `homeLocation`.</li><li>Group membership maps to `memberOf`.</li></ul>\n<p>Linked Art `Group` records project to Schema.org `Organization`:</p>\n<ul><li>Email and address contact points map to `email` and `address`.</li><li>Formation and dissolution dates map to `foundingDate` and `dissolutionDate`.</li><li>Formation place maps to `foundingLocation`.</li><li>Formation actors map to `founder`.</li><li>Residence maps to `location`.</li><li>Membership maps to `memberOf`; hierarchical membership can map to `parentOrganization`.</li></ul>\n<h2 id=\"places-and-concepts\">Places And Concepts</h2>\n<p>Linked Art `Place` records project to Schema.org `Place`:</p>\n<ul><li>`part_of.id` maps to `containedInPlace`.</li><li>`defined_by` geometry maps to `geo`, or to `latitude`/`longitude` when the value is a point.</li><li>If a representation is specifically a map, use `hasMap` rather than generic `image`.</li></ul>\n<p>Linked Art concept records project to Schema.org `DefinedTerm` and `CreativeWork`; language concepts also carry the `Language` additional type:</p>\n<ul><li>`broader` maps to `isPartOf`.</li><li>`member_of` maps to `inDefinedTermSet`.</li></ul>\n<h2 id=\"human-made-objects\">Human-Made Objects</h2>\n<p>Linked Art `HumanMadeObject` records project to Schema.org `VisualArtwork` or `ArchiveComponent` depending on object type:</p>\n<ul><li>Object classification maps to `artform`.</li><li>Description Statements map to `abstract` for human-made objects.</li><li>Rights, access, credit, and material Statements map to `copyrightNotice`, `conditionsOfAccess`, `creditText`, and `artMedium`.</li><li>Production actors map to `creator` or `artist`; contributor-classified production parts map to `contributor`.</li><li>Production country maps to `countryOfOrigin`; production timespan maps to `dateCreated`; production place maps to `locationCreated`.</li><li>Part hierarchy maps to `isPartOf`.</li><li>Shown or carried content maps to `exampleOfWork`.</li><li>Materials map to `material`.</li><li>Text content maps to `text`.</li><li>Height, width, and depth dimensions map to `height`, `width`, and `depth`.</li><li>Current owner maps to `holdingArchive`; current location maps to `itemLocation`.</li></ul>\n<h2 id=\"digital-objects\">Digital Objects</h2>\n<p>Linked Art `DigitalObject` records project to Schema.org `CreativeWork` and `DataSet`:</p>\n<ul><li>Digitally shown or carried content maps to `exampleOfWork`.</li><li>Height, width, and depth dimensions map to `height`, `width`, and `depth`; other dimensions can map to `size`.</li><li>Part hierarchy maps to `isPartOf`.</li><li>Format maps to `encodingFormat`.</li><li>Access points map to `distribution`.</li><li>Creation actors map to `creator`.</li><li>Publishing activity actors map to `publisher`.</li></ul>\n<h2 id=\"visual-and-textual-works\">Visual And Textual Works</h2>\n<p>Linked Art `VisualItem` and `LinguisticObject` records project to Schema.org `CreativeWork`:</p>\n<ul><li>`about` maps to `about`.</li><li>Represented places map to `contentLocation`.</li><li>Other represented entities map to `mainEntity`.</li><li>Language maps to `inLanguage`.</li><li>Genre classifications map to `genre`.</li><li>Creation actors map to `author`, `artist`, or `creator` depending on work type and role.</li><li>Publishing activity actors map to `publisher`.</li><li>Content maps to `text`.</li><li>Dimensions map to `size`.</li><li>Format maps to `encodingFormat`.</li></ul>\n<h2 id=\"events-and-sets\">Events And Sets</h2>\n<p>Linked Art `Event` records project to Schema.org `Event`, with exhibitions projecting to `ExhibitionEvent` where appropriate:</p>\n<ul><li>Responsible actors map to `organizer`, `performer`, or `contributor`.</li><li>Places map to `location`.</li><li>Event hierarchy maps to `superEvent`.</li><li>Timespan bounds map to `startDate` and `endDate`.</li><li>Used specific objects map to `workFeatured`.</li><li>Influences can map to `about` when the relationship is suitable for broad web discovery.</li></ul>\n<p>Linked Art `Set` records project to Schema.org `ArchiveComponent` for archives or `Collection` for other sets:</p>\n<ul><li>`member_of` maps to `isPartOf`.</li><li>Creation actors map to `author`, `artist`, or `creator`.</li><li>Publishing activity actors map to `publisher`.</li><li>`about` maps to `about`.</li><li>Dimensions map to `size`.</li></ul>\n<h2 id=\"meta-museum-notes\">Meta Museum Notes</h2>\n<p>Meta Museum should generate Schema.org from canonical Linked Art records, not maintain it as a second source of truth. The projection is useful for search engines, simple external clients, and evaluator-facing web-readability checks, but it is intentionally less precise than Linked Art.</p>\n<p>Use `sameAs` from `equivalent` carefully: it is suitable for broad web structured data, but Linked Art reconciliation still keeps `equivalent` semantics separate from a hard identity-collapse model.</p>\n<h2 id=\"test-ideas\">Test Ideas</h2>\n<ul><li>Derive Schema.org JSON-LD from Linked Art records at render/export time rather than storing duplicate assertions.</li><li>Preserve Schema.org `sameAs` projection from Linked Art `equivalent` without weakening internal reconciliation semantics.</li><li>Map object dimensions, image access points, names, identifiers, and descriptions from structured Linked Art fields.</li><li>Keep human-made object, digital object, visual/textual work, event, set, person/group, place, and concept projections type-specific.</li><li>Verify Schema.org output does not replace or mutate canonical Linked Art JSON-LD.</li></ul>","updatedAt":"2026-07-06T00:00:00.000Z","checksum":"e5407dc8677d4653ff95663ce0f96454814d787e6c17632af2a18b4f00cf73ad","checksumPrefix":"e5407dc8677d","anchorCount":10,"lineCount":132,"rawUrl":"/api/docs/content?path=linked-art%2Fapi%2Fschema-org-mapping.md","htmlUrl":"/docs?doc=linked-art%2Fapi%2Fschema-org-mapping.md","apiUrl":"/api/docs/content?path=linked-art%2Fapi%2Fschema-org-mapping.md"}