Skip to content

ppt connector add

zmworm edited this page May 4, 2026 · 52 revisions

PowerPoint: Connector - Add

Add connector lines between shapes or as standalone lines on a slide.

Path: /slide[N] (parent)

Properties

Property Default Description
x / left, y / top 2000000, 3000000 Start position (EMU; ~5.6cm, ~8.3cm)
width, height 4000000, 0 Extent in EMU (~11.1cm, 0)
name Connector {N} Connector name
preset straight straight, elbow, curve
line / color / line.color 000000 Line color
lineWidth / line.width 1pt Line width
lineDash / linedash solid Line dash style
fill hex RGB Connector fill color
headEnd / headend - Arrow head: none, triangle, stealth, diamond, oval, arrow
tailEnd / tailend - Arrow tail: none, triangle, stealth, diamond, oval, arrow
rotation 0 Rotation (degrees)
startShape / from - Connected start shape — accepts numeric shape ID or @name=ShapeName selector
endShape / to - Connected end shape — accepts numeric shape ID or @name=ShapeName selector

Line Dash Styles

solid, dot, dash, dashdot, longdash, longdashdot, sysdot, sysdash

Preset Types

Preset Description
straight Direct straight line
elbow Right-angle connector
curve Curved connector

Examples

# Standalone horizontal line
officecli add slides.pptx /slide[1] --type connector --prop x=5cm --prop y=5cm --prop width=10cm --prop height=0 --prop line=FF0000 --prop lineWidth=2pt

# Elbow connector between shapes
officecli add slides.pptx /slide[1] --type connector --prop preset=elbow --prop startShape=1 --prop endShape=2

# Connector by shape name
officecli add slides.pptx /slide[1] --type connector --prop from=@name=Box1 --prop to=@name=Box2

# Curved connector
officecli add slides.pptx /slide[1] --type connector --prop preset=curve --prop startShape=1 --prop endShape=3 --prop line=336699 --prop lineWidth=1.5pt

# Connector with dash style and color
officecli add slides.pptx /slide[1] --type connector --prop x=2cm --prop y=5cm --prop width=10cm --prop height=0 --prop lineColor=4472C4 --prop lineDash=dash --prop rotation=45

# Arrow connector (head and tail)
officecli add slides.pptx /slide[1] --type connector --prop x=3cm --prop y=3cm --prop width=8cm --prop height=0 --prop tailEnd=triangle

# Double arrow
officecli add slides.pptx /slide[1] --type connector --prop x=3cm --prop y=5cm --prop width=8cm --prop height=0 --prop headEnd=triangle --prop tailEnd=triangle

Based on OfficeCLI v1.0.71

Clone this wiki locally