OPF
OpenPresentation/opf
SpecDefinition referenceView source

Audience

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

Metadata

Definition
#/$defs/Audience
Form
2 inclusive forms (anyOf)
Source
spec/schemas/opf.schema.json

Field index

FieldTypeReq.Description
idref:CatalogReference—Optional audiences reference (a bare id or 'name:id') resolved before applying the inline overrides.
namestring—Human-readable audience name shown in pickers.
summarystring—One-sentence positioning of the audience.
descriptionstring—Longer prose describing the audience and how to address them.
seniorityenum—Typical seniority level of the audience.
seniority · Allowed values
"ic""manager""director""vp""c-suite""mixed"
technicalFluencyenum—Typical technical fluency of the audience.
technicalFluency · Allowed values
"low""medium""high""mixed"
decisionPowerenum—Whether the audience is expected to be informed, advise, or decide.
decisionPower · Allowed values
"informational""advisory""decision-maker"
attentionBudgetMinutesnumber—Realistic upper bound on focused attention for a single presentation, in minutes.
recommendedNarrativesarray<string>—Soft cross-link: narrative ids that work well for this audience, for picker UIs. Never resolved, embedded or validated as references.
recommendedTonesarray<string>—Soft cross-link: tone ids that work well for this audience, for picker UIs. Never resolved, embedded or validated as references.
tagsarray<string>—Free-form labels for filtering and search.

id

typeref:CatalogReferencerequirednodefault—

Optional audiences reference (a bare id or 'name:id') resolved before applying the inline overrides.

id.json
{
  "id": "executive"
}

name

typestringrequirednodefault—

Human-readable audience name shown in pickers.

summary

typestringrequirednodefault—

One-sentence positioning of the audience.

description

typestringrequirednodefault—

Longer prose describing the audience and how to address them.

seniority

typeenumrequirednodefault—

Typical seniority level of the audience.

seniority · Allowed values
"ic""manager""director""vp""c-suite""mixed"
seniority.json
{
  "seniority": "ic"
}

technicalFluency

typeenumrequirednodefault—

Typical technical fluency of the audience.

technicalFluency · Allowed values
"low""medium""high""mixed"
technicalFluency.json
{
  "technicalFluency": "low"
}

decisionPower

typeenumrequirednodefault—

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

decisionPower · Allowed values
"informational""advisory""decision-maker"
decisionPower.json
{
  "decisionPower": "informational"
}

attentionBudgetMinutes

typenumberrequirednodefault—

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

recommendedNarratives

typearray<string>requirednodefault—

Soft cross-link: narrative ids that work well for this audience, for picker UIs. Never resolved, embedded or validated as references.

recommendedTones

typearray<string>requirednodefault—

Soft cross-link: tone ids that work well for this audience, for picker UIs. Never resolved, embedded or validated as references.

tags

typearray<string>requirednodefault—

Free-form labels for filtering and search.

anyOf 1 · object

Exact constraints for anyOf 1
anyOf 1 schema
{
  "required": [
    "id"
  ]
}

anyOf 2 · object

Exact constraints for anyOf 2
anyOf 2 schema
{
  "required": [
    "name"
  ]
}
Complete definition constraints
Schema constraints
{
  "type": "object",
  "description": "Inline audience metadata for the presentation. Use 'id' to reference an audiences record (a bare id or 'name:id') and override selected fields, or use 'name' for a custom inline audience.",
  "anyOf": [
    {
      "required": [
        "id"
      ]
    },
    {
      "required": [
        "name"
      ]
    }
  ],
  "properties": {
    "id": {
      "$ref": "#/$defs/CatalogReference",
      "description": "Optional audiences reference (a bare id or 'name:id') resolved before applying the inline overrides.",
      "examples": [
        "executive",
        "board",
        "engineering-team"
      ]
    },
    "name": {
      "type": "string",
      "description": "Human-readable audience name shown in pickers."
    },
    "summary": {
      "type": "string",
      "description": "One-sentence positioning of the audience."
    },
    "description": {
      "type": "string",
      "description": "Longer prose describing the audience and how to address them."
    },
    "seniority": {
      "type": "string",
      "enum": [
        "ic",
        "manager",
        "director",
        "vp",
        "c-suite",
        "mixed"
      ],
      "description": "Typical seniority level of the audience."
    },
    "technicalFluency": {
      "type": "string",
      "enum": [
        "low",
        "medium",
        "high",
        "mixed"
      ],
      "description": "Typical technical fluency of the audience."
    },
    "decisionPower": {
      "type": "string",
      "enum": [
        "informational",
        "advisory",
        "decision-maker"
      ],
      "description": "Whether the audience is expected to be informed, advise, or decide."
    },
    "attentionBudgetMinutes": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Realistic upper bound on focused attention for a single presentation, in minutes."
    },
    "recommendedNarratives": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Soft cross-link: narrative ids that work well for this audience, for picker UIs. Never resolved, embedded or validated as references."
    },
    "recommendedTones": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Soft cross-link: tone ids that work well for this audience, for picker UIs. Never resolved, embedded or validated as references."
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Free-form labels for filtering and search."
    }
  }
}