/figma-use-slides

Slide Lifecycle

Creating slides

// Append a slide to the end of the deck (last child of last row)
const slide = figma.createSlide();

// Create a slide at a specific position in the grid (row 0, column 2)
const slide = figma.createSlide(0, 2);

createSlide returns a SlideNode (extends BaseFrameMixin). The slide is automatically parented into the slide grid.

Creating slide rows

// Append a new row to the end of the slide grid
const row = figma.createSlideRow();

// Insert a row at a specific position (index 0 = first row)
const row = figma.createSlideRow(0);

createSlideRow returns a SlideRowNode. New rows start empty — create slides within them using createSlide(rowIndex, colIndex).

Slide sections

Every slide row is a section. Without a name set, a row shows up in the UI as "Section" (the default label); setting name replaces that with a custom one. Sections surface in two places: the editor shows the section name next to the row, and the presenter view shows which section the current slide belongs to (and lets the speaker jump between sections).

So when the user asks to organize a deck into sections, group slides under topics, or label parts of a deck, setting name on the SLIDE_ROW is the move. Although SLIDE_ROW is otherwise opaque (no fills, effects, or layout), name is settable.

// Rename the second section in the deck
const grid = figma.currentPage.children[0];  // SLIDE_GRID
const row = grid.children[1];                // SLIDE_ROW
row.name = "Demo";

Cloning slides

const original = figma.getNodeById("SLIDE_ID");
const copy = original.clone();

Cloned slides are appended to the current page by default. Use setSlideGrid to position them in the grid.

Important: SlideGridNode.clone() throws at runtime — you cannot copy the slide grid itself.

Deleting slides

const slide = figma.getNodeById("SLIDE_ID");
slide.remove();

Removing a slide automatically updates the grid. If you remove all slides in a row, the row remains but is empty.

Reordering slides

Use getSlideGrid / setSlideGrid to rearrange slides. See slide-grid.md for details.