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

# Templates

> Certificates, quote cards, product cards and link previews with named blanks, filled the same way every time by the Fill a template step.

A template is a still with named blanks: a certificate with a name, a quote card with a quote and a face, a link preview with a title. The **Fill a template** step fills the blanks with your words and pictures and renders the same layout every time. Fill it from a spreadsheet and you get one file per row.

## Your workspace's templates

Templates belong to the [workspace](https://docs.mediamonster.app/account/team.md), like its brands. Open them from **Templates** on the desktop rail, at [mediamonster.app/templates](https://mediamonster.app/templates). The page shows your workspace's templates, then the built-in ones.

A built-in template can't be changed. Open one, change what you like, and **Save a copy** keeps your version in the workspace. **New template** starts from a blank canvas. Every save of a template's layout is kept as a numbered version. If someone else saved the same template after you opened it, your save is refused rather than written over theirs: reload to see their changes.

| Role | Templates |
| - | - |
| Owner, admin, member | See, edit, duplicate, rename and delete them |
| Viewer | See them and try their fields |
| Guest | Doesn't see them |

### The editor

A template opens in the editor at `/templates/<id>`. The canvas is drawn by the same layout code and the same font files the render uses, so what you see is what a run makes. Editing needs a desktop-sized window; on a phone the page shows the preview and its fields to try.

* **Layers** lists them top first. Drag a row to restack it, double-click its name to rename the field it fills. The eye and the lock only affect the editor: a hidden layer still renders.
* **Canvas**: click a layer to pick it, drag to move, drag a handle to resize. Boxes snap to the canvas's edges and centre and to other layers; hold Alt to skip snapping and Shift on a corner to keep the shape. Arrow keys nudge 1px (Shift for 10px). Delete removes the layer, ⌘D duplicates it, ⌘] and ⌘\[ restack it, ⌘Z and ⇧⌘Z undo and redo, ⌘S saves.
* **Layer** holds everything the layer can do: its field name and label, whether it hides when empty, font, weight, size range, colour, alignment and outline for words, the accent style for starred words, fit, crop and shape for pictures, how it moves at other sizes, what it follows, and which of the brand's colour, font or logo it takes.
* **Template** holds the canvas size, the format, the other sizes it's laid out for, and fonts of its own.
* **Fields** fills the template with sample values to see how it copes with a long name or another photo. Samples aren't saved.
* **Try sizes**, under the canvas, draws the template at every size it's laid out for and every size the step can ask for, side by side.
* **Use on the workbench** puts a Fill a template step with this template on the workbench.

The assistant can work in the editor too. Ask it to add a layer, move or restyle one, or take one off, and the change lands on the canvas as one step you can undo. It doesn't save: you press **Save** when you're happy. It can also list your templates and put a **Fill a template** step on the workbench with the words for its fields.

The editor has no face finder, so a picture cropped round faces shows the subject crop in the editor. The render finds the faces.

### From a picture

**Upload a picture** under **Make one from a picture** on the Templates page takes a mock-up (PNG, JPEG or WebP) and reads it into layers: its words as text layers with the closest font the render has, its photos and logos as picture fields, and its blocks, badges and lines as shapes. Words that change each time (a headline, a name, a price) come back as named fields; labels that never change come back fixed.

It opens in the editor as a template that isn't saved yet, with your picture laid faintly over the top so you can check the layers against it. The picture is locked so clicks reach the layers under it. It isn't saved with the template, but you can delete it once you're done. Reading takes about 20 seconds and costs 10 credits. If nothing usable comes back, the credits are refunded.

Treat what comes back as a first draft. Type sizes, weights and boxes are close, not exact, and pictures come back as empty boxes for you to fill.

### Fonts of its own

A template can carry up to 8 font files the render doesn't have: a TTF, OTF, WOFF or WOFF2 in your Vault, or a public `https://` link to one. Upload a font to the Vault as you would any file; it shows there with a type glyph instead of a picture. Give each a family name, then pick it in a text layer's **Font**. The run hands the file to the canvas for that render only.

### Built-in templates

| Template | Id | Size |
| - | - | - |
| Quote card | `quote-card` | 1080 × 1080 |
| Product card | `product-card` | 1080 × 1080 |
| Property listing | `listing` | 1080 × 1350 |
| Link preview | `og-card` | 1200 × 630 |
| Podcast episode | `podcast-episode` | 1080 × 1080 |
| Event poster | `event` | 1080 × 1350 |
| Sale banner | `sale-banner` | 1080 × 1080 |
| Certificate | `certificate` | 2000 × 1414 |
| Testimonial | `testimonial` | 1080 × 1080 |
| Name badge | `name-badge` | 1050 × 1500 |
| Story announcement | `story-announcement` | 1080 × 1920 |
| We're hiring | `hiring` | 1080 × 1080 |
| Award certificate | `certificate-award` | 2000 × 1414 |
| Invoice | `invoice` | 1654 × 2339 (A4) |
| Invoice with a band | `invoice-band` | 1654 × 2339 (A4) |
| Invitation | `invitation` | 1500 × 2100 (5 × 7 in) |
| Party invitation | `party-invite` | 1500 × 2100 (5 × 7 in) |
| Speaker badge | `speaker-badge` | 1050 × 1500 |

The invoices have 8 line-item rows (`item_1` to `item_8`, `amount_1` to `amount_8`). Only the first has sample words, so an empty row drops out rather than printing a sample item.

Some of these also have a free page on the site that fills them in the browser, with no account: [certificates](https://mediamonster.app/make/certificate), [invoices](https://mediamonster.app/make/invoice), [invitations](https://mediamonster.app/make/invitation), [quote cards](https://mediamonster.app/make/quote-card) and [event badges](https://mediamonster.app/make/event-badge).

## Fields

Each named layer of a template is a **field**. Pick a template on the step and a box appears for each one. Leave a box empty to keep the template's own words.

| Kind | What it takes |
| - | - |
| Words | Text. It's measured, wrapped and shrunk to fit its box, and cut with an ellipsis if it still can't fit at the smallest size. |
| Picture | A JPEG, PNG, WebP or GIF: one picked off the workbench, one uploaded on the step, or a link starting `https://`. The step above hands its picture to the template's first picture field. |
| QR code | The link or text the code holds. |
| Stars | A number from 0 to 5. Halves are drawn as half a star. |
| Colour | A colour written `#RRGGBB`. |

Some fields are optional: left empty, the layer is left out and the rest of the layout stays where it is.

### Words in the accent style

A template can give a text layer a second style, usually another colour. Put stars round the words you want in it: `The best time was *before* the upload`. The stars aren't printed. In a text layer with no accent style, stars are printed as they are.

## Fill a template

Add **Fill a template** to the Workbench, pick a template and type into its fields.

| Setting | What it does |
| - | - |
| **Template** | Which template to fill: one of your workspace's, or a built-in |
| **Size** | The template's own size, or square, portrait 4:5, story 9:16, landscape 16:9 or a 1200 × 630 link preview. Each layer moves by its own rule, so a headline stays centred, a logo stays in its corner and a photo grows into the extra room. A template can also carry a second arrangement for a very different shape — a link preview's picture moves above its title in a story. |
| **Format** | PNG, JPEG, WebP or PDF. A PDF is one page the size of the picture. |

It costs 1 credit per file.

The file is named after the first words you filled in, so a batch of certificates comes back as one file per name.

### A picture from the step above

Put a step that makes a picture above **Fill a template** and that picture fills the template's first picture field. For example, **Remove background** then **Fill a template** with the product card drops the cut-out on the card.

### Hundreds from a spreadsheet

Write `{{column}}` in a field, drop a spreadsheet on the Workbench and run it as a [batch](https://docs.mediamonster.app/batches.md). Each row fills the template once. A column spelled differently from the field is refused rather than skipped, so a typo doesn't print the template's sample words on every file.

A picture field's column can hold a link, or the name of a picture dropped on the Workbench with the spreadsheet. Names are matched the way a batch matches its files.

### Your brand

Pick a brand on the step and the layers that are set up for it take the brand's primary colour, its heading font and its logo. A font file uploaded to the [brand kit](https://docs.mediamonster.app/brand-kit.md) is used when the renderer doesn't have the family already.

## From the API

List your templates and their fields:

```bash theme={"theme":{"light":"github-dark","dark":"github-dark"}}
curl https://mediamonster.app/api/v1/templates \
  -H "Authorization: Bearer $MEDIAMONSTER_KEY"
```

`GET /api/v1/templates/{id}` returns one template with its fields, the sizes it's laid out for, its layers, and a request that fills it. Fill one with `POST /api/v1/runs`, the template's fields as options:

```json theme={"theme":{"light":"github-dark","dark":"github-dark"}}
{
  "steps": [
    {
      "tool": "fill-template",
      "options": {
        "template": "certificate",
        "name": "Priya Shah",
        "reason": "has completed Editing for Podcasters",
        "date": "29 September 2026",
        "format": "pdf"
      }
    }
  ]
}
```

A field the template doesn't have fails the run with the list of fields it does have. Templates are made and changed in the app, not over the API.

Over [MCP](https://docs.mediamonster.app/mcp.md#fill-a-template), `list_templates` and `describe_template` answer the same questions, and `run_skill` with `fill-template` fills one.

## A link that draws the template

**Get a link** on a template makes an **instant link**: a URL that draws the template from its query string, with no API call. It's made for the picture a page shows when it's shared (`og:image`). The first request for a set of words costs 1 credit, and every request after it is free. See [Open Graph images for your site](https://docs.mediamonster.app/integrations/open-graph-images.md).


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