add_variable_mode
Add a mode (such as Dark) to a Figma variable collection. Returns the new mode's ID and name, and provides fallback guidance when the file's plan blocks adding more modes.
Instructions
Add a mode (e.g. "Dark") to a variable collection. Returns { ok, modeId, name }. Mode count is gated by the file's Figma plan (Starter allows 1 per collection) — when the plan blocks a new mode this fails with guidance: fall back to a paired collection (e.g. "Color/Dark") holding the same variable names with that theme's values.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"collectionId": "<collectionId>",
"name": "<name>"
},
"name": "add_variable_mode"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Mode name, e.g. "Dark" | |
| collectionId | Yes | Variable collection id |