Comments
Adding Comments
Use the comments option on each slide to add comments with author, text, and position:
{
"slides": [
{
"children": [
{
"shape": {
"x": "1.3cm",
"y": "0.8cm",
"width": "13.2cm",
"height": "1.6cm",
"textBody": { "text": "Slide with Comments" },
"fill": "4472C4"
}
}
],
"comments": [
{
"author": "Alice Wang",
"text": "The title looks great!",
"x": "5.3cm",
"y": "1.3cm",
"date": "2026-05-15T10:00:00Z"
},
{
"author": "Bob Li",
"text": "Consider changing the content color.",
"x": "7.9cm",
"y": "4.8cm",
"initials": "BL",
"date": "2026-05-15T11:00:00Z"
}
]
}
]
}
{
children: [
{
shape: {
x: "1.3cm",
y: "0.8cm",
width: "13.2cm",
height: "1.6cm",
textBody: { text: "Slide with Comments" },
fill: "4472C4",
},
},
],
comments: [
{
author: "Alice Wang",
text: "The title looks great!",
x: "5.3cm",
y: "1.3cm",
date: "2026-05-15T10:00:00Z",
},
{
author: "Bob Li",
text: "Consider changing the content color.",
x: "7.9cm",
y: "4.8cm",
initials: "BL",
date: "2026-05-15T11:00:00Z",
},
],
}
Comment Options
| Property | Type | Description |
| ---------- | -------- | --------------------------------------------------- | ------------------------------------------------------------------- |
| author | string | Author display name |
| text | string | Comment text content |
| x | number | UniversalMeasure | Horizontal position of the comment marker (EMU or UniversalMeasure) |
| y | number | UniversalMeasure | Vertical position of the comment marker (EMU or UniversalMeasure) |
| initials | string | Author initials (auto-derived from name if omitted) |
| date | string | ISO 8601 date string |
Author Deduplication
Authors are automatically deduplicated across all slides. If the same author name appears on multiple slides, they share a single author entry with a unified initials and color index.