Pages and carousels

A template can have up to 20 pages. Each page becomes one image, so a template with several pages makes a carousel. A PDF puts every page in one file. This page shows how to work with pages in the editor and how they turn into files.

The page strip

The page strip sits under the canvas. It shows a thumbnail of each page, and above the buttons it says which page you are on, for example “Page 2 of 5”, with the page’s name.

• Click a thumbnail to edit that page.
• Press PgUp or PgDn to go to the page before or after. This works when you are not typing in a field.
• Drag a thumbnail to move the page to another place.

The buttons next to the thumbnails act on the page on screen. Point at a button to see its name. Add page is the + tile after the last thumbnail.

Button	What it does
Add page	Adds a blank page right after the page on screen. The new page has the same size.
Move page left / Move page right	Moves the page one place to the left or right.
Rename page	Lets you type a new name, up to 80 characters. Press Enter to keep it or Esc to cancel. You can also double-click a thumbnail.
Duplicate page	Copies the page with all its layers and puts the copy right after it. The copy’s name ends in “copy”.
Delete page	Deletes the page and its layers, after you confirm. You can undo it with Ctrl+Z (Cmd+Z on a Mac).

Some limits:

• Add page and Duplicate page stop working at 20 pages.
• A template always has at least one page, so you can’t delete the last one.
• You can rename pages once there are two or more.

Page names are only there to help you. Renders and the API count pages by their place in the strip, starting at 1. So when you move a page, its number changes too.

Compact view

To give the canvas more room, click the small tab on top of the page strip. The strip becomes one row of page numbers instead of thumbnails. The buttons stay. Click the tab again to bring the thumbnails back. JamFrame remembers your choice in this browser.

Page sizes

Each page has its own size. When no layer is selected, the properties panel on the left shows the Canvas settings of the page on screen. A new Size there changes only that page, so one template can hold a square post and a story.

Make a carousel from New Design

1. In the sidebar, click Templates, then New Design.
2. Pick a size, for example an Instagram square post.
3. Choose Starter layout or Blank canvas.
4. Tick Carousel and type how many pages you want, from 2 to 10.
5. Click Create design.

The pages are named “Slide 1”, “Slide 2” and so on. Every slide has a title key that is ready to change. With Starter layout, every slide also has a photo and a subline key. You can add more pages later with Add page, up to 20 in all.

Because every slide has the same keys, a plain value changes every slide. Put pageN@ in front of a key to change one slide only:

{
  "page1@title": "5 ways to brew better coffee",
  "page2@title": "Use fresh beans",
  "page3@title": "Grind just before you brew",
  "photo": "https://example.com/images/beans.jpg"
}

Here each slide gets its own title, and every slide gets the same photo. To learn more about keys, see Choose what changes.

You can also turn any template into a carousel: add pages with Add page or Duplicate page.

How pages become files

The format you pick decides what you get:

Format	What you get
PNG, JPEG or WebP	One image for each page, in page order. This is a carousel.
PDF	One PDF file with every page in it.

Each image, and each page of a PDF, uses one render credit. A 5-slide carousel uses 5 credits, and so does a 5-page PDF. See Credits.

With the API, content in the answer is one link when the render makes one file. When it makes several images, content is a list of links, one for each page, in page order.

Render only some pages

You don’t have to render every page. Choose the pages like this:

Where	How
Test render	Type page numbers in Pages, for example 1, 3. Leave it empty for every page. The field shows when the template has two or more pages.
API	Send includePages in response, for example [1, 3].
Form	Under Pages in the form’s output settings, tick the pages you want.
Dynamic URL	An image link shows one page: page 1, or the page you set with _page, such as _page=2. A PDF link takes a list, such as _page=1,3.

For example, this API request renders only the first two slides:

{
  "templateId": "YOUR_TEMPLATE_ID",
  "modifications": {
    "page1@title": "5 ways to brew better coffee",
    "page2@title": "Use fresh beans"
  },
  "response": { "format": "png", "includePages": [1, 2] }
}

A render makes at most 20 template pages. With several sizes, it makes at most 30 pages in all, counting each page at each size. A page number the template doesn’t have is an error. A pageN@ key for a page you don’t render is skipped.

Related

• Give each page its own values: Choose what changes.
• Try the pages with real values: Test render.
• Every page in other sizes, such as a story: Smart Resize.