SheetSync

About this plugin

A Figma plugin that automatically populates component instances using data from Excel or Google Sheets exports. Ideal for design systems, dashboards, and repetitive UI elements.

Features

- Upload `.xlsx` or `.xls` files and populate selected component instances.

- Automatically duplicates component instances based on the number of rows in the spreadsheet.

- Populates text layers with `#` prefixes.

- Supports component properties:

1. Variant properties
2. Boolean properties
3. Text properties

- Works inside auto-layout and non-auto-layout frames, keeping duplicates contained within the parent.

- Dynamic mapping: matches spreadsheet column names to layers and properties automatically.

- Keeps original instance populated along with duplicates.

Spreadsheet Format

The plugin expects a spreadsheet with **columns matching text layers or component properties**.

Example Columns:

Title | Description | Subhead | State | Size | Show Description

Notes:

1. Text layers must start with `#` to be populated (e.g., `#Title`, `#Description`).
2. Column names must match layer or property names (without `#`).
3. Boolean columns: TRUE/FALSE.
4. Variant columns: values must match the component variant options.

Sample Data:

| Title | Description | Subhead | State | Size | Show Description |

| -------------- | ------------------------------- | ------- | -------- | ----- | ---------------- |

| Server Upgrade | Upgrade backend servers to v2.1 | Backend | Active | Large | TRUE |

Usage

1. Select a single instance of your component in Figma.

2. Open the plugin.

3. Select and Upload your Excel file (`.xlsx` or `.xls`).

4. The plugin will duplicate the instance for each row and populate the layers and component properties automatically.

Notes

1. Ensure the component instance is **selected** before running the plugin.
2. The plugin automatically keeps duplicates inside the parent frame.
3. Works for any number of rows in the spreadsheet.
4. Supports components with new props as long as the spreadsheet columns match.