Templates

Scriban templating syntax — variables, conditions, and functions you can use in character and scenario fields.

Most dynamic fields in Voxta — character descriptions, scenario text, prompts, bootstrap messages — accept Scriban templates. Scriban is a fast, sandboxed templating language that supports variable interpolation, conditionals, loops, and function calls.

For the full language reference, see the official Scriban docs. This page documents the Voxta-specific variables and functions you can use in templates.

A worked example

{{ user }} and {{ char }} finally arrive to the designated location.
{{~ if has_flag "night" ~}}
It was dark, they had no idea where the box was.
{{~ else ~}}
It was day, they could clearly see the box.
{{~ end ~}}

If the chat has the night flag set, that template renders one way; if not, the other.

Not all fields support every variable. Character fields can use character variables but not scenario-level ones. Scenario fields see everything. When in doubt, try it — Voxta will tell you in the prompt preview if a variable resolved to nothing.

Available variables

About the user

Variable	Type	Description
`user`	`text`	The user's name.
`user_description`	`text`	The user's profile description.

About the main character

Variable	Type	Description
`char`	`text`	The main character's name.
`char_description`	`text`	The main character's appearance.
`char_personality`	`text`	The main character's personality.
`char_profile`	`text`	The main character's full profile.
`character`	`Character`	The main character object. Has `id`, `name`, `tags`, `description`, `personality`, `profile`.

About all characters

Variable	Type	Description
`chars`	`string[]`	All character names.
`characters`	`Character[]`	All character objects.
`other_chars`	`string[]`	All character names except the main one.
`other_characters`	`Character[]`	All character objects except the main one.

About the scenario

Variable	Type	Description
`scenario`	`string`	The scenario's text.
`scenario_chars`	`{ [role: string]: string }`	Character names indexed by role: `scenario_chars.main`.
`scenario_characters`	`{ [role: string]: Character }`	Character objects by role: `scenario_characters.main.id`.
`chat_flow`	`string`	`Story` or `Chat`.
`chat_style`	`string`	`Companion`, `Storytelling`, `Roleplay`, `Assistant`.
`explicit`	`boolean`	True if the scenario or any character is marked explicit.
`now`	`text`	Current date/time formatted for the character's culture. Only set if the character is time-aware and the scenario isn't roleplay.

Context and history

Variable	Type	Description
`context`	`string[]`	All resolved contexts for this turn.
`last_function_call`	`ActionInvocation`	The last action invoked. Has `name`, `signature`, `short`, `timestamp` (relative).

Scripting

Variable	Type	Description
`variables.variable_name`	any	A chat variable set from a script.

Functions

Function	Returns	Description
`has_flag "flag_name"`	`boolean`	Whether the chat has that flag.
`char_has_tag "tag_name"`	`boolean`	Whether the main character has that tag.

Common patterns

Conditional description

{{ char }} is a tall woman in her late twenties.
{{~ if has_flag "is_drenched" ~}}
She is completely soaked from the rain.
{{~ end ~}}

Tag-based branching

{{~ if char_has_tag "detective" ~}}
{{ char }} carries a worn notebook and a magnifying glass.
{{~ end ~}}

Multi-character introduction

Tonight, {{ char }} is meeting {{ scenario_chars.guest }} for the first time.

Time-aware greeting

{{~ if now ~}}
It is {{ now }}.
{{~ end ~}}