Skip to content

ppt slide set

zmworm edited this page Apr 29, 2026 · 51 revisions

PowerPoint: Slide - Set

Modify slide properties including background, transition, advance timing, and speaker notes.

Path: /slide[N]

Properties

Property Accepted Values Description
background color/gradient/image Background
transition transition format Transition effect
advanceTime milliseconds Auto-advance delay
advanceClick bool Advance on click
notes text Speaker notes
layout layout name Change slide layout (e.g., Title and Content, titleOnly, blank)
align alignment value Align shapes on slide
distribute horizontal, vertical Distribute shapes evenly
hidden bool Hide the slide from playback (sets sld@show=0). query 'slide[hidden=true]' filters hidden slides.
showFooter bool Show the footer placeholder on this slide
showSlideNumber bool Show the slide number placeholder
showDate bool Show the date/time placeholder
showHeader bool Show the header placeholder

Align Values

  • Shape-relative: left, center, right, top, middle, bottom
  • Slide-relative: slide-left, slide-center, slide-right, slide-top, slide-middle, slide-bottom

Use targets=shape[1],shape[2] to target specific shapes; omit for all shapes.

Background Format

Format Example Description
Solid FF0000 Hex RGB
Linear gradient C1-C2 or C1-C2-angle Two colors with optional angle
Custom stops C1@30-C2@70 Custom stop positions (percent)
Semicolon linear LINEAR;C1;C2;angle Explicit linear gradient
Semicolon radial RADIAL;C1;C2 Radial gradient
Semicolon path PATH;C1;C2 Path gradient
Radial gradient radial:C1-C2[-focus] Focus: tl, tr, bl, br, center
Three-stop C1-C2-C3 Three gradient stops
Image image:/path/to/file.png Image background
Clear none / transparent / clear Remove background

Transition Format

Format: TYPE[-DIRECTION][-SPEED|DURATION] or none

Types: fade, cut, dissolve, wipe, push, cover, pull, split, zoom, wheel, blinds, checker, comb, bars, strips, circle, diamond, newsflash, plus, random, wedge, flash, honeycomb, vortex, switch, flip, ripple, glitter, prism, doors, window, shred, ferris, flythrough, warp, gallery, conveyor, pan, reveal, box, uncover

Morph: morph (byObject), morph-byWord, morph-byChar

Note: Morph transitions auto-prefix shape names with !! to enable morph matching between slides.

Office 2010+ transitions: vortex, switch, flip, ripple, glitter, prism, flash, and honeycomb are wrapped in mc:AlternateContent for compatibility with older PowerPoint versions.

switch / flip directions: These transitions accept left or right direction (e.g. transition=switch-left, transition=flip-right).

Directions: left, right, up, down, in, out, horizontal, vertical

Speed: slow, medium, fast, or milliseconds

Examples

# Set solid background
officecli set slides.pptx /slide[1] --prop background=1A1A2E

# Set gradient background
officecli set slides.pptx /slide[1] --prop "background=4472C4-1A1A2E"

# Set image background
officecli set slides.pptx /slide[1] --prop background=image:bg.jpg

# Set transition
officecli set slides.pptx /slide[1] --prop transition=fade
officecli set slides.pptx /slide[1] --prop transition=wipe-left
officecli set slides.pptx /slide[1] --prop transition=zoom-out-slow

# Set morph transition
officecli set slides.pptx /slide[2] --prop transition=morph
officecli set slides.pptx /slide[2] --prop transition=morph-byWord
officecli set slides.pptx /slide[2] --prop transition=morph-byChar

# Set switch transition with direction
officecli set slides.pptx /slide[1] --prop transition=switch-left

# Set morph with advance timing
officecli set slides.pptx /slide[2] --prop transition=morph --prop advanceTime=3000 --prop advanceClick=true

# Set auto-advance
officecli set slides.pptx /slide[1] --prop advanceTime=5000 --prop advanceClick=true

# Set speaker notes
officecli set slides.pptx /slide[1] --prop notes="Discuss Q4 revenue growth"

# Align shapes to slide center
officecli set slides.pptx /slide[1] --prop align=slide-center --prop targets=shape[1],shape[2]

# Distribute shapes horizontally
officecli set slides.pptx /slide[1] --prop distribute=horizontal --prop targets=shape[1],shape[2],shape[3]

Based on OfficeCLI v1.0.64

Clone this wiki locally