DocsObject referenceView source

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

Field index

Field	Type	Req.	Description
id	string	—	Optional audiences catalog id to resolve before applying inline overrides.
name	string	—	Human-readable audience name shown in pickers.
summary	string	—	One-sentence positioning of the audience.
description	string	—	Longer prose describing the audience and how to address them.
seniority	enum	—	Typical seniority level of the audience.
technicalFluency	enum	—	Typical technical fluency of the audience.
decisionPower	enum	—	Whether the audience is expected to be informed, advise, or decide.
attentionBudgetMinutes	number	—	Realistic upper bound on focused attention for a single presentation, in minutes.
recommendedNarratives	array<string>	—	Soft cross-link: narrative-catalog ids that work well for this audience.
recommendedTones	array<string>	—	Soft cross-link: tone-catalog ids that work well for this audience.
tags	array<string>	—	Free-form labels for filtering and search.

`id`

typestringrequirednodefault—pattern^[a-z][a-z0-9-]*$

Optional audiences catalog id to resolve before applying inline overrides.

id.json

{
  "id": "executives"
}

`name`

typestringrequirednodefault—

Human-readable audience name shown in pickers.

name.json

{
  "name": "name-value"
}

`summary`

typestringrequirednodefault—

One-sentence positioning of the audience.

summary.json

{
  "summary": "summary-value"
}

`description`

typestringrequirednodefault—

Longer prose describing the audience and how to address them.

description.json

{
  "description": "description-value"
}

`seniority`

typeenumrequirednodefault—

Typical seniority level of the audience.

seniority.json

{
  "seniority": "ic"
}

`technicalFluency`

typeenumrequirednodefault—

Typical technical fluency of the audience.

technicalFluency.json

{
  "technicalFluency": "low"
}

`decisionPower`

typeenumrequirednodefault—

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

decisionPower.json

{
  "decisionPower": "informational"
}

`attentionBudgetMinutes`

typenumberrequirednodefault—

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

attentionBudgetMinutes.json

{
  "attentionBudgetMinutes": 1
}

`recommendedNarratives`

typearray<string>requirednodefault—

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

recommendedNarratives.json

{
  "recommendedNarratives": []
}

`recommendedTones`

typearray<string>requirednodefault—

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

recommendedTones.json

{
  "recommendedTones": []
}

`tags`

typearray<string>requirednodefault—

Free-form labels for filtering and search.

tags.json

{
  "tags": []
}