find_variable_usages
Discover where a Figma variable is bound across pages or under a node, returning nodeId/field usages, aliases, and styles; resume time-limited partial results with nextCursor.
Instructions
Find where a variable is bound: [{nodeId, field}] on all pages, or under rootId. Fields look like paddingTop, fills[0], strokes[0], effects[0].color. The first call also lists variableAliases (variables whose value aliases it) and styles (local styles bound to it). Instance children are skipped (their bindings belong to the main component) unless includeInstanceChildren. All pages are loaded as the search goes: PARTIAL with nextCursor when the time budget or maxResults is reached.
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": {
"variableId": "<variableId>"
},
"name": "find_variable_usages"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cursor | No | nextCursor of a previous PARTIAL answer, to continue where it stopped | |
| rootId | No | Limit the search to this node (default: every page) | |
| maxResults | No | Usages per call (default 2000) | |
| variableId | Yes | ||
| timeBudgetMs | No | Time budget of the plugin for this call in ms (default 60000, max 100000). When it is reached the answer says it is PARTIAL and gives nextCursor. | |
| includeInstanceChildren | No |