DocsObject reference
OPF objects
Reusable object definitions from the presentation schema, including slide content, design, catalog, chart, table, and metadata objects.
Object index
AssetAssetReusable or inline resource. A string is shorthand for { "src": value }. Source strings accept 'asset:<id>' references, HTTPS URLs, data URIs, relative paths resolved against the OPF file location, or local fi…AssetsAssetsReusable asset registry for resources used by slides, charts, metadata, and design. Keys are stable asset ids referenced elsewhere as 'asset:<id>'. Each asset can be a source string or an object with src plus…AudienceAudienceInline 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.BackgroundBackgroundBackground fill applied to slides. Theme backgrounds preserve PowerPoint's color-scheme background choice; other variants represent fixed background fills.Background ShortcutBackgroundShortcutString shorthand for a background. Theme slots ('light1', 'light2', 'dark1', 'dark2') are equivalent to { type: 'theme', slot: value }; hex colors are equivalent to { type: 'solid', color: value }.Bullet ItemBulletItemA flat bullet item. Strings cover the common case, TextRun[] supports inline rich text without an object wrapper, and object form adds nesting depth without list-item descriptions.Catalog EntryCatalogEntryA catalog override for one record kind. 'source' replaces the default registry; 'records' adds inline records that take precedence over anything fetched from a source. Either or both may be provided; both omit…Catalog SourceCatalogSourceCatalog source location. Accepts: - A bare URL pointing at a catalog directory (e.g. 'https://acme.com/decks/narratives'); record ids resolve to '<base>/<id>.json'. - A URL pointing at an index file (e.g. 'htt…CatalogsCatalogsCatalog overrides for the in-document references. Every property is optional. The default catalog for a kind lives at https://www.pptx.gallery/<kind> (e.g. https://www.pptx.gallery/narratives, https://www.pptx…ChartChartChart content. The chart object keeps chart-specific fields together so slides and regions do not expose loose chart fields.Chart DataChartDataInline tabular data driving a chart. The first column usually supplies category/x-axis labels; subsequent columns are plotted measures unless a chart type or renderer maps them differently.Chart Data CellChartDataCellA cell in inline chart data.Chart Data SourceChartDataSourceChart data sourced from an asset reference, URL, data URI, relative path, or local path such as CSV, TSV, JSON, or XLSX. The source is interpreted as a table; optional columns select or order fields from that…CodeCodeCode content with optional rendering metadata. Use 'source' for the code text, 'language' for syntax highlighting, and 'filename' when the rendered block should show a file label. A string value in a code fiel…Color SchemeColorSchemeColor palette used by the design system. The slot fields (accent1-accent6, dark1, dark2, light1, light2, hyperlink, followedHyperlink) mirror color-scheme.schema.json (https://openpresentation.org/schema/opf-c…Content PayloadContentPayloadA single content payload. The optional 'type' discriminator can make intent explicit, but validators and engines infer it from fields such as text, bullets, items, image, video, chart, table, code, metric, quo…DesignDesignVisual design system applied to the presentation; individual slides may override fields via Slide.design.Dimension PresetDimensionPresetNamed dimension preset; chooses both aspect ratio and physical size. 'widescreen' is an alias for 16:9 in PowerPoint widescreen size; 'standard' is an alias for 4:3 in PowerPoint standard size.DimensionsDimensionsSlide dimensions; either pick a preset or specify custom inches.FontFontSpecification for a single font role.Font SchemeFontSchemeTypography selections used by the design system. The pair fields (major, minor) and refinement fields (type, app, languageFamily) mirror font-scheme.schema.json (https://openpresentation.org/schema/opf-font-sc…Gradient BackgroundGradientBackgroundFixed gradient slide background fill.Header FooterHeaderFooterRepeated header or footer content split into left, center, and right zones. Header/footer content is slide furniture, separate from the main slide content payloads.Header Footer ItemHeaderFooterItemOne header/footer zone. Fields may be combined when the renderer supports it; otherwise renderers should prefer image, then text-like generated content.Hex ColorHexColorHex color shorthand accepted by selected string fields.Image BackgroundImageBackgroundFixed image slide background fill.LanguageLanguageInline 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.List ItemListItemA flat item inside a list. Strings cover the common case, TextRun[] supports inline rich text without an object wrapper, and object form adds description and nesting depth without creating nested slide content…Logo SetLogoSetDeck logo variants surfaced by layouts, covers, section dividers, headers, and footers. Organization identity lives in organization; this object only controls visual rendering assets. Renderer convention: on d…MetricMetricMetric content with optional display metadata. Use 'value' for the primary value, 'label' for the metric name, 'description' for supporting context, 'unit' for a suffix/currency marker, 'delta' for change, and…NarrativeNarrativeStructured storyline used by AI to shape generated content. Mirrors the OPF Narrative Template record at https://openpresentation.org/schema/opf-narrative/v1 (sans '$schema'), so a library record and an inline…Narrative BeatNarrativeBeatA single narrative beat — a labeled segment of the story arc with a specific dramatic purpose (e.g. 'hook', 'problem', 'evidence', 'ask'). Slides reference beats via Slide.beat. Beats may also carry slide-blue…OrganizationOrganizationAn organization associated with the presentation — typically the presenting company, but also hosts, partners, clients, or sponsors. Surfaced on cover slides, footers, and brand bars; the primary organization'…Pattern BackgroundPatternBackgroundFixed pattern slide background fill.PurposePurposeInline purpose metadata for the presentation. Use 'id' to reference a purposes catalog record and override selected fields, or use 'name' for a custom inline purpose.QuoteQuoteQuote content with optional attribution metadata. Use 'text' for the quoted text, 'attribution' for the credited person or organization, and 'source' for a citation or URL. A string value in a quote field is s…SlideSlideA single slide. Content can be authored as a full-slide root payload, or inside promoted named region keys such as 'left', 'center+right', and 'top:left'.SocialsSocialsSocial media handles or URLs, keyed by platform id from the 'socialPlatforms' catalog. Each value is a string — either a full URL or a platform handle (e.g., '@acme'). The catalog record for each platform carr…Solid BackgroundSolidBackgroundFixed solid slide background fill.SpeakerSpeakerA person presenting the deck. Used for cover slides, bio/intro slides, footer attribution, and panel formats with multiple presenters.TableTableTable content. Columns are optional; rows are the only required field.Table CellTableCellA cell in table content.Text RunTextRunA contiguous run of text. Strings cover unformatted spans; object form adds character formatting.ThemeThemeTheme bundle used by the design system. In design.theme, 'id' resolves a themes catalog record as the base; any sibling fields override the resolved theme. The string shorthand on design.theme is equivalent to…Theme BackgroundThemeBackgroundTheme-controlled PowerPoint slide background. The slot is resolved through the active color scheme and remains theme-aware.Theme Background SlotThemeBackgroundSlotPowerPoint theme-controlled slide background slot from the active color scheme. These are slots, not assumptions about actual colors: light1 is usually white and dark1 is usually black by convention, but the c…TimelineTimelineTimeline content. An array is shorthand for { "events": value }; object form carries optional name and description metadata.Timeline EventTimelineEventA single event inside a timeline content payload.ToneToneInline tone metadata for the presentation. Use 'id' to reference a tones catalog record and override selected fields, or use 'name' for a custom inline tone.WatermarkWatermarkDecorative watermark image and rendering options. Use design.watermark = false to disable an inherited watermark.