Figma Plugin

Translating with the Smartling Figma Plugin

In Smartling, translation works through jobs, with which you can group and prioritize content for translation, as well as monitor progress.

Using the Figma plugin will also provide automatic Visual Context for linguists in the CAT Tool for images up to 50M pixels.

Although the Smartling Figma plugin is visible in the Figma browser, it is currently only accessible via the Figma Desktop app.

To submit your Figma content into a Smartling job:

  1. Launch Figma Desktop App
  2. Open a new or existing Figma prototype file.
  3. Click Plugins > Smartling > Submit Translation from the Figma menu. 
  4. Select the page you want to submit for translation > NextScreenshot_2020-11-20_at_14.08.56.png
  5. Once you've selected the pages, you'll need to identify which frames/strings you'd like to translate. The frames/strings are organized by the page they belong to. Simply select the checkbox of strings/frame to send for translation and deselect the checkbox of strings/frames to exclude for translation. This is especially useful when you don't want to translate elements of the mobile OS, such as the clock or battery level.

  6. Click the downward arrow on any of the strings to view sub-strings and edit the key name.
  7. Choose to turntext inside {} and {{}} into non-translatable placeholdersScreenshot_2020-11-20_at_14.32.49.png
  8. Once you've identified the frames/strings that you'd like to translate, click Next to proceed.
  9. You'll now need to fill out some information to create your job. Choose to Create a new Job and type in your job name, or Add to existing job and choose from the list of existing jobs in progress in Smartling.
  10. Specify your due date and leave some special instructions in the description for the translation team if you'd like.
  11. You can also decide to Pre-authorize these jobs for translation if your translation team requests you to do so. If you choose not to Pre-authorize, you will need to log into Smartling and Authorize the job for translation to commence the translation process.
  12. Lastly, select which languages you'd like to translate into, if a language is missing, please contact your translation team and ask them to add the desired language to your Smartling project.
  13. Now you'll hit Next/Submit and your Smartling job will be created and delivered to the translation team.

  14. Once complete, the Translation Submitted dialog will appear with the Job summary. Close to continue working in Figma.

Editing Key Identifiers

A key is a unique identifier for a string. By default, Figma provides a unique identifier which you can also view in Smartling. You can now edit the key name to give it more relevance for you. The key can contain letters and numbers, underscores, and hyphens but can not contain spaces.  Note, key names must be unique per string. Key names cannot be repeated.Screenshot_2020-11-20_at_14.14.31.png

To edit the key, click the pencil icon. Click the tick to save.Screenshot_2020-11-20_at_14.14.48.png


Working with Key Identifiers

A key uniquely identifies the string, meaning the key can be used to quickly find a string in Smartling or in the JSON file.

Strings View

In Smartling, you can find the key name under the File/URL column in the Strings View.


Search for strings with a specific key identifier using the Key/Variant field


The CAT Tool

Users working in the CAT Tool can view the string key under Additional Details on the top-right panel, beside Variant.


Editing the key name will not remove the default Figma key identifier from the string, but rather add to it, so you can search for the string easily in Smartling or on the JSON file.

Re-uploading Content

When submitting individual frames of the same page that has been previously submitted to Smartling within Figma, the previous frame will be removed from its original Job. This is due to the file/page being unique and so this is treated as a file overwrite. This results in the previous content being removed.


Next, you'll need to check the translation status and download the translations. See our article on Applying Translations in Figma.

Was this article helpful?