Knowledge Base

Documentation to help you use the POEditor localization platform effectively

How the POEditor plugin for Figma works

Owner Admin

The POEditor plugin for Figma works both ways, so you can send texts from Figma files to POEditor translation projects and fetch translations from POEditor to Figma.

How to connect POEditor to Figma

To connect Figma to a POEditor account, enter the API key of that POEditor account into the Figma plugin.

Add POEditor API key (Figma plugin) - POEditor translation management software

You’ll be able to create new projects on that account using the plugin, or work with projects which already exist in POEditor.

If your company has a paid subscription with POEditor and you want to create and host projects on that account, you'll need to use that account's API key.

How to set up a localization project using the Figma plugin

If you don't want to work with a project that was already set up in POEditor, you can create a new localization project using the Figma plugin. We actually recommend creating a separate POEditor project for each Figma file you want to localize.

After giving the localization project a name, add your source language as Default Reference Language and then add the target languages, using the Add new language button.

Set up project (Figma plugin) - POEditor translation management system

After you've added the language you want to translate from and the languages you want to translate to, it's time to send the translatable layers to POEditor, so click Done and move to the next step.

How to send text layers to POEditor

You can select the source language text layers you want to send to POEditor directly in the file or use the file's Layers Panel. In case you selected a text you don't want to send to POEditor for translation, simply click on the X next to it in the Selected Layers list.

Send translatable texts from Figma layers to POEditor (Figma plugin) - POEditor l10n tool

After you checked that the Selected Layers list contains the texts you want translated, click on Send to POEditor to push the texts from the Figma file to the POEditor project.

Note that the Figma plugin considers the identifier of each text layer (not the name of the layer) the project terms, so these IDs will be imported as terms to POEditor, and the actual text layers as translations. For this reason we recommend using separate POEditor projects for translating text layers from Figma files (preferably one POEditor project for each Figma file).

Your project should look something like this in POEditor after taking the steps described up until now.

Figma project ready (POEditor) - POEditor translation platform

If it does, you're ready to start translating the texts from your Figma file.

Translation options

You can choose to translate the texts from your Figma file in multiple ways. The translation options are:

  • assigning your own translators to specific languages, by adding them as contributors;
  • crowdsourcing translations from your community, using public projects;
  • ordering human translation services from integrated language service providers;
  • using machine translation APIs from DeepL, Google or Bing.

How to fetch translations from POEditor to Figma

To bring the translations from a target language in POEditor to Figma, first navigate in the Figma plugin to the corresponding language using the language dropdown.

Fetch corresponding translations (Figma plugin) - POEditor translation platform

You have two options to bring translations from POEditor to Figma:

  • Fetch All, which brings all the translations from the POEditor translation project to Figma for the selected language.
  • Fetch corresponding translations, which brings translations from the POEditor translation project to Figma only for the layers currently selected.

How to remove obsolete terms from the POEditor translation project

In case you remove a term in the Figma file and you want to remove it from the POEditor project too, you can use the option Show Obsolete Terms in the section POEditor Project Status.

You can click on X to remove an individual term from the POEditor translation project, or delete all the obsolete layers with Delete All from POEditor.

Remove obsolete terms (Figma plugin) - POEditor translation platform

How to update the Default Reference Language in POEditor

If you edited a text layer in the Figma file corresponding to the Default Reference Language and you want to update the corresponding text in POEditor, choose the DRL in the plugin's language menu (English in our example), select the corresponding text layers and then click on Send to POEditor.

If you have text layers in your selection which have not been imported to POEditor, the plugin will recognize them by their ID and tell you that they are not in POEditor. To send the new text layers from Figma to POEditor, select them and click on Send to POEditor.

New layers (Figma plugin) - POEditor translation management system

When sending texts to POEditor from Figma, make sure the correct language is selected in the language dropdown.

How to export a localized Figma file

You can save a copy of the Figma file from the File menu.

Save Figma file locally (Figma) - POEdito translation platform

Related articles