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

> ## Agent Instructions
> Keep the API key in an env var (RENDOBAR_API_KEY), never in chat or committed code.
> Job types change, so fetch the live catalog from GET https://api.rendobar.com/jobs/types rather than relying on memory.
> The full integration prompt for coding agents is at https://rendobar.com/prompts/integrate.md.

# Fonts and languages

> Use your own font files, set fallback stacks, and render scripts that need shaping such as Arabic and Devanagari.

Name any [Google Fonts](https://fonts.google.com) family in `style.font` and it
loads at render time, with no upload or setup.

```json theme={null}
"style": { "font": "Bebas Neue", "size": 96, "weight": 700 }
```

Seven families ship in the render image and need no fetch:
`Inter`, `Roboto`, `Montserrat`, `Poppins`, `Oswald`, `Anton`,
`Bebas Neue`.

<video src="https://cdn.rendobar.com/compose/showcase/fonts/after.mp4" poster="https://cdn.rendobar.com/compose/showcase/fonts/after.jpg" autoPlay loop muted playsInline controls />

a display family for the headline, Arabic and Devanagari through the bundled fallbacks

## Your own font files

List the file URLs in the job's `fonts` input, each under a family name you
choose. Then use that name in `style.font`.

```json theme={null}
{
  "type": "compose",
  "inputs": {
    "fonts": [
      { "family": "Display", "src": "https://cdn.example.com/BrandDisplay.woff2" },
      { "family": "Body", "src": "https://cdn.example.com/BrandText.otf" }
    ]
  },
  "params": {
    "schemaVersion": 1,
    "timeline": {
      "tracks": [
        { "clips": [{ "asset": { "type": "text", "text": "LAUNCH", "style": { "font": "Display", "size": 140 } }, "start": 0, "length": 3 }] },
        { "clips": [{ "asset": { "type": "text", "text": "in stores now", "style": { "font": "Body", "size": 54 } }, "start": 0, "length": 3 }] }
      ]
    },
    "output": { "format": "mp4", "size": "1080p" }
  }
}
```

You can declare any number. TTF, OTF, TTC, WOFF and WOFF2 all work, and `src`
takes an [uploaded asset's](https://rendobar.com/docs/docs/sdk#uploads) content URL like any other URL.

Choosing a name means you never need the family name stored inside the file,
which often differs from the file name and takes a font inspector to find. Omit
`family` and the engine reads the stored name, so `{ "src": "..." }` alone is
valid.

A family you declare overrides a bundled one with the same name, as an
`@font-face` rule overrides a system font in CSS.

For a single file, use the `inputs.font` shorthand and refer to it as `custom`:

```json theme={null}
"inputs": { "font": "https://cdn.example.com/BrandDisplay.ttf" },
"style": { "font": "custom", "size": 96 }
```

## Fallback stacks

`style.font` takes a CSS-style list and tries each entry in order:

```json theme={null}
"style": { "font": "Display, Bebas Neue, sans-serif" }
```

If your CDN is down or a Google family cannot be fetched, the render uses the
next entry. The job does not fail or fall back to a random system font, and it
reports every substitution:

```json theme={null}
"steps": [
  {
    "id": "execute-engine",
    "meta": {
      "fontFallbacks": [
        "font \"Display\" is not available; trying the next entry in \"Display, Bebas Neue\""
      ]
    }
  }
]
```

If `style.font` names no font that can be found, the API rejects the job at
submit. This catches a font URL pasted into `style.font` instead of `fonts`.

## Weights and languages

`weight` runs from 100 to 1000. A variable font uses the exact value. A static
family uses its nearest available weight, rounding up on a tie.

Latin, Cyrillic, Greek, Vietnamese, Turkish, Arabic, Hebrew, Thai, Devanagari,
Bengali, Tamil, Amharic, Khmer, Chinese, Japanese and Korean all render. The
engine handles right-to-left joining and conjunct shaping. Colour emoji does not
render in text assets.


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