Getting Started with Sheets2Figma
Installation#
- Open any Figma design file
- Go to Menu → Plugins → Manage plugins
- Search for "Sheets2Figma"
- Click Install
Quick Start#
Step 1: Prepare Your Data#
Create a spreadsheet with your content. The first row should contain column headers:
| Name | Role | Company |
|---|---|---|
| Sarah Chen | Product Designer | Acme Inc |
| Marcus Rivera | Design Lead | TechCorp |
| Anna Kowalski | Freelancer | Independent |
You can use:
- Google Sheets — paste the public URL
- Excel files (.xlsx) — drag and drop into the plugin
- CSV files — drag and drop into the plugin
Step 2: Set Up Markers#
In your Figma design, rename text layers using the *ColumnName marker syntax:
*Name→ will receive data from the "Name" column*Role→ will receive data from the "Role" column*Company→ will receive data from the "Company" column
Layer Naming
The marker name must exactly match the column header in your spreadsheet. It's case-sensitive: *Name matches "Name" but not "name".
Step 3: Select Frames#
Select the frames you want to populate with data. Each selected frame will receive one row of data from your spreadsheet.
- Select 3 frames → 3 rows of data will be used
- Select 10 frames → 10 rows of data will be used
Step 4: Run the Plugin#
- Open Sheets2Figma from the Plugins menu
- Paste your Google Sheets URL or drop a file
- Click Sync
- Watch your data flow into the design!
Data Sources#
Google Sheets#
- Open your Google Sheet
- Click Share → Change to "Anyone with the link"
- Copy the URL
- Paste it into the Sheets2Figma plugin
Sharing Required
The Google Sheet must be publicly accessible (view-only is fine) for the plugin to read data.
Excel Files#
Simply drag and drop your .xlsx file onto the Sheets2Figma plugin window. The plugin reads the first sheet in the workbook.
CSV Files#
Drag and drop .csv files onto the plugin window. Make sure your CSV uses comma separators and UTF-8 encoding.
Selection Scope#
You can control which frames receive data:
- Selected frames — only frames you've selected
- Current page — all frames on the current Figma page
- Entire file — all frames in the file (use with caution)
For most workflows, selecting specific frames gives you the most control.
Next Steps#
- Learn about the Marker System for advanced data mapping
- Explore image syncing for loading images from URLs
- Check out troubleshooting if you run into issues