What's the Canvas Size?

Default is 1280×720 pixels (16:9). Other options: 1024×768 (4:3) and 1080×1080 (1:1). All element positions and dimensions are in pixels from the top-left corner.

The canvas size defines the coordinate space for your slides. Every element's position (x, y) and dimensions (width, height) are measured in pixels within this space. The canvas size is set when the deck is created and cannot be changed afterward.

Available Canvas Sizes

If no aspect ratio is specified when creating a deck, it defaults to 16:9 (1280×720).

Coordinate System

• Origin: top-left corner of the slide at (0, 0)
• X axis: increases to the right (0 → canvas width)
• Y axis: increases downward (0 → canvas height)
• Units: all values are in pixels — no percentages, inches, or EMUs

Setting the Aspect Ratio

The aspect ratio (and therefore canvas size) is set when you create a deck. Pass the aspectRatio parameter to slides_create_deck or slides_bulk_create:

slides_create_deck({
  name: "My Presentation",
  aspectRatio: "16:9"    // or "4:3" or "1:1"
})

// Response:
// {
//   deckId: "deck_abc123",
//   canvas: { width: 1280, height: 720 },
//   ...
// }

Once a deck is created, the canvas size is fixed — it cannot be changed. If you need a different aspect ratio, create a new deck.

Confirming the Canvas Size

Always call slides_get_deck before placing elements. The response includes the canvas dimensions:

slides_get_deck({ deckId: "deck_abc123" })

// Response includes canvas dimensions:
// {
//   canvas: { width: 1280, height: 720 },
//   aspectRatio: "16:9",
//   slides: [...],
//   ...
// }

This is especially important for imported template decks, which may have non-standard canvas sizes (see below).

Font Sizes vs. Element Positions

Two different unit systems are used:

• Element positions and sizes (x, y, width, height) — pixels
• Font sizes (fontSize) — points (e.g., 12pt for body, 24pt for headings, 36pt+ for titles)

Example

// Place a title near the top-left with 60px margins
slides_create_element({
  slideId: "slide_xyz",
  type: "text",
  role: "title",
  text: "Quarterly Review",
  x: 60,        // 60px from left edge
  y: 60,        // 60px from top edge
  width: 600,   // 600px wide
  height: 80,   // 80px tall
  fontSize: 44  // 44 points (not pixels)
})

Imported Template Canvas Sizes

When you import a brand template (.potx, .potm, or .pptx), the deck preserves the original file's canvas dimensions. These may not match the standard sizes — for example, a PowerPoint template might use 960×540 or 1920×1080.

• Imported dimensions are stored separately and take priority over the standard aspect ratio sizes
• Built-in layouts automatically scale to fit the imported canvas dimensions
• Font sizes are scaled proportionally so text looks correct at the imported size
• Always call slides_get_deck to confirm the actual canvas size before positioning elements

Common Issues

• Elements appearing off-screen or clipped: Check that your x + width ≤ canvas width and y + height ≤ canvas height. Call slides_get_deck to confirm the actual dimensions.
• Assumed 1280×720 but deck is a different size: Imported template decks can have non-standard canvas sizes. Never hardcode dimensions — always read them from slides_get_deck.
• Text looks too large or too small: Font sizes are in points, not pixels. A 44pt title will render correctly regardless of canvas size.
• Want to change the aspect ratio: Canvas size is fixed at deck creation. Create a new deck with the desired aspect ratio and recreate your slides.

Related

• Layouts — Built-in and template layouts that adapt to the canvas size
• Styling — Colors, fonts, sizes, and visual design techniques
• Slide Rules & Element Roles — Recommended font sizes and semantic roles for elements
• Agent Workflow — The 7-step workflow starting with slides_get_deck