Schema declaration

Schema types in use today

Only types live on published pages are listed here. Answer pages publish September 30, 2026 — their types are documented separately below.

Conversation page types — the unit of the library

A conversation, not a single answer, is this library’s addressable unit. Each recorded conversation publishes at /answers/{lead-question-slug}/, titled with its lead question — the question the whole conversation was designed to answer. Every other question raised in that conversation is a supporting answer, anchored within the same page and individually citable at the passage level (its own Clip + Quotation schema node) without being addressable at its own URL.

A supporting answer is promoted to its own page only once three or more separate conversations, across different shows, converge on close variants of the same underlying question — at that point it becomes a genuine cross-show comparison worth a dedicated address. Below that bar, it stays a supporting section, still fully structured and still fully citable by Clip + Quotation, just filed under its parent conversation.

This library does not use FAQPage for conversation pages. FAQPage is reserved for /faq/, where the site itself wrote both the question and the answer. A conversation page’s content is an attributed quotation from a named person in a recording — the correct schema is PodcastEpisode, Clip, and Quotation, never FAQPage.

The citation: Clip and Quotation

How an answer is cited

Every answer on this site originates from a specific moment in a recorded conversation. That moment is identified by two nodes that travel together: a Clip marking the segment of the recording by start and end time, and a Quotation carrying the speaker’s exact words.

The timestamped URL

The Clip’s url points to the source podcast episode at the exact second the answer begins. The URL format uses a query parameter, not a fragment, because the Transistor player responds to query parameters:

https://podcast.citedconversations.com/<episode-slug>?t=<seconds>

// example: answer begins at 6 minutes 23 seconds
https://podcast.citedconversations.com/ep1-aeo-practice?t=383

Why Clip and Quotation, not FAQPage

Google’s structured data guidelines accept FAQPage only where the site owner wrote both the questions and the answers. The answers on this site are spoken by guests in a recording — they are clips of source audio, not site-authored content. Clip + Quotation is the correct description. FAQPage is used on /faq/ only, where every answer is site voice.

The paired Clip and Quotation nodes

Below is the structured data for a single answer, as it will appear in the <script type="application/ld+json"> block on an answer page.

{
  "@type": "Clip",
  "@id": "https://citedconversations.com/answers/<slug>/#clip",
  "name": "<the question as asked>",
  "startOffset": <seconds>,
  "endOffset": <seconds>,
  "url": "https://podcast.citedconversations.com/<episode-slug>?t=<seconds>",
  "partOfEpisode": { "@id": "https://citedconversations.com/episodes/<show>/<episode>/#episode" }
},
{
  "@type": "Quotation",
  "@id": "https://citedconversations.com/answers/<slug>/#quotation",
  "text": "<the speaker's exact words>",
  "spokenByCharacter": { "@id": "https://citedconversations.com/speakers/<name>/#speaker" },
  "creator": { "@id": "https://citedconversations.com/speakers/<name>/#speaker" },
  "isPartOf": { "@id": "https://citedconversations.com/episodes/<show>/<episode>/#episode" }
}

Speaker attribution

Person nodes

Every named speaker gets a Person node with a stable @id scoped to the future /speakers/{name}/ URL. The node carries their name, job title, employer (as an Organization), and sameAs links. These let crawlers resolve the speaker to a known public identity.

{
  "@type": "Person",
  "@id": "https://citedconversations.com/speakers/casey-cheshire/#speaker",
  "name": "Casey Cheshire",
  "jobTitle": "Founder & CEO",
  "worksFor": {
    "@type": "Organization",
    "name": "Ringmaster",
    "url": "https://ringmaster.com"
  },
  "sameAs": [
    "https://linkedin.com/in/caseycheshire",
    "https://ringmaster.com"
  ]
}

Attribution is pre-established

Speaker identity is confirmed before recording begins, not inferred from the transcript afterward. The Person node reflects intake data, not a guess from audio analysis.

The DataCatalog node

The homepage declares a DataCatalog node identifying the site as a curated, freely accessible collection. Its publisher is the Organization node. The WebSite node references it via about.

{
  "@type": "DataCatalog",
  "@id": "https://citedconversations.com/#datacatalog",
  "name": "Cited Conversations",
  "description": "A reference library of expert answers from recorded human conversations. Every claim is attributed to a named speaker and links to the exact moment it was said.",
  "url": "https://citedconversations.com/",
  "inLanguage": "en-US",
  "isAccessibleForFree": true,
  "publisher": { "@id": "https://citedconversations.com/#organization" }
}

isAccessibleForFree: true reflects that the answer pages are publicly readable without a login, paywall, or registration.

Verification state: creativeWorkStatus

Every Clip, Quotation, WebPage, and PodcastEpisode node on this site carries a creativeWorkStatus field. This field communicates the transcript verification state to AI crawlers and agents in machine-readable form, not just as a visual badge in the page body.

Values in use

"Published"

The transcript for this episode has been verified against the source audio. Speaker attribution, timestamps, and quoted text have been confirmed. This is the standard state for all published answer pages once verification is complete.

`"Published"` — The only active value. All published answer pages have been verified against source audio. Speaker attribution, timestamps, and quoted text confirmed.

{
  "@type": "Quotation",
  "@id": "https://citedconversations.com/answers/<slug>/#q1-quotation",
  "text": "<speaker's exact words>",
  "spokenByCharacter": { "@id": "https://citedconversations.com/speakers/<name>/#speaker" },
  "creator": { "@id": "https://citedconversations.com/speakers/<name>/#speaker" },
  "isPartOf": { "@id": "https://citedconversations.com/answers/<slug>/#episode" },
  "citation": "https://podcast.citedconversations.com/<slug>?t=<seconds>",
  "relatedLink": [],
  "creativeWorkStatus": "Published"
}