DOCX
SmartArt
Create SmartArt graphics with built-in layouts and tree-structured data
Add SmartArt graphics to documents using the smartArt property.
Basic SmartArt
{
"sections": [
{
"children": [
{
"paragraph": {
"children": [
{
"smartArt": {
"nodes": [{ "text": "Step 1" }, { "text": "Step 2" }, { "text": "Step 3" }],
"transformation": { "width": "11.9cm", "height": "6.6cm" }
}
}
]
}
}
]
}
]
}
{
children: [
{
paragraph: {
children: [
{
smartArt: {
nodes: [{ text: "Step 1" }, { text: "Step 2" }, { text: "Step 3" }],
transformation: { width: "11.9cm", height: "6.6cm" },
},
},
],
},
},
],
}
Hierarchical Data
Nodes support nested children for hierarchical layouts:
{
"sections": [
{
"children": [
{
"paragraph": {
"children": [
{
"smartArt": {
"nodes": [
{
"text": "CEO",
"children": [
{
"text": "VP Engineering",
"children": [{ "text": "Frontend" }, { "text": "Backend" }]
},
{
"text": "VP Marketing",
"children": [{ "text": "Brand" }, { "text": "Growth" }]
}
]
}
],
"transformation": { "width": "13.2cm", "height": "9.3cm" },
"layout": "hierarchy1"
}
}
]
}
}
]
}
]
}
{
smartArt: {
nodes: [
{
text: "CEO",
children: [
{
text: "VP Engineering",
children: [{ text: "Frontend" }, { text: "Backend" }],
},
{
text: "VP Marketing",
children: [{ text: "Brand" }, { text: "Growth" }],
},
],
},
],
transformation: { width: "13.2cm", height: "9.3cm" },
layout: "hierarchy1",
},
}
Layout, Style, and Color
Customize the appearance with layout, style, and color:
{
"sections": [
{
"children": [
{
"paragraph": {
"children": [
{
"smartArt": {
"nodes": [
{ "text": "Plan" },
{ "text": "Design" },
{ "text": "Build" },
{ "text": "Test" },
{ "text": "Deploy" }
],
"transformation": { "width": "14.6cm", "height": "6.6cm" },
"layout": "process1",
"style": "moderate1",
"color": "accent3_2"
}
}
]
}
}
]
}
]
}
{
smartArt: {
nodes: [
{ text: "Plan" },
{ text: "Design" },
{ text: "Build" },
{ text: "Test" },
{ text: "Deploy" },
],
transformation: { width: "14.6cm", height: "6.6cm" },
layout: "process1",
style: "moderate1",
color: "accent3_2",
},
}
Layout IDs
| Category | Layout IDs |
|---|---|
| Default | "default" |
| List | "list1", "list2", "vList2", "hList1", "pList1" |
| Process | "process1", "process2", "process3", "chevron1", "arrow1" |
| Cycle | "cycle1", "cycle2", "cycle3", "cycle4", "cycle5" |
| Hierarchy | "hierarchy1", "hierarchy2", "hierarchy3", "orgChart1" |
| Pyramid | "pyramid1", "pyramid2", "pyramid3" |
| Matrix | "matrix1", "matrix2", "matrix3" |
| Other | "radial1", "venn1", "funnel1", "balance1", "gear1" |
Style IDs
"simple1"--"simple5", "moderate1"--"moderate4", "polished1"--"polished4", "professional1"--"professional4"
Color IDs
"accent1_2"--"accent6_2", "colorful1"--"colorful4", "dark1", "dark2", "primary1", "primary2", "gray1", "gray2"
SmartArt Options
| Option | Type | Description |
|---|---|---|
nodes | SmartArtNode[] | Tree-structured node data |
transformation | { width, height } | Display dimensions |
layout | string | Layout ID (default: "default") |
style | string | Style ID (default: "simple1") |
color | string | Color ID (default: "accent1_2") |
floating | object | Floating positioning options |
altText | object | Alternative text for accessibility |
SmartArtNode
| Property | Type | Description |
|---|---|---|
text | string | Display text |
children | SmartArtNode[] | Child nodes (optional) |