Guide

How to use AutoVariant

See the full AutoVariant workflow from selecting a frame through to generating finished outputs in Figma.

AutoVariant walkthrough preview
Before you generate

Match your CSV to Figma exactly

The video shows the full workflow. This is the quick preflight check to help avoid the most common setup issues.

01

Figma layer names = CSV headers

Use the exact Figma layer name as the matching column header in your CSV.

Figma layer
Player Name
CSV header
Player Name

Matching names can be detected automatically, which makes mapping faster and less error-prone.

02

Figma variant values = CSV values

If a CSV field controls a component or variant, the value must match the option in Figma exactly.

Figma variant
Team=Arsenal
CSV value
Team=Arsenal

Capitalisation, spacing and the property/value format need to match what exists in the component set.

Troubleshooting

Something not working?

Most issues come down to selection, naming or mapping.

Make sure the master frame is selected on the Figma canvas before generating with AutoVariant.
Check that the CSV header and Figma layer name match exactly. You can also map the field manually inside AutoVariant.
Duplicate layer names inside the same design can make mapping ambiguous. Rename the variable layers so each target is clear and unique.
Confirm the correct CSV column is mapped to the intended Figma layer and that the CSV cell contains valid data.
Check that the CSV value matches the component property and variant value in Figma exactly, including capitalisation and spacing. For example: Team=Arsenal.
Review the naming structure before generating and make sure the selected CSV fields and separators match the output format you want.
Need help?

Still having trouble?

If you can't find the answer above, get in touch and we'll help.

support@autovariant.app

We aim to reply within 48 hours, Monday to Friday.

Ready to generate your first batch?

Install AutoVariant and generate your first 5 outputs free.

Install free in Figma