Skip to content

Variables

This page explains what the Variables page shows and how it works in XTM One.

Unlike most other resources, variables do not use a list page plus detail page pattern. They use one management page with create and edit dialogs.

The management page

In the left navigation, this area is Variables. The page is a board of reusable values that resolve at runtime in personas, prompts, skills, and tools. You can search by name, description, or value pattern and filter by tags, then create, edit, copy, or delete a variable. If you have permission, New Variable adds one.

Each variable is a card, not a table row. The card shows enough to decide quickly whether it is the right variable, whether it is sensitive, and whether it still looks current. Non-secret variables show their value preview directly; secret variables mask it behind a lock icon and a Secret badge, with a reveal toggle on the card itself. Each card also has a copy action for the variable reference.

Editing behavior

Clicking a card opens an edit dialog — there is no separate detail page or tabs. The create and edit dialogs share the same fields; the key decision is whether to mark the variable Secret, which changes how it is displayed and handled later.

For a secret variable, the value field does not reveal the stored value on edit. The placeholder tells you to enter a new value only when you want to update it, which reinforces that secret handling differs from plain text.

Copying a reference

The UI lets you copy the reference format directly instead of typing it. The copied format uses the variable ID (for example {{var_id.<id>}}) and can be reused in personas, prompts, skills, and tools.

Good habits

  • Use Secret for credentials or sensitive values.
  • Copy the reference instead of typing it from memory.
  • Add clear descriptions so other users know where the variable should be used.
  • Use tags when the same workspace contains many operational variables.