Automatically replace text content in your Figma designs using JSON, CSV and TSV data
The Replacer is a powerful Figma plugin that lets you quickly swap text in your designs with your own datasets. Perfect for creating personalized resumes, cards, profiles, or any design that needs dynamic content updates.
- 🔄 Bulk Content Replacement: Replace multiple text fields at once
- 🎯 Smart Pattern Detection: Automatically detects similarly named layers and applies to all instances accordingly
- 📋 Dataset Management: Save and reuse frequently used data sets
- 🔗 Nested Data Support: Handle complex JSON structures with arrays and nested objects
- Download or clone this repository to your computer
- Make sure you have all the plugin files:
manifest.jsoncode.jsui.html
- Open Figma Desktop (this won't work in the web version)
- Go to Plugins → Development → Import plugin from manifest...
- Navigate to the plugin folder and select
manifest.json - Click Open
- In any Figma file, go to Plugins → Development → The Replacer
- The plugin interface will open on the right side
This plugin supports pasting JSON, CSV and TSV (pasted from a spreadsheet with headers)
We recommend using JSON for advanced advanced needs like multiple options within a keyname for items such as job skills or in the example below, favorite games.
- Go to Add Data tab
- Paste JSON, CSV or TSV data
- Click "Validate Data" to confirm the plugin can read it
- Click "Save Data" to give dataset a name to reference for Map Data and Content.
Example:
[
{
"name": "Alex Rodriguez",
"gamertag": "ShadowHunter92",
"favoriteGames": [
{ "game": "The Witcher 3: Wild Hunt" },
{ "game": "Dark Souls III" },
{ "game": "Cyberpunk 2077" },
{ "game": "Elden Ring" }
]
},
{
"name": "Sarah Chen",
"gamertag": "PixelNinja",
"favoriteGames": [
{ "game": "Overwatch 2" },
{ "game": "Valorant" },
{ "game": "Apex Legends" },
{ "game": "Counter-Strike 2" }
]
}
]Use Map Data to automatically rename multiple layers to {{fieldname}} format for replacement
- Select a frame or group containing text layers with existing names
- Go to "Map Data" tab and click "Find Data" for your saved dataset
- Map layer names to data fields (duplicates are grouped automatically)
- Click "Map Data" to batch rename all selected layers
You can also manually modify your layers, but who has the time for that!
Examples:
{{full_name}}- Will be replaced with data from JSON field "full_name"{{job_title}}- Will be replaced with data from JSON field "job_title"{{company_name}}- Will be replaced with data from JSON field "company_name"
- Go to Content tab
- Select the design elements you want to update (frames, groups) now or have previously
- Click "Apply All" to replace content across all selected elements
- Or click "Apply" to apply data to one object at a time from the dropdown
Keep your text layers organized in frames or groups. The plugin works best when similar elements are contained together.
When you have multiple JSON records, the plugin will:
- Apply different records to different selected containers
- It will continue to cycle through back to the original record and apply if you have more selections than records
You can use the "Apply" button in the dataset dropdown in Content to test it with any individual record.
"Missing JSON keys" error?
- Check that your layer names exactly match your JSON field names
- Make sure you're using the
{{field_name}}format - Verify your JSON is valid (use a JSON validator)
Plugin not detecting patterns?
- Make sure similar elements are grouped in frames
- Check that text layers are named consistently
- Try selecting individual groups instead of everything at once
Data not applying correctly?
- Ensure your selected elements contain the named text layers
- Check that your JSON structure matches your layer naming
- Try with simpler data first, then add complexity
If you encounter issues:
- Check that all layer names use the
{{field_name}}format - Validate your JSON data is properly formatted
- Make sure you're using Figma Desktop (not web version)
- Try with a simple example first
The plugin works great with data like:
- Resume/CV content (personal info, experience, education)
- Team member profiles (names, roles, photos, bios)
- Product catalogs (names, prices, descriptions)
- Event listings (dates, locations, speakers)
- Testimonials (quotes, names, companies)
Happy designing! 🎨