Actions43
- Comment Actions
- Component and Style Actions
- Dev Resource Actions
- Figma File Actions
- Library Analytic Actions
- Project Actions
- User Actions
- Variable Actions
- Version History Actions
- Webhook V2 Actions
Library Analytic → List Variables Usages
AI-generatedSummary
List usages of variables within a Figma library file by querying the Figma API's library analytics for variables.
Inputs
- Library File Key (required) — The key of the Figma library file for which to retrieve variable usages.
- Query Parameters — Optional parameters to customize the results, such as pagination cursor, time ranges, ordering, limit of results, and filtering options.
Output shape
a JSON object or array containing data about variable usages in the specified library file, as returned by the Figma API's analytics endpoint
The output includes usage data that may be paginated. Use the 'cursor' query parameter to retrieve subsequent pages if needed. If no usages are found, the response may be empty or have a 204 status code. Errors will be reported as node API errors.
Examples
Example 1: Retrieve the first 50 variable usages from a specific library file
Set 'Library File Key' to the target library's file key. Optionally set 'Query Parameters' such as 'limit' (default 50) and 'order' (default ascending). Call the node to get variable usage details for workflow analysis or reporting.