DocsSchema referenceView source

Font Scheme

Schema for font-scheme records in the pptx.gallery library. Each scheme pairs a major (heading) and minor (body) font family in the OOXML majorFont/minorFont sense, scoped to a target app (PowerPoint or Google…

Schema $id: https://openpresentation.org/schema/opf-font-scheme/v1
Type: object
Source: spec/schemas/font-scheme.schema.json
Fields: 14 · 5 required

Field index

Field	Type	Req.	Default	Description
$schema	const	yes	—	Identifies this record as a font scheme in the openpresentation.org catalog.
id	string	yes	—	Stable slug used by OPF documents to reference this font scheme. Lowercase kebab-case.
name	string	yes	—	Human-readable scheme name shown in pickers.
major	string	yes	—	Heading (major) font family — mirrors the OOXML majorFont entry.
minor	string	yes	—	Body (minor) font family — mirrors the OOXML minorFont entry.
type	enum	—	—	High-level typographic class of the scheme.
app	enum	—	—	Target application this font pairing is intended for.
languageFamily	enum	—	—	OOXML font-language family this scheme is intended for: 'latin' for Latin-script content, 'ea' for East Asian scripts, 'cs' for Complex Scripts.
languages	array<string>	—	—	Optional list of human-readable language names this scheme is curated for. Useful for picker UIs that group fonts by language coverage.
textSample	string	—	—	Short specimen string used by picker UIs to preview the scheme.
summary	string	—	—	One-sentence positioning of the font pairing.
description	string	—	—	Longer prose describing the font scheme and where it shines.
tags	array<string>	—	—	Free-form labels for filtering and search.
preview	object	—	—	Visual previews of the record, used by picker UIs and inline rendering. All sub-fields are optional; engines fall back gracefully when previews aren't available.

`$schema`

typeconstrequiredyesdefault—

Identifies this record as a font scheme in the openpresentation.org catalog.

$schema.json

{
  "$schema": "https://openpresentation.org/schema/opf-font-scheme/v1"
}

`id`

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

Stable slug used by OPF documents to reference this font scheme. Lowercase kebab-case.

id.json

{
  "id": "aptos"
}

`name`

typestringrequiredyesdefault—

Human-readable scheme name shown in pickers.

name.json

{
  "name": "Aptos"
}

`major`

typestringrequiredyesdefault—

Heading (major) font family — mirrors the OOXML majorFont entry.

major.json

{
  "major": "Aptos Display"
}

`minor`

typestringrequiredyesdefault—

Body (minor) font family — mirrors the OOXML minorFont entry.

minor.json

{
  "minor": "Aptos"
}

`type`

typeenumrequirednodefault—

High-level typographic class of the scheme.

type.json

{
  "type": "sans-serif"
}

`app`

typeenumrequirednodefault—

Target application this font pairing is intended for.

app.json

{
  "app": "PowerPoint"
}

`languageFamily`

typeenumrequirednodefault—

OOXML font-language family this scheme is intended for: 'latin' for Latin-script content, 'ea' for East Asian scripts, 'cs' for Complex Scripts.

languageFamily.json

{
  "languageFamily": "latin"
}

`languages`

typearray<string>requirednodefault—

Optional list of human-readable language names this scheme is curated for. Useful for picker UIs that group fonts by language coverage.

languages.json

{
  "languages": [
    "Chinese (simplified)",
    "Chinese (traditional)",
    "Japanese",
    "Korean"
  ]
}

`textSample`

typestringrequirednodefault—

Short specimen string used by picker UIs to preview the scheme.

textSample.json

{
  "textSample": "Smooth professional look"
}

`summary`

typestringrequirednodefault—

One-sentence positioning of the font pairing.

summary.json

{
  "summary": "PowerPoint-default sans-serif curated for general business decks."
}

`description`

typestringrequirednodefault—

Longer prose describing the font scheme and where it shines.

description.json

{
  "description": "Aptos is the default Microsoft 365 sans-serif. The major (display) cut adds optical weight for headings, and the minor (text) cut keeps body copy readable at smaller sizes."
}

`tags`

typearray<string>requirednodefault—

Free-form labels for filtering and search.

tags.json

{
  "tags": [
    "latin",
    "sans-serif",
    "default"
  ]
}

`preview`

typeobjectrequirednodefault—

Visual previews of the record, used by picker UIs and inline rendering. All sub-fields are optional; engines fall back gracefully when previews aren't available.

preview.json

{
  "preview": {}
}