ChronicleSchema
Used on
CreativeWork and their subclasses
Expected type
DateTime
Values
At most one value
Required
No

In other vocabularies

VocabularyTerm
schema.org Same as datePublished
Activity Streams 2.0 Same as published

Examples

Saving an album

Saving an album to a Spotify library is a LikeAction, timed by when the album was saved.

{
  "@type": "LikeAction",
  "@key": ["@type", "source", "agent.handle", "object.sourceId", "timestamp"],
  "source": "spotify",
  "timestamp": "2026-04-02T12:00:00.000Z",
  "agent": {
    "@type": "Agent",
    "@key": ["@type", "source", "handle"],
    "source": "spotify",
    "handle": "pat",
    "name": "Pat Example",
    "url": "https://open.spotify.com/user/pat",
    "sameAs": ["@me"]
  },
  "object": {
    "@type": "MusicAlbum",
    "@key": ["@type", "source", "sourceId"],
    "source": "spotify",
    "sourceId": "1bD4fG7hJ9kL2mN5pQ8rS3",
    "url": "https://open.spotify.com/album/1bD4fG7hJ9kL2mN5pQ8rS3",
    "name": "Morning Songs",
    "datePublished": "2024-03-01",
    "artist": [
      {
        "@type": "MusicGroup",
        "@key": ["@type", "source", "sourceId"],
        "source": "spotify",
        "sourceId": "4kQ7wN2pR8sT1vX3yZ5bC6",
        "url": "https://open.spotify.com/artist/4kQ7wN2pR8sT1vX3yZ5bC6",
        "name": "The Example Band"
      }
    ]
  }
}

Liking a video

A LikeAction from the YouTube API: you liked a video.

{
  "@type": "LikeAction",
  "@key": ["@type", "source", "agent.handle", "object.sourceId", "timestamp"],
  "source": "youtube",
  "timestamp": "2026-05-09T20:14:05.000Z",
  "agent": {
    "@type": "Agent",
    "@key": ["@type", "source", "handle"],
    "source": "youtube",
    "handle": "UCexampleOwner0000000000",
    "url": "https://www.youtube.com/channel/UCexampleOwner0000000000",
    "name": "Pat Example",
    "sameAs": ["@me"]
  },
  "object": {
    "@type": "VideoObject",
    "@key": ["@type", "source", "sourceId"],
    "source": "youtube",
    "sourceId": "vid00000001",
    "url": "https://www.youtube.com/watch?v=vid00000001",
    "name": "Fixing a bike chain in five minutes",
    "duration": "PT5M12S",
    "datePublished": "2025-03-14T16:00:00Z",
    "emblem": {
      "@type": "ImageObject",
      "@key": ["url"],
      "url": "https://i.example.com/vi/vid00000001/maxresdefault.jpg"
    },
    "author": [
      {
        "@type": "Agent",
        "@key": ["@type", "source", "handle"],
        "source": "youtube",
        "handle": "UCexampleWorkshop0000000",
        "url": "https://www.youtube.com/channel/UCexampleWorkshop0000000",
        "name": "Corner Bike Workshop"
      }
    ]
  }
}

Saving a book to a reference library

A BookmarkAction for a book saved to Zotero.

{
  "@type": "BookmarkAction",
  "@key": ["@type", "source", "object.sourceId", "object.inRealm.handle"],
  "source": "zotero",
  "timestamp": "2024-11-05T10:00:00.000Z",
  "agent": {
    "@type": "Person",
    "@key": ["@type", "source", "sourceId"],
    "source": "zotero",
    "sourceId": "LuK3xAmp",
    "sameAs": ["@me"]
  },
  "object": {
    "@type": "Book",
    "@key": ["source", "sourceId", "inRealm.handle"],
    "source": "zotero",
    "sourceId": "BOOKAAAA",
    "inRealm": {
      "@type": "Realm",
      "@key": ["@type", "source", "handle"],
      "source": "zotero",
      "handle": "7654321"
    },
    "name": "Collected Trails",
    "datePublished": "2019",
    "pageCount": 320,
    "publisher": [
      {
        "@type": "Organization",
        "@key": ["@type", "source", "name"],
        "source": "zotero",
        "name": "Example Press"
      }
    ],
    "author": [
      {
        "@type": "Person",
        "@key": ["@type", "source", "name"],
        "source": "zotero",
        "name": "Pat Example"
      }
    ],
    "creator": [
      {
        "@type": "Person",
        "@key": ["@type", "source", "name"],
        "source": "zotero",
        "name": "Alex Example"
      }
    ],
    "sameAs": [
      {
        "@type": "Book",
        "@key": ["source", "sourceId"],
        "source": "isbn",
        "sourceId": "9780306406157",
        "name": "Collected Trails"
      }
    ]
  }
}

Saving a blog post to a reference library

A BookmarkAction for a blog post saved to Zotero.

{
  "@type": "BookmarkAction",
  "@key": ["@type", "source", "object.sourceId", "object.inRealm.handle"],
  "source": "zotero",
  "timestamp": "2025-02-10T11:00:00.000Z",
  "agent": {
    "@type": "Person",
    "@key": ["@type", "source", "sourceId"],
    "source": "zotero",
    "sourceId": "LuK3xAmp",
    "sameAs": ["@me"]
  },
  "object": {
    "@type": "Post",
    "@key": ["source", "sourceId", "inRealm.handle"],
    "source": "zotero",
    "sourceId": "POSTAAAA",
    "inRealm": {
      "@type": "Realm",
      "@key": ["@type", "source", "handle"],
      "source": "zotero",
      "handle": "7654321"
    },
    "name": "Ten Quiet Trails",
    "url": "https://blog.example.com/ten-quiet-trails",
    "datePublished": "2025-02-08",
    "author": [
      {
        "@type": "Person",
        "@key": ["@type", "source", "name"],
        "source": "zotero",
        "name": "Sam Rivera"
      }
    ]
  }
}

URI https://schema.chronicle.app/datePublished · Suggest a change

Esc

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