Speaker

Metadata

Definition

#/$defs/Speaker

Type

object

Source

spec/schemas/opf.schema.json

Field index

id

typestringrequiredyesdefault—pattern^[a-zA-Z0-9_-]+$

Stable identifier for the speaker, used for cross-references within the deck. Must be unique within the deck.

{
  "id": "alice"
}

name

typestringrequiredyesdefault—

Display name.

{
  "name": "Alice Chen"
}

title

typestringrequirednodefault—

Role or title. Often paired with the speaker's organization on cover slides.

{
  "title": "VP of Engineering"
}

photo

typeref:Assetrequirednodefault—

Source for the speaker's headshot image. Accepts an HTTPS URL, data URI, relative path (resolved against the OPF file location), local path, or 'asset:<id>' reference. Common formats are JPG or PNG; SVG is not appropriate for photographic content. Used on cover and bio slides.

{
  "photo": "https://cdn.acme.com/headshots/alice.jpg"
}

email

typestringrequirednodefault—

Contact email, used on contact slides or footer attribution when appropriate.

{
  "email": "alice@acme.com"
}

phone

typestringrequirednodefault—

Contact phone number for the speaker. E.164 format is recommended.

{
  "phone": "+14155551234"
}

bio

typestringrequirednodefault—

Short biographical paragraph for bio or 'about the speaker' slides.

{
  "bio": "Alice leads engineering at Acme, where she's spent the last six years scaling distributed systems from prototype to billions of requests per day. Previously, she was a staff engineer at Google."
}

organizationId

typestringrequirednodefault—

Reference to an Organization.id in organization. Lets a speaker be attributed to their org in panel or multi-org decks without repeating organization details.

{
  "organizationId": "acme"
}

socials

typeref:Socialsrequirednodefault—

Optional social media handles or URLs for the speaker.

{
  "socials": "socials-value"
}