PPTX

SmartArt

Create predefined SmartArt diagrams for processes, hierarchies, and more

Use SmartArtFrame to add SmartArt graphics — predefined diagram layouts for visualizing processes, hierarchies, relationships, and more.

Basic SmartArt

import { Slide, SmartArtFrame } from "@office-open/pptx";

new Slide({
    children: [
        new SmartArtFrame({
            x: 1,
            y: 1,
            width: 8,
            height: 4,
            layout: "process",
            data: [
                { text: "Step 1", bullets: ["Detail A"] },
                { text: "Step 2", bullets: ["Detail B"] },
                { text: "Step 3", bullets: ["Detail C"] },
            ],
        }),
    ],
});

Available Layouts

Common SmartArt layouts include:

LayoutDescription
processSequential process steps
cycleCircular / repeating process
hierarchyOrganizational hierarchy
relationshipRadial / relationship diagram
matrixMatrix layout
pyramidPyramid / proportional
listVertical list
chevronChevron process flow

Hierarchy Example

new SmartArtFrame({
    x: 0.5,
    y: 0.5,
    width: 9,
    height: 5,
    layout: "hierarchy",
    data: [
        { text: "CEO" },
        {
            text: "CTO",
            bullets: ["Engineering", "Product"],
        },
        {
            text: "CFO",
            bullets: ["Finance", "Accounting"],
        },
    ],
});

Cycle Example

new SmartArtFrame({
    x: 1,
    y: 1,
    width: 7,
    height: 4,
    layout: "cycle",
    data: [
        { text: "Plan" },
        { text: "Design" },
        { text: "Develop" },
        { text: "Test" },
        { text: "Deploy" },
    ],
});

Styling SmartArt

Control the color scheme and quick style:

new SmartArtFrame({
    x: 1,
    y: 1,
    width: 8,
    height: 4,
    layout: "process",
    data: [{ text: "Phase 1" }, { text: "Phase 2" }, { text: "Phase 3" }],
    colorStyle: "accent2_1", // Color scheme
    quickStyle: "simple", // Visual style
});

Nested Data with Bullets

new SmartArtFrame({
    x: 1,
    y: 1,
    width: 8,
    height: 5,
    layout: "list",
    data: [
        {
            text: "Strategy",
            bullets: ["Market Analysis", "Competitive Review", "Growth Planning"],
        },
        {
            text: "Execution",
            bullets: ["Product Development", "Sales & Marketing"],
        },
    ],
});

Color Styles

Available color style options:

ValueDescription
"accent1_1""accent6_1"Accent color, variation 1
"accent1_2""accent6_2"Accent color, variation 2
"accent1_3""accent6_3"Accent color, variation 3
"colorful"Multi-color
"primary"Primary theme color

Quick Styles

ValueDescription
"simple"Simple, clean look
"whiteOutline"White outline style
"intense"Bold, high contrast
"gradient"Gradient fill
"flat"Flat, no 3D effects

SmartArtFrame Options

OptionTypeDescription
xnumberHorizontal position in inches
ynumberVertical position in inches
widthnumberWidth in inches
heightnumberHeight in inches
layoutstringSmartArt layout name
dataarrayArray of { text, bullets? } objects
colorStylestringColor scheme identifier
quickStylestringVisual style identifier
Copyright © 2026