kawaiicandy.ai
Guides/Character creation/Variables reference
Documentation

Variables reference

Complete reference for {{template}} variables used in character fields and per-chat settings. Tokens are substituted at chat send time.

Last updated: June 21, 2026

All tokens

Every placeholder below is defined in the platform registry. Substitution runs at chat send time using the active persona and character fields.

TokenGroupRuntime sourceDescription
{{char}}systemCharacter nameCharacter display name
{{user}}systemActive persona nameActive persona display name
{{user_first_name}}systemFirst word of persona nameFirst word of the persona display name
{{char_name}}characterCharacter nameCharacter display name (alias of char)
{{char_description}}characterCharacter descriptionCharacter description field
{{char_personality}}characterCharacter system promptCharacter personality / system prompt field
{{char_rules}}characterCharacter behavior rulesCharacter behavior rules field
{{persona_name}}personaActive persona nameActive persona display name (alias of user)
{{persona_appearance}}personaPersona appearancePersona appearance field
{{persona_personality}}personaPersona personalityPersona personality field
{{persona_background}}personaPersona backgroundPersona background field
{{persona_speaking_style}}personaPersona speaking stylePersona speaking style field
{{persona_pronouns}}personaPersona pronounsPersona pronouns field

Character form fields

Which tokens you can insert in each character creation field (auto-exposed as chips in the form).

Description

{{char}}{{user}}{{user_first_name}}{{char_name}}{{char_description}}{{char_personality}}{{char_rules}}{{persona_name}}{{persona_appearance}}{{persona_personality}}{{persona_background}}{{persona_speaking_style}}{{persona_pronouns}}

System prompt

{{char}}{{user}}{{user_first_name}}{{char_name}}{{char_description}}{{char_personality}}{{char_rules}}{{persona_name}}{{persona_appearance}}{{persona_personality}}{{persona_background}}{{persona_speaking_style}}{{persona_pronouns}}

Behavior rules

{{char}}{{user}}{{user_first_name}}{{char_name}}{{char_description}}{{char_personality}}{{char_rules}}{{persona_name}}{{persona_appearance}}{{persona_personality}}{{persona_background}}{{persona_speaking_style}}{{persona_pronouns}}

Example dialogues

{{char}}{{user}}{{user_first_name}}{{char_name}}{{char_description}}{{char_personality}}{{char_rules}}{{persona_name}}{{persona_appearance}}{{persona_personality}}{{persona_background}}{{persona_speaking_style}}{{persona_pronouns}}

Opening messages

{{char}}{{user}}{{user_first_name}}{{char_name}}{{char_description}}{{char_personality}}{{char_rules}}{{persona_name}}{{persona_appearance}}{{persona_personality}}{{persona_background}}{{persona_speaking_style}}{{persona_pronouns}}

Per-chat settings

These fields are configured per conversation in chat settings. They support the same tokens as character fields.

  • Conversation memory (per chat)
  • Custom instructions (per chat)

By group

System

  • {{char}}Character display name
  • {{user}}Active persona display name
  • {{user_first_name}}First word of the persona display name

Character

  • {{char_name}}Character display name (alias of char)
  • {{char_description}}Character description field
  • {{char_personality}}Character personality / system prompt field
  • {{char_rules}}Character behavior rules field

Persona

  • {{persona_name}}Active persona display name (alias of user)
  • {{persona_appearance}}Persona appearance field
  • {{persona_personality}}Persona personality field
  • {{persona_background}}Persona background field
  • {{persona_speaking_style}}Persona speaking style field
  • {{persona_pronouns}}Persona pronouns field

Runtime behavior

  • Live chat requires an active persona; tokens like {{user}} use that persona's name.
  • Opening message previews use a fallback: {{user}}becomes "You" when no persona is selected.
  • Unknown {{tokens}} are left unchanged in the text.
  • Empty optional persona fields substitute as an empty string.

Examples

Opening message

Assistant: *looks up* Oh—hello, {{user}}. I wasn't expecting company.

Behavior rule

Always address {{user}} by name. Use {{persona_pronouns}} when referring to them.

Opening messages guide · Example dialogues guide