Trello Variables: How to Use Custom Fields, Power-Up Data, and Butler Variables

What Are Trello Variables

Trello variables are placeholders and tokens that represent dynamic data inside cards, automation rules, and Power-Ups. They let you pull values like due dates, assignees, or custom field entries into descriptions, comments, and automated actions without manually editing each card. Using variables reduces repetitive work and keeps boards consistent, especially when teams manage many cards with similar structures.

Using Custom Fields as Variables

Custom Fields is a native Trello feature that turns card details into structured, reusable variables. You can add fields such as Priority, Estimate, or Status and reference them in card views, filters, and templates. When a custom field value changes on a card, any linked templates or automation rules that pull that field update automatically, keeping downstream work aligned.

To reference a custom field in card descriptions or comments, you use the custom field token syntax provided by the interface. Trello renders the current value at the time of insertion, so teams see live data without copy-pasting. This approach works best for standardized workflows where every card follows the same field schema.

Butler Automation Variables and Tokens

Butler, Trello's built-in automation engine, provides its own set of variables that you can use in rules and commands. These tokens capture card properties, board context, and timestamps at the moment an action runs. Common Butler variables include {{card.name}}, {{memberAssigned}}, {{dateNow}}, and {{board.name}}. You can insert them into task descriptions, due dates, labels, or checklist items.

Butler also supports relative date variables and formula-like expressions, which let you calculate deadlines based on the current date or a card's existing due date. For example, you can create a rule that sets a follow-up date three days after a card moves to a specific list. The variable resolves each time the rule fires, so every card gets a unique, context-aware date.

Power-Up and Integration Variables

Many Trello Power-Ups introduce their own variable systems for pulling external data into cards. For example, the Calendar Power-Up uses date variables to sync card due dates with calendar events, while the GitHub Power-Up can embed issue numbers and commit references. These variables often appear as card attachments, custom fields, or description snippets that update when the external source changes.

When you connect a Power-Up that supports variables, Trello typically provides a picker or token guide so you can insert the right placeholder without memorizing syntax. Check the Power-Up documentation for supported tokens, because availability varies across integrations and sometimes depends on your workspace plan.

Practical Patterns for Trello Variables

Teams get the most from Trello variables when they standardize where and how variables are used. Common patterns include:

• Card templates: Pre-fill descriptions with variables for owner, priority, and status so every new card starts with consistent structure.
• Status updates: Use Butler to append a timestamped comment with {{dateNow}} and the member who moved the card.
• Handoff workflows: When a card moves between lists, automatically assign a reviewer and insert their name using a member variable.
• Reporting: Pull custom field values like story points or cost estimates into a single card or report list for quick aggregation.

Limitations and Things to Know

Trello variables are not a full scripting language. They resolve values at the moment a rule runs or a template is applied, so they do not create live formulas that continuously update after insertion. If a custom field value changes after a variable is embedded in a description, the description text does not automatically refresh. For real-time data, teams should rely on filtered views, custom field displays, or recurring automations rather than static placeholders.

Variable support also depends on your plan and installed Power-Ups. Some tokens are limited to Premium or Enterprise tiers, and certain Power-Ups may only expose variables to admins or board members with specific permissions. Test new variable setups on a single board before rolling them out across a workspace.