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

# Presets

A preset says where the diagram will be used, not what kind of diagram it is. It changes how the agent composes it (shape, words, emphasis, pages) and which download comes first; the prompt's own words override it. It costs nothing extra: credits are per page as always. The diagram keeps its preset, so every change to it is made for the same destination, until a change names another (`preset` on revisions, or null for none). Leave it out for a general diagram, exactly as before.

| Preset | Made for | Animates | Pages | First download |
| - | - | - | - | - |
| `docs` | Documentation: accurate and neutral, no headline or call to action | no | one | `image.png` |
| `blog` | A figure in an article: one point, landscape about 2:1 | no | one | `image.png?quality=high` |
| `social` | A LinkedIn or X post: one idea readable at phone width, 4:5 or square, no call to action | no | one | `image.png?quality=high`; recordings `size=portrait` |
| `carousel` | A LinkedIn or Instagram carousel: a cover with a hook and a swipe cue, one idea per numbered page (`n / N`), an end card; 4:5, 6 to 12 pages unless the prompt asks for more. The prompt's own sentences stay on the pages word for word, and a page gets a figure only where it shows structure | no | many | `image.pdf?pages=all` |
| `ad` | Paid social: a short line, the product largest, brand bottom left and call to action bottom right, a 1:1 master | yes | one | `animation.mp4?size=square` |
| `data_story` | One chart from real data whose title is the finding, with a small source line | no | one | `image.png?quality=high` |
| `explainer_video` | An animated explainer composed for 16:9 | yes | one | `animation.mp4?size=landscape` |

![The frames diagramkit lays a diagram out for and the presets that use them: landscape 1920 by 1080 (16:9) for data\_story and explainer\_video, wide 1920 by 960 (2:1) for blog, square 1080 by 1080 (1:1) for ad, portrait 1080 by 1350 (4:5) for social and carousel, story 1080 by 1920 (9:16) with no default preset, for Shorts, Reels and TikTok. docs and no preset keep the diagram's own shape, 900 px wide on desktop and 390 px on phone.](https://mintcdn.com/diagramkit/sWlxT_qLaDK7vTGW/images/frames.png?fit=max\&auto=format\&n=sWlxT_qLaDK7vTGW\&q=85\&s=9a4de383a8827fdf55668fe3cb4da332)

Each preset lays the diagram out for a frame; the diagram is laid out again for that shape, never cropped. docs keeps its own shape, with desktop and phone layouts.

A job with a preset carries `recommended_download`, the download its preset offers first, and `animation.*` without `size` uses the preset's frame.

```bash theme={null}
curl https://app.diagramkit.ai/api/v1/diagrams \
  -H "Authorization: Bearer $DIAGRAMKIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "How SSH sets up an encrypted session", "preset": "social", "wait": 180}'
```


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