Speaker

Metadata

Fields

id

Type: string · Required · Default: — · 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

Type: string · Required · Default: —

Display name.

{
  "name": "Alice Chen"
}

title

Type: string · Optional · Default: —

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

{
  "title": "VP of Engineering"
}

photo

Type: ref:Asset · Optional · Default: —

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

Type: string · Optional · Default: —

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

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

phone

Type: string · Optional · Default: —

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

{
  "phone": "+14155551234"
}

bio

Type: string · Optional · Default: —

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

Type: string · Optional · Default: —

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

Type: ref:Socials · Optional · Default: —

Optional social media handles or URLs for the speaker.

{
  "socials": "socials-value"
}