Knowledge store

Using this model

We encourage Wikimedia projects to make use of this model, either as a whole or as a base to build on. Services currently using this model include Phoenix (structured content proof of value) and Wikimedia Enterprise.

Adding a property

As defined here, the model is restricted to properties that are meaningful outside the context of MediaWiki. To suggest a new property, leave a comment on the talk page. New properties should conform with the applicable schema.org type whenever possible.

Feedback and questions

To share feedback and question, leave a comment on the talk page. Note that there are often several unknowns associated with each type; these unknowns are tracked in the notes and questions subsections.

Patterns

Canonical data modeling

Capabilities

Serve and distribute

Distribute predictably-structured knowledge to products and platforms

Language

a human language
Based on schema.org Language

{
  "name": "English",
  "identifier": "en",
  "direction": "ltr"
}

Notes and questions

Project

a wiki in a single language
Based on schema.org CreativeWork (not on schema.org Project)

{
  "name": "Wikipedia",
  "identifier": "en.wikipedia.org",
  "in_language": {
    "identifier": "en"
  },
  "url": "https://en.wikipedia.org",
  "size": {
    "value": 70934,
    "unit_text": "MB"
  }
}

Notes and questions

• How should we handle inLanguage for multi-lingual projects? (Commons, Wikispecies, Wikidata, etc.)

Page

a wiki page
Based on schema.org Article

{
  "name": "Pinnation",
  "identifier": 339742,
  "url": "https://en.wikipedia.org/wiki/Pinnation",
  "in_language": {
    "identifier": "en"
  },
  "is_part_of": [
    {
      "identifier": "en.wikipedia.org"
    }
  ],
  "version": 975098740,
  "date_modified": "2020-08-26T18:48:58Z",
  "license": [
    {
      "identifier": "CC-BY-SA-3.0",
      "name": "Creative Commons Attribution Share Alike 3.0 Unported",
      "url": "https://creativecommons.org/licenses/by-sa/3.0/"
    }
  ],
  "main_entity": {
    "identifier": "Q3756157"
  },
  "keywords": "Plant morphology, Leaves",
  "has_part": [
    {
      "identifier": "/node/ff569ed4759dbfc"
    }
  ]
}

Notes and questions

• Consider using display title for name instead of reading-friendly title
• How should we handle media files associated with a page? Schema.org has audio, video, thumbnailURL, and primaryImageOfPage (MediaObject). Note that using primaryImageOfPage would be from WebPage type.
  • How to handle licenses for images embedded in a page? (Check with legal)
• Should we include other URLs (mobile, edit, talk, etc.)? Schema.org has discussionUrl but no others.
• We’ve intentionally not included content at the page level in favor of providing content at the section level.
• Is it a problem that isPartOf would be inconsistent between objects?
• Properties to consider:
  • about - Rosette or other set of page subjects (Wikidata items)
  • interactionStatistic seems like the most logical place for pageviews, number of edits, etc. What types of stats should we include? (array of InteractionCounter)
  • mentions - array of Thing, links included within the page
  • abstract: Is there a way we could get the first two sentences of the article?
  • citation (References used on the page)
  • schemaVersion (https://schema.org/docs/releases.html#v12.0) seems like a good idea, but I’m struggling to see the value. These releases seem to come out every few months.
  • page quality score (aggregateRating?)
  • copyrightHolder -  “The text of Wikipedia is copyrighted (automatically, under the Berne Convention) by Wikipedia editors and contributors and is formally licensed to the public under one or several liberal licenses.”[1] (Covered by license?)
  • dateCreated (page’s initial publication date)
  • creativeWorkStatus
  • creditText (attribution text)

Section

content grouped under a heading or as an introduction before the first heading on a page
Based on schema.org CreativeWork

{
  "name": "Orbit and turning",
  "identifier": "/node/ff569ed4759dbfc",
  "version": 975098740,
  "is_part_of": [
    {
      "identifier": 339742
    }
  ],
  "text": "...html...",
  "encoding_format": "text/html",
  "license": [
    {
      "identifier": "CC-BY-SA-3.0",
      "name": "Creative Commons Attribution Share Alike 3.0 Unported",
      "url": "https://creativecommons.org/licenses/by-sa/3.0/"
    }
  ]
}

Notes and questions

• Properties to consider:
  • dateModified
  • about - Rosette or other set of page subjects (Wikidata items)

License

content license
Based on schema.org CreativeWork

{
  "identifier": "CC-BY-SA-3.0",
  "name": "Creative Commons Attribution Share Alike 3.0 Unported",
  "url": "https://creativecommons.org/licenses/by-sa/3.0/"
}

Notes and questions

Entity

a subject of a page
Based on schema.org Thing

{
  "identifier": "Q3756157"
}

Notes and questions

• Connection with Wikidata