Repository navigation
ppt group add
goworm edited this page Jul 8, 2026
·
54 revisions
Group multiple shapes together on a slide.
Path: /slide[N] (parent)
| Property | Default | Description |
|---|---|---|
shapes |
(required) | Comma-separated shape indices (1,2,3) or DOM paths (/slide[N]/shape[M], /slide[N]/shape[@id=ID]). Bare numeric indices count ALL top-level frames in z-order — including existing groups, pictures, and charts, not just the <p:sp>-only shape[N] address space. So on a slide tree [group, shapeC, shapeD], shapes=1,2 selects the group + shapeC (z-order positions 1,2), not the two plain shapes. Use explicit @id= paths for an unambiguous target (this also lets you nest a group inside a group). |
name |
Group {N} |
Group name |
link |
- | Hyperlink URL or slide[N] for in-presentation jump |
tooltip |
- | Hyperlink tooltip text (requires link) |
Get/Query/Remove/Add all descend into groups —
get /slide[1]/group[1]enumerates inner shapes,query shapereturns leaves inside group containers, mutation verbs accept group-internal paths.
# Group shapes 1, 2, and 3
officecli add slides.pptx /slide[1] --type group --prop shapes=1,2,3 --prop name="LogoGroup"
# Group two shapes
officecli add slides.pptx /slide[1] --type group --prop shapes=2,4Based on OfficeCLI v1.0.131
