> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trypekto.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Carousels

> LinkedIn and Instagram carousels of 3 to 30 slides, with a layout for every slide.

Send `format: "carousel"` to `POST /presentations` (or ask your AI tool for a carousel) and Pekto builds the whole thing:

1. **Picks a theme.** The one you name in `template_family`, or one Pekto chooses, which varies from request to request.
2. **Plans every slide.** It reads your source and decides what each slide is for, in order: a cover with the hook, then tips, steps, stats, quotes, comparisons and so on, then a recap and a closing call to action.
3. **Gives every slide a layout of the right type.** Each theme has layouts made for each kind of slide. Pekto rotates through them so neighbouring slides don't look the same, and reuses them on long carousels.
4. **Writes and fits the copy.** Text is written to fit each layout's space, slide numbers and counters (`03/08`) are filled for the final length, and the project is saved, ready to edit.

```json theme={null}
{
  "format": "carousel",
  "slide_count": 10,
  "template_family": "carousel32",
  "content": "<your post or article>",
  "audience": "B2B marketers",
  "objective": "Get saves and follows",
  "tone": "Confident, plain English"
}
```

## Length

* 3 to 30 slides; the default is 8.
* On LinkedIn a carousel is a PDF document post, which holds all 30. Instagram allows at most 20 images per post, so keep Instagram carousels to 20.
* Long carousels reuse a theme's layouts, never two identical slides in a row.

## Slide types

Pekto plans each slide as one of these types and only uses layouts made for that type:

| Type | Used for |
| - | - |
| `cover` | The hook and title |
| `problem` | The pain or the mistake |
| `tip` | One idea or tip per slide |
| `steps` | A numbered process |
| `stat` | One big number and what it means |
| `statement` | A single bold line |
| `quote` | A quote and who said it |
| `comparison` | Before and after, or this vs that |
| `myth_fact` | A myth and the truth |
| `checklist` | A list to tick off |
| `picture` | An image-led slide |
| `recap` | The short version |
| `closing` | Follow, save, comment or visit |

## Themes

Pass the id as `template_family`, or list them live with `GET /carousel-themes` (MCP: `list_carousel_themes`). Matching ignores case and spaces. An unknown id returns `400 invalid_template_family` with the valid ids, before any credits are used.

| Theme | `template_family` | Layouts |
| - | - | - |
| Acid Green | `carousel18` | 23 |
| Bold Dark | `carousel16` | 26 |
| Bold Modern | `carousel15` | 25 |
| Bold Red Giant Number | `carousel31` | 22 |
| Clean Sans | `carousel12` | 23 |
| Corporate Bold | `carousel20` | 23 |
| Creative Background | `carousel4` | 22 |
| Dark Editorial | `carousel6` | 24 |
| Doodle Paper | `carousel5` | 22 |
| Editorial Insight | `carousel1` | 24 |
| Elegant Mocktail | `carousel28` | 23 |
| Folder Style | `carousel17` | 23 |
| Forest Lime | `carousel19` | 23 |
| Green Circle Grid | `carousel35` | 25 |
| Grid Notebook | `carousel29` | 24 |
| Lifestyle Story | `carousel14` | 18 |
| Lime Sketch Serif | `carousel36` | 23 |
| Minimal Editorial | `carousel7` | 23 |
| Minimal Monospace | `carousel33` | 22 |
| Minimal Serif | `carousel32` | 24 |
| Modern Business | `carousels` | 24 |
| Modern Marketing | `carousel13` | 23 |
| Modern Serif | `carousel11` | 24 |
| Neon Highlight | `carousel9` | 24 |
| Playful Brand | `carousel8` | 23 |
| Purple Stacked Cards | `carousel30` | 25 |
| Sales Storytelling | `carousel21` | 22 |
| Social Modern | `carousel10` | 25 |
| Soft Editorial | `carousel22` | 23 |
| Step By Step | `carousel3` | 24 |
| Vibrant Tech Stack | `carousel34` | 18 |
| Yellow Organic Wave | `carousel37` | 23 |

## Images and branding

Picture slots keep the theme's sample photos, and name and handle fields use your account name. Swap in your own images, logo and colours in the editor, or apply a brand kit there.

## Exporting

Open `editor_url` and export as **PDF** for a LinkedIn document post, or **PNG** for Instagram. You can also schedule a LinkedIn post through the API; see [Scheduling posts](/guides/scheduling-posts).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.