ChronicleSchema
Compared with
schema.org 30.1
Classes mapped
76 of 133
Properties mapped
60 of 102
Same name, other meaning
6

schema.org is a shared vocabulary for describing things on the web, such as people, places, creative works, and actions. Chronicle borrows its model and names: where schema.org has a term for something, Chronicle uses that term's name and points its own term to schema.org's.

What it's for

Web publishers add schema.org to their pages so that search engines and other programs can tell what a page is about, such as an article, a recipe, a product, or an event. It covers hundreds of kinds of things. Its rules are loose: a property lists the types it expects, but other values are allowed, and no property is required.

Why Chronicle has its own vocabulary

Search engines read schema.org on web pages and make the best of whatever they find. Chronicle's records are written by many independent plugins, kept in a personal archive, and read by programs years later. That needs three things that schema.org leaves open on purpose:

  • One way to write each fact. Two plugins that see the same thing must write the same record, or one thing becomes two. schema.org accepts several forms for most values, such as plain text where it expects a person.
  • A closed set of terms. "What did I watch in 2019?" has a complete answer only if every plugin records watching the same way. Chronicle has about a hundred classes, each added when a source needs it. schema.org has over 900, and anyone can add more.
  • Meanings that stay put. A record kept for years must still mean what it meant when it was written. Chronicle versions its vocabulary and publishes each release, which it can do only for terms it owns.

Restricting schema.org's terms to meet these needs would still make a second vocabulary, one that uses schema.org's names but means something narrower. A program reading schemaorg:width would expect schema.org's meaning, not Chronicle's number of pixels. And schema.org's strength, that any program reading a web page understands it, matters little for records that stay in an archive. So Chronicle defines its own terms and points each to the closest schema.org term, for translating data as it enters or leaves an archive.

Shared model

Chronicle describes what happened the way schema.org does. An Action has an agent who performed it and an object it was carried out on, and it can have a result, an instrument, a target, and a location. A work is a CreativeWork, with an author and a datePublished. A media file is a MediaObject, with subclasses such as VideoObject.

Most Chronicle classes sit under the same parents as the schema.org classes they are named after. Each class and property points to the closest schema.org term, as a hint for mapping data. The hints don't make a Chronicle VideoObject a schemaorg:VideoObject: Chronicle's values follow its own rules, and some terms differ in scope or structure, as the notes below say.

What Chronicle adds

What Chronicle leaves out

Most of schema.org. Chronicle adds a term only when a source needs it, so it has no terms for selling, such as offers and prices, or for the many kinds of web pages and organizations that schema.org describes.

Translating a record

To read a Chronicle record as schema.org, replace each term with the schema.org term it maps to. A term that is the same as a schema.org term, or a kind of one, keeps its meaning. A close match needs the note beside it. For example, a width is a number of pixels, and the object of a TravelAction is where the travel began, which schema.org gives as schemaorg:fromLocation.

Some schema.org names mean something else in Chronicle, such as Project and QuoteAction. The tables below mark these as not the same. Chronicle's own terms, such as sourceId and VisitAction, have no schema.org counterpart.

Classes

Chronicleschema.orgHow they differ
AcceptAction Same as AcceptAction
Action A kind of Action
AddAction A kind of AddAction
AIModel A kind of SoftwareApplication
Article A kind of Article
AssessAction A kind of AssessAction
AudioObject A kind of AudioObject
Base A kind of Thing
Book A kind of Book
BookmarkAction A kind of BookmarkAction
CancelAction A kind of CancelAction
CheckInAction A kind of CheckInAction
Collection A kind of Collection
Comment A kind of Comment
CommunicateAction A kind of CommunicateAction
ConsumeAction A kind of ConsumeAction
CreateAction A kind of CreateAction
CreativeWork A kind of CreativeWork
DateTime Close to DateTime A DateTime can also be a date at year, month, or day precision, a date with unspecified digits, or an uncertain date. An instant is always in UTC. A schemaorg:DateTime is a date and a time, and a schemaorg:Date is a date.
DefinedTerm A kind of DefinedTerm
DeleteAction Close to DeleteAction The agent removed the entity itself, such as by moving it to the trash. A schemaorg:DeleteAction edits something by removing one of its objects, such as an item from a list.
DrinkAction A kind of DrinkAction
EatAction A kind of EatAction
Event A kind of Event
FindAction A kind of SearchAction Not the same as FindAction A schemaorg:FindAction is finding something, which a search can lead to. Searching is a schemaorg:SearchAction.
FollowAction A kind of FollowAction
ImageObject A kind of ImageObject
Intangible A kind of Intangible
InteractAction A kind of InteractAction
JoinAction A kind of JoinAction
LeaveAction A kind of LeaveAction
LikeAction A kind of LikeAction
ListenAction A kind of ListenAction
Location Close to GeoCoordinates
MediaObject A kind of MediaObject
Message A kind of Message
MonetaryAmount Close to MonetaryAmount One sum. A schemaorg:MonetaryAmount can also be a range, from its schemaorg:minValue to its schemaorg:maxValue.
MoveAction Close to MoveAction A MoveAction can be a step through an information space, such as following a link from one web page to another. A schemaorg:MoveAction is relocating to a place, from its schemaorg:fromLocation to its schemaorg:toLocation.
MusicAlbum A kind of MusicAlbum
MusicGroup A kind of MusicGroup
MusicRecording A kind of MusicRecording
Note Close to NoteDigitalDocument A Note is the text itself. A schemaorg:NoteDigitalDocument is a file that holds a note.
Number A kind of Number
OperatingSystem Close to OperatingSystem pending
Organization Same as Organization
OrganizeAction A kind of OrganizeAction
PayAction Close to PayAction How much was paid and to whom are on the FinancialTransaction that is its result. A schemaorg:PayAction carries them itself, as its schemaorg:price and schemaorg:recipient.
PaymentCard Close to PaymentCard One card, as issued with its number. A schemaorg:PaymentCard is a way of paying, and can stand for every card of a kind.
PerformingGroup A kind of PerformingGroup
Person A kind of Person
PhotographAction Same as PhotographAction
Place A kind of Place
PlanAction A kind of PlanAction
PodcastEpisode A kind of PodcastEpisode pending
PodcastSeries A kind of PodcastSeries pending
Post A kind of SocialMediaPosting
ProductModel Close to ProductModel
Project Not the same as Project A schemaorg:Project is an enterprise, a kind of schemaorg:Organization.
Quotation A kind of Quotation pending
QuoteAction Not the same as QuoteAction A schemaorg:QuoteAction is giving a price for something, a kind of schemaorg:TradeAction.
ReactAction A kind of ReactAction
ReadAction A kind of ReadAction
RejectAction Same as RejectAction
ShareAction Same as ShareAction
Software Close to SoftwareApplication
SoftwareApplication A kind of SoftwareApplication
SoftwareSourceCode Same as SoftwareSourceCode
StillImage Broader than Photograph
StructuredValue A kind of StructuredValue
Text A kind of Text
Thread Close to Conversation A Thread can be a chat with a software assistant. A schemaorg:Conversation is between people or organizations.
TradeAction A kind of TradeAction What was exchanged is on the action's result. A schemaorg:TradeAction carries its schemaorg:price itself.
TravelAction A kind of TravelAction The object is where the travel began, and the target is where it ended. schema.org gives these as schemaorg:fromLocation and schemaorg:toLocation.
UpdateAction A kind of UpdateAction
URL A kind of URL
VideoObject A kind of VideoObject
ViewAction A kind of ViewAction
WatchAction A kind of WatchAction

Properties

Chronicleschema.orgHow they differ
about Same as about
address Same as address
agent Same as agent
alternateName Same as alternateName
amount Close to amount On a FinancialPosting, the value is signed. schemaorg:amount can also be a plain number, and what a schemaorg:PayAction paid is its schemaorg:price.
artist Same as byArtist Not the same as artist schemaorg:artist is the primary artist of a comic or a visual artwork. The artist of a recording or an album is its schemaorg:byArtist.
attendee Close to attendee Includes agents who declined or did not reply. A schemaorg:attendee is someone attending the event.
author Same as author
body Close to text
caption Same as caption
category Same as category
color Close to color
contains A kind of hasPart
contentPath Close to contentUrl A filesystem path. schemaorg:contentUrl is a URL.
contentSize Close to contentSize A number of bytes. schemaorg:contentSize is text with a unit, such as 2.8 MB.
creator Same as creator
currency Close to currency An ISO 4217 code. schemaorg:currency also takes a cryptocurrency ticker, and the currency of a schemaorg:PayAction is its schemaorg:priceCurrency.
dateCovered Close to temporalCoverage A date or an interval. schemaorg:temporalCoverage can also be text that names a period, or a URL.
datePublished Same as datePublished
description Same as description
distance Close to distance A number of meters, on the Journey. schemaorg:distance is on the schemaorg:TravelAction and includes a unit, such as 5 km.
duration Same as duration
emblem A kind of image
endTime Same as endTime
exifData Close to exifData An object of EXIF tag names and values. schemaorg:exifData is a list of schemaorg:PropertyValue name and value pairs, or text.
genre Same as genre
height Close to height A number of pixels. schemaorg:height can also be a distance with a unit, such as 5 cm.
inAlbum Same as inAlbum
instrument Same as instrument
isBasedOn Same as isBasedOn
isPartOf Same as isPartOf A record can also give the parts of a whole under the inverse name hasPart, which schema.org has as schemaorg:hasPart.
isStageOf A kind of isPartOf
latitude Same as latitude
location Close to location
longitude Same as longitude
member Same as member
memberOf Close to memberOf
mentions Same as mentions
mimeType Close to encodingFormat A MIME type. schemaorg:encodingFormat can also be the URL of a page that defines the format.
model Same as model
name Same as name
object Same as object
pageCount Same as numberOfPages
performer Close to performer A schemaorg:performer is someone who performed at a schemaorg:Event.
publisher Same as publisher
recipient Same as recipient
rendition Same as encoding
result Same as result
sameAs Close to sameAs Links two references to one entity: another entity, or a text reference such as @me. schemaorg:sameAs is the URL of a page that identifies the item, such as its Wikipedia article.
series Close to partOfSeries schemaorg:partOfSeries links an episode, a clip, or a season to its series. Other works, such as a book in a schemaorg:BookSeries, are part of their series through schemaorg:isPartOf.
source Not the same as source pending schemaorg:source is the source or cause of an event.
sourceId A kind of identifier
startTime Same as startTime
tags Close to keywords
target Not the same as target schemaorg:target is an entry point for carrying out an action, such as a URL template. schema.org names the collection an object is added to its schemaorg:targetCollection, and where a movement ended its schemaorg:toLocation.
timestamp Close to timestamp pending
transcript Close to transcript
url Same as url
value Same as value A number. schemaorg:value can also be text, a boolean, or a structured value.
webFeed Same as webFeed pending
weight Close to weight
width Close to width A number of pixels. schemaorg:width can also be a distance with a unit, such as 5 cm.

Namespace https://schema.org/ · Download the alignment

Esc

↑↓ to move↵ to open/ or ⌘K to search