---
title: "Template videos"
description: "How Mosio templates work, how the brand kit fills them, and how text is checked."
---

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

# Template videos

A template is a finished design with slots for text and colours. You choose the template and write the text; Mosio renders it. Template videos are the quickest and most predictable way to make a video.

## Ids and versions

Every template id carries a version, such as `promo-produk@1`. A version never changes once published, so the same request always renders the same design. New designs ship as new templates or new versions.

The [template reference](/reference/templates) lists every template, its sizes, its length, and its variables.

## Variables

All variables are text. Colours are `#RRGGBB`. Each variable has a maximum length; longer text is refused rather than cut off, with the variable named in the error:

```json
{
  "error": "invalid_variables",
  "message": "Variabel template tidak valid.",
  "details": { "harga": ["Too big: expected string to have <=24 characters"] }
}
```

Shorter text reads better on a phone anyway. Prices read best as `Rp25.000`.

## The brand kit

Four variables are shared by every template: `nama_usaha` (business name), `warna_utama` (accent colour), `warna_latar` (background colour), and `kontak` (contact). When a request leaves them out, Mosio fills them from the workspace brand kit, set in the dashboard under **Brand**. Send them only to override the brand kit for one video.

## Sizes

Templates are laid out for vertical video: 1080×1920 (default) and 720×1280. Choose with `output.width` and `output.height`.

## In Claude

Claude calls `preview_video` with the template and text, plus up to three alternative designs. The card shows a moving preview where you can switch designs and colour palettes and edit the text before pressing **Buat video**.

Source: https://docs.mosio.me/guides/templates/index.mdx