PPTX

Presentation Properties

Configure presentation-level settings, view properties, photo albums, and modification protection

Presentation Settings

Set root-level attributes on the presentation (server zoom, first slide number, RTL, etc.):

{
  "firstSlideNum": 1,
  "rtl": false,
  "autoCompressPictures": true,
  "bookmarkIdSeed": 1234,
  "slides": [
    {
      "children": [
        { "shape": { "textBody": { "children": ["Presentation with custom settings"] } } }
      ]
    }
  ]
}

Root Attributes

OptionTypeDescription
serverZoomstringServer zoom level
firstSlideNumnumberFirst slide number
showSpecialPlsOnTitleSldbooleanShow placeholders on title slides
rtlbooleanRight-to-left layout
removePersonalInfoOnSavebooleanRemove personal info on save
compatModebooleanCompatibility mode
strictFirstAndLastCharsbooleanStrict first/last character rules
embedTrueTypeFontsbooleanEmbed TrueType fonts
saveSubsetFontsbooleanSave font subsets
autoCompressPicturesbooleanAuto-compress pictures
bookmarkIdSeednumberBookmark ID seed
conformancestring"strict" or "transitional"

Modification Protection

Protect the presentation from modification with a password. When password is provided, the SHA-512 hash with random salt and 100,000 iterations is computed automatically:

{
  "modifyVerifier": {
    "password": "secret"
  },
  "slides": [
    {
      "children": [{ "shape": { "textBody": { "children": ["Protected presentation"] } } }]
    }
  ]
}

Modify Verifier Options

OptionTypeDescription
passwordstringPlaintext password (auto-hashed)
algorithmNamestringHash algorithm (default: "SHA-512")
hashValuestringBase64-encoded password hash
saltValuestringBase64-encoded salt
spinValuenumberSpin value
spinCountnumberHash iterations
cryptoProviderTypestringCryptographic provider type
cryptoAlgorithmClassstringAlgorithm class
cryptoAlgorithmTypestringAlgorithm type
cryptoAlgorithmSidnumberAlgorithm SID
cryptoProviderstringCryptographic provider
saltDatastringBase64-encoded salt data
hashDatastringBase64-encoded hash data
algorithmExtensionIdnumberAlgorithm extension ID
algorithmExtensionSourcestringAlgorithm extension source
cryptoProviderTypeExtensionnumberCryptographic provider type extension
cryptoProviderTypeExtensionSourcestringCryptographic provider type extension source

View Properties

Configure how the presentation appears when opened:

{
  "view": {
    "lastView": "slideView",
    "showComments": true,
    "gridSpacing": { "cx": 50800, "cy": 50800 }
  },
  "slides": [
    {
      "children": [{ "shape": { "textBody": { "children": ["Slide with view settings"] } } }]
    }
  ]
}

View Options

OptionTypeDescription
lastViewstringLast active view ("slideView", "slideMasterView", "notesView", "handoutView", "outlineView", "slideSorterView")
showCommentsbooleanShow comments
gridSpacingobjectGrid spacing { cx, cy } in EMU
zoomScaleNumeratornumberZoom scale numerator
zoomScaleDenominatornumberZoom scale denominator
normalViewobjectNormal view settings
slideViewobjectSlide view settings

Normal View Options

OptionTypeDescription
showOutlineIconsbooleanShow outline icons
snapVertSplitterbooleanSnap vertical splitter
vertBarStatestring"restored", "maximized", or "minimized"
horzBarStatestring"restored", "maximized", or "minimized"
preferSingleViewbooleanPrefer single view

Slide View Options

OptionTypeDescription
snapToGridbooleanSnap shapes to grid
snapToObjectsbooleanSnap to objects
showGuidesbooleanShow guides
varScalebooleanVariable scale

Show, Web, and Print Properties

Configure slide show, web publishing, and print settings:

{
  "show": {
    "type": "present",
    "showNarration": true,
    "useTimings": true
  },
  "web": {
    "showAnimation": true,
    "resizeGraphics": true
  },
  "print": {
    "printWhat": "handouts4",
    "colorMode": "color"
  },
  "slides": [
    {
      "children": [{ "shape": { "textBody": { "children": ["Full presentation properties"] } } }]
    }
  ]
}

Show Options

OptionTypeDescription
typestring"present", "kiosk", or "browse"
loopbooleanLoop continuously
showScrollbarbooleanShow scrollbar in browse mode
slideRangeobjectSlide range { start, end } (1-based)
restartnumberAuto-restart timeout (ms) for kiosk mode
showNarrationbooleanPlay narration during slide show
showAnimationbooleanPlay animations during slide show
useTimingsbooleanUse recorded timings
penColorstringLaser pointer color (hex)

Web Options

OptionTypeDescription
showAnimationbooleanShow animations in web
resizeGraphicsbooleanResize graphics
allowPngbooleanAllow PNG images
relyOnVmlbooleanRely on VML
organizeInFoldersbooleanOrganize in folders
useLongFilenamesbooleanUse long filenames
imageSizestringImage size
encodingstringCharacter encoding
colorstringColor mode
OptionTypeDescription
printWhatstringWhat to print ("slides", "handouts1", "handouts2", "handouts3", "handouts4", "handouts6", "handouts9", "notes", "outline")
colorModestring"color", "gray", or "blackWhite"
hiddenSlidesbooleanPrint hidden slides
scaleToFitPaperbooleanScale to fit paper
frameSlidesbooleanFrame slides

HTML Publishing

Configure HTML publishing properties for web output:

{
  "htmlPublish": {
    "showSpeakerNotes": true,
    "title": "Published Slides",
    "rId": "rId1"
  },
  "slides": [
    {
      "children": [{ "shape": { "textBody": { "children": ["HTML publish demo"] } } }]
    }
  ]
}

HTML Publish Options

OptionTypeDescription
showSpeakerNotesbooleanInclude speaker notes
titlestringPublished presentation title
rIdstringRelationship ID

Photo Album

Create photo album presentations with layout and frame options:

{
  "photoAlbum": {
    "showCaptions": true,
    "layout": "2pic",
    "frame": "frameStyle1"
  },
  "slides": [
    {
      "children": [{ "shape": { "textBody": { "children": ["Photo Album"] } } }]
    }
  ]
}

Photo Album Options

OptionTypeDescription
blackWhitebooleanBlack and white mode
showCaptionsbooleanShow captions under pictures
layoutstring"fitToSlide", "1pic", "2pic", "4pic", "1picTitle", "2picTitle", "4picTitle"
framestring"frameStyle1" through "frameStyle7", or "none"
Copyright © 2026