{}OPF
DocsObject referenceEdit on GitHub

Language

Inline language metadata for the presentation. Use 'id' to reference a languages catalog record and override selected fields, or use 'bcp47' for a custom language tag without a catalog record.

Metadata

Definition

#/$defs/Language

Type

object | object

Source

spec/schemas/opf.schema.json

Fields

FieldTypeReqDescription
idstringOptional languages catalog id to resolve before applying inline overrides.
namestringHuman-readable language name.
bcp47stringBCP-47 language tag used for locale-aware rendering, proofing, and accessibility metadata. Use 'en-GB' for UK English; 'en-UK' is not a valid BCP-47 region form.
codestringISO 639-3 or 639-2 language code carried for engines that prefer ISO codes.
directionenumBase text direction for the language.
scriptstringISO 15924 script code when the writing system should be explicit.
fontSchemestringDefault font-scheme id for this language when targeting PowerPoint output.
googleFontSchemestringDefault font-scheme id for this language when targeting Google Slides output.
summarystringOne-sentence note about coverage or font defaults.
descriptionstringLonger prose describing the language record and any font-pairing rationale.
tagsarray<string>Free-form labels for filtering and search.

id

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

Optional languages catalog id to resolve before applying inline overrides.

id.json
{
  "id": "english"
}

name

Type: string · Optional · Default:

Human-readable language name.

name.json
{
  "name": "English"
}

bcp47

Type: string · Optional · Default:

BCP-47 language tag used for locale-aware rendering, proofing, and accessibility metadata. Use 'en-GB' for UK English; 'en-UK' is not a valid BCP-47 region form.

bcp47.json
{
  "bcp47": "en"
}

code

Type: string · Optional · Default:

ISO 639-3 or 639-2 language code carried for engines that prefer ISO codes.

code.json
{
  "code": "ENG"
}

direction

Type: enum · Optional · Default:

Base text direction for the language.

direction.json
{
  "direction": "ltr"
}

script

Type: string · Optional · Default:

ISO 15924 script code when the writing system should be explicit.

script.json
{
  "script": "Latn"
}

fontScheme

Type: string · Optional · Default:

Default font-scheme id for this language when targeting PowerPoint output.

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

googleFontScheme

Type: string · Optional · Default:

Default font-scheme id for this language when targeting Google Slides output.

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

summary

Type: string · Optional · Default:

One-sentence note about coverage or font defaults.

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

description

Type: string · Optional · Default:

Longer prose describing the language record and any font-pairing rationale.

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

tags

Type: array<string> · Optional · Default:

Free-form labels for filtering and search.

tags.json
{
  "tags": []
}