XooCode(){

Manuscript

Manuscript is a pending CreativeWork subtype for handwritten works: medieval manuscripts, composer score drafts, author manuscript drafts, handwritten letters. It adds no properties of its own.

Useful inherited CreativeWork properties for manuscripts: material (parchment, vellum, paper, papyrus), inLanguage, author, dateCreated, locationCreated, contentLocation (where it is held today). For archival holdings, pair with ArchiveComponent to carry holdingArchive.

Full example of schema.org/Manuscript json-ld markup

The markup is verified as valid with Rich Results Test from Google.

schema.org/Manuscript
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": ["Manuscript", "ArchiveComponent"],
  "name": "Jane Xoo's XooStructured notebook - 2018",
  "description": "Original Moleskine notebook in which Jane Xoo sketched the first version of the XooStructured validator architecture across 84 handwritten pages.",
  "author": { "@type": "Person", "name": "Jane Xoo" },
  "dateCreated": "2018-03-22",
  "material": "Ink on paper (Moleskine notebook)",
  "inLanguage": "en",
  "holdingArchive": { "@type": "ArchiveOrganization", "name": "Xoo Code Archive" },
  "itemLocation": "Box 4, Folder 17, Xoo Code Archive, Dunmore PA",
  "image": "https://xoocode.com/archive/early-jsonld/jx-2018-notebook-p01.jpg"
}
</script>

Minimal valid version

The smallest markup that still produces a valid Manuscript entity. Use it as the floor. Reach for the advanced example above when you want search engines and AI agents to understand more about your content.

schema.org/Manuscript (minimal)
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Manuscript",
  "name": "Jane Xoo's XooStructured notebook",
  "author": { "@type": "Person", "name": "Jane Xoo" }
}
</script>

Google rich results this unlocks

Manuscript is a structural type. It does not produce a rich result on its own.

Its value comes from combining it with a primary type whose markup earns a rich result (Article, Product, Event, and so on). Manuscript becomes the trunk that the primary type branches off viamainEntityorbreadcrumb. Include it on every page as the backbone of your markup.

Common Manuscript mistakes

Mistakes that pass validation but silently fail to earn rich results or mislead consumers walking the graph. Avoid these and your markup will be ahead of most sites in the wild.

  1. 01

    Using Book for a unique handwritten work

    Wrong
    Book for a one-of-a-kind manuscript
    Right
    Manuscript preserves the handwritten-artefact identity; Book implies a published, reproducible edition

    Book is about publication; Manuscript is about the handwritten original. The distinction matters for archives, museums, and knowledge-graph consumers.

About the example data

Jane Xoo's original 2018 handwritten notebook containing the first sketches of XooStructured, held by the Xoo Code Archive.

Comments

Loading comments...

Leave a comment