Naming your layers in Figma to match the spreadsheet

In Figma, you'll rename your text layers to be the same as the header names that you already setup in your spreadsheet.

As an example, if you named your spreadsheet headers #Title or #Description, then you would then name your text layers #Title or #Description as well; this will ensure that they are mapped together when the spreadsheet is synced up in the plugin later.

Assigning specific rows to Figma layers ​

To sync a specific spreadsheet row with a parent Frame layer, append a period (.) followed by the target row number to the layer name. For example; renaming a parent frame layer from #My Frame to #My Frame.3 instructs the sync process to use data from the 3rd row of your spreadsheet when you select that frame layer and provide the spreadsheet. By default, syncing a single frame or layer uses the first row.

You can also override the row used for individual child text layers within the parent frame by applying the same naming convention. For example; changing a nested text layer from #Heading to #Heading.5 ensures that this layer pulls data from the 5th row of the spreadsheet, even if the parent frame is set to #My Frame.3 (which uses the 3rd row for other synced data).

This optional naming convention allows precise control over which spreadsheet row populates each layer during the sync process.

Assigning random rows to Figma layers. If you would like a Figma layer to sync with a random row's value, you can add an .x to the end of your Figma layer name, directly after the header name. For example, #Title.x will always fetch a random row from the #Title column of your spreadsheet.

Figma image layers ​

If you're using the spreadsheet to update image content, you can also rename your Figma image layers with the same spreadsheet header name (for example, #Poster) that contains image URLs in its column's content rows; your Figma layers will automatically be replaced with image content when the spreadsheet is synced.

Updating (non-text) Figma layer names ​

If you want to rename any non-text Figma layers, you can use the layer name (for example, My Frame) as your column header name, and then add any new names in the rows below it, and any matching Figma layer names will automatically be renamed when the spreadsheet is synced.

Auto repeat a single Figma layer with your spreadsheet rows ​

When using the Content or Styles sync tab options, you can automatically repeat a single Figma layer by enabling the Auto Repeat toggle, which will automatically copy the original selected Figma layer and duplicate it as many times as the number of rows that your spreadsheet data contains.

If your selected Figma layer is already directly inside of another Figma layer with Auto Layout enabled, the selected layer will automatically be duplicated inside of that parent layer, otherwise, CopyDoc will create a brand new Auto Layout frame and duplicate your new Figma layers there instead.

Dynamic auto-repeating parent layer names ​

If you want to dynamically name the new auto-repeating Figma layer from your spreadsheet data, too, you can do this by ensuring the Figma layer name that you're repeating (for example, #Title) matches a column in the spreadsheet that you're syncing; this will automatically use the value from each row under the #Title column in your spreadsheet as the layer name for each duplicated Figma layer.

If there's no matching layer name in your spreadsheet, the CopyDoc plugin will take the original Figma layer name and append a row number to it (for example, My Frame Layer (Row 3)) instead.