{}OPF
DocsObject referenceEdit on GitHub

Audience

Inline audience metadata for the presentation. Use 'id' to reference an audiences catalog record and override selected fields, or use 'name' for a custom inline audience.

Metadata

Definition

#/$defs/Audience

Type

object | object

Source

spec/schemas/opf.schema.json

Fields

FieldTypeReqDescription
idstringOptional audiences catalog id to resolve before applying inline overrides.
namestringHuman-readable audience name shown in pickers.
summarystringOne-sentence positioning of the audience.
descriptionstringLonger prose describing the audience and how to address them.
seniorityenumTypical seniority level of the audience.
technicalFluencyenumTypical technical fluency of the audience.
decisionPowerenumWhether the audience is expected to be informed, advise, or decide.
attentionBudgetMinutesnumberRealistic upper bound on focused attention for a single presentation, in minutes.
recommendedNarrativesarray<string>Soft cross-link: narrative-catalog ids that work well for this audience.
recommendedTonesarray<string>Soft cross-link: tone-catalog ids that work well for this audience.
tagsarray<string>Free-form labels for filtering and search.

id

Type: string · Optional · Default: · Pattern: ^[a-z][a-z0-9-]*$

Optional audiences catalog id to resolve before applying inline overrides.

id.json
{
  "id": "executives"
}

name

Type: string · Optional · Default:

Human-readable audience name shown in pickers.

name.json
{
  "name": "name-value"
}

summary

Type: string · Optional · Default:

One-sentence positioning of the audience.

summary.json
{
  "summary": "summary-value"
}

description

Type: string · Optional · Default:

Longer prose describing the audience and how to address them.

description.json
{
  "description": "description-value"
}

seniority

Type: enum · Optional · Default:

Typical seniority level of the audience.

seniority.json
{
  "seniority": "ic"
}

technicalFluency

Type: enum · Optional · Default:

Typical technical fluency of the audience.

technicalFluency.json
{
  "technicalFluency": "low"
}

decisionPower

Type: enum · Optional · Default:

Whether the audience is expected to be informed, advise, or decide.

decisionPower.json
{
  "decisionPower": "informational"
}

attentionBudgetMinutes

Type: number · Optional · Default:

Realistic upper bound on focused attention for a single presentation, in minutes.

attentionBudgetMinutes.json
{
  "attentionBudgetMinutes": 1
}

recommendedNarratives

Type: array<string> · Optional · Default:

Soft cross-link: narrative-catalog ids that work well for this audience.

recommendedNarratives.json
{
  "recommendedNarratives": []
}

recommendedTones

Type: array<string> · Optional · Default:

Soft cross-link: tone-catalog ids that work well for this audience.

recommendedTones.json
{
  "recommendedTones": []
}

tags

Type: array<string> · Optional · Default:

Free-form labels for filtering and search.

tags.json
{
  "tags": []
}