Figma Plugin

With the Crowdin for Figma plugin, you can use texts from Crowdin in your designs to save time for both designers and developers. These could include original or translated texts. If necessary, you can add new ones (e.g., dialog titles, button labels) and send them to translators in Crowdin.

Note: The Pages tab and some other plugin settings may be unavailable when working with string-based projects.

Use Cases

  • Quickly generate multilingual creative assets.
  • Translate mockups and test them in different languages before the programming starts.
  • Stop using ‘Lorem Ipsum’, add real texts from Crowdin to your prototypes instead. Strings added from Crowdin become linked to the text fields in Figma.
  • Create and upload source strings from your designs to your Crowdin project. Created strings become linked to text fields in Figma. This way, developers could use uploaded strings, reducing time spent on development.
  • Preview translations and string keys in your designs.
  • Upload tagged screenshots to your Crowdin project.

Running Crowdin for Figma Plugin for the First Time

  1. Sign in to Figma.
  2. Open one of your design files or click New design file.
  3. In the file menu, click Plugins > Manage plugins…. Alternatively, right-click the canvas and click Plugins > Manage plugins.
  4. Use the Search all plugins field to find Crowdin for Figma plugin.
  5. Click on Crowdin for Figma plugin and select Save.
  6. Hover over the Crowdin for Figma plugin and click Run.

Connecting Figma with Crowdin Account

Setting up Crowdin Credentials

Note: To set up Figma integration, you need to have manager or owner permissions in the Crowdin project.

To specify your Crowdin credentials in Figma, follow these steps:

  1. In the file menu, go to Plugins > Saved plugins. Alternatively, right-click the canvas and click Plugins > Saved plugins.
  2. Click Crowdin for Figma.
  3. Switch to Settings.
  4. Provide your Personal Access Token.
  5. Click Connect. Figma Plugin Connect to Crowdin

To generate a new token in Crowdin, follow these steps:

  1. Go to Account Settings > API, Personal Access Tokens section, and click New Token.
  2. Specify Token Name, select Scopes, and click Create.

Crowdin Personal Access Token

Selecting Crowdin project

To select the project you’d like to work with, click the drop-down menu in Settings > Crowdin Project, and select a project from the list. Later, you can click Disconnect in the same section to switch to another project if needed. Figma Plugin Selecting Crowdin Project

Select a content type you’re going to work with in this project and click Save.

You can choose one of the available options:

The selected content type option affects which mode of the Crowdin for Figma plugin will be available to a user.
Figma Plugin Selecting Content Type

Select the specific branch your content will be uploaded to. If your Crowdin project doesn’t have branches, leave it empty. Figma Plugin Selecting Branch

UI Localization

Use the Strings tab when localizing UI and working on dynamic pages with your development and marketing teams. In this tab, you can add source strings from Crowdin to your designs in Figma in a click. After the texts are used in the designs, you can automatically upload tagged screenshots for translators’ reference back to Crowdin.

Using Source Strings from Crowdin in Figma

  1. Open the Crowdin plugin for Figma.
  2. In the Strings tab, use the Search field to find the specific copy. You can search strings by source text, string identifier, or context. Figma Plugin Strings Tab
  3. Select the text layer to which you want to add text and click the link icon next to the needed string. Figma Plugin Using Source Strings from Crowdin in Figma

After using the source strings from Crowdin in your designs, they become linked with the text fields, and you can preview translations for these strings in Figma and upload screenshots for them to your Crowdin project.

You can link a single Crowdin string to one or multiple text fields in Figma. However, one text field can be linked only to a single Crowdin string. If you link a text field with an existing connection to a new Crowdin string, the previous connection will be terminated, and a new connection will be established. If you’d like to unlink a Crowdin string from all text fields it was previously linked to, right-click on the link icon next to the needed string.

Adding Source Strings from Figma to Crowdin

You can add strings that are already used in the designs.

  1. Open the Crowdin plugin for Figma.
  2. To add the strings used in the designs, select the whole frame, multiple frames, or the needed strings on the frames.
  3. In the Strings tab, click .
  4. In the appeared dialog, fill in the required fields. You can filter the displayed strings if needed:
    • Select the Skip hidden elements filter option if some frames contain hidden elements that should not be added to Crowdin.
    • Select the Skip untranslated elements filter option if some frames contain untranslated elements that should not be added to Crowdin.
      Figma Plugin Add String
  5. (Optional) To update the string context and set the max.length of the translated text, click toward the needed string.
  6. Once all the needed strings are selected and configured, click Next.
  7. In the next dialog page, select the preferred options:
    • Auto-link existing strings – automatically compare text to existing strings in Crowdin. If there’s a match, the text element will be linked to the string in the Crowdin project.
    • Create missing keys – only new text elements are added to Crowdin.
    • (Optional) To add labels to the strings, alternately select them from the Select Label drop-down menu.
    • Merge duplicates – link identical text elements to a single new string in Crowdin. It’s useful in the following cases:
      • When adding multiple text fields with the same text, the plugin will add only one string to your Crowdin project and link all duplicate text fields to it.
      • If your Crowdin project already contains a string with the same text you’re adding from designs, the plugin will only link the text fields to the existing string and won’t create a new one.
    • Send screenshots
  8. Select the file in Crowdin to which you want to add the strings. To add the same strings into multiple files in Crowdin, alternately select the needed files from the Select File drop-down menu.
  9. Click Submit.
  10. Once the strings are added to Crowdin, you’ll see a summary of the content sent.

Added strings will be transferred to your Crowdin project and also displayed in the Strings tab’s list. You can edit, hide, or delete the strings from the same list anytime. The respective changes will also be applied to the strings in your Crowdin project.

Adding Source Strings with Plural Forms

You can add strings with plural forms.

  1. Open the Crowdin plugin for Figma.
  2. To add the strings used in the designs, select the whole frame, multiple frames, or the needed strings on the frames.
  3. In the Strings tab, click .
  4. In the appeared dialog, fill in the required fields. You can filter the displayed strings if needed.
    Note: When adding plural strings, the fields in the String column serve for adding the other plural form.
  5. Click toward the needed string and click Add plurals.
  6. In the appeared dialog, fill in the fields for each plural form and click Save. Depending on the source language of the connected Crowdin project, there could be a different number of plural forms you should specify.
    Note: You can add plural strings only to files that support plural forms (e.g., Android XML, Stringsdict, XLIFF, etc.).
  7. Once all the needed strings are selected and configured, click Next.
  8. In the next dialog page, select the preferred options.
  9. Select the file in Crowdin to which you want to add the strings.
  10. Click Submit.

Read more about Plural Forms.

Configuring ICU Source String Placeholders

When using ICU strings in your design, you can set the placeholders’ values, and after adding such strings to designs, they will be displayed in a formatted view with the preconfigured values.

Once you use the needed ICU string from Crowdin in your design, you can configure its placeholder values.

  1. Open the Crowdin plugin for Figma.
  2. In the Strings tab, use the Search field to find the specific copy. You can search strings by source text, string identifier, or context.
  3. Click on the needed ICU string.
  4. Click Set placeholders.
  5. Type the needed values for ICU string placeholders.
  6. Click Submit to save the entered placeholders.
  7. Click Submit to update the source string text in designs.

When previewing translations for ICU strings in Figma, they will also be displayed in a formatted view if the values were preconfigured beforehand.

Key Naming Pattern Settings

To simplify adding strings from Figma to the Crowdin project, you can set up the desired key naming pattern for the source string identifiers in the plugin settings. The Crowdin plugin for Figma will suggest the string identifiers for new strings based on the selected pattern. While adding new source strings, you can always edit the suggested identifier to the preferred look.

To select the key naming pattern, follow these steps:

  1. Open the Crowdin plugin for Figma.
  2. Switch to Settings.
  3. In the Key naming pattern section, select the preferred option from the drop-down menu.

Besides the existing patterns, you can configure your own pattern. To use a custom pattern, select the Custom key naming pattern option from the drop-down list and specify your pattern in the Custom Key Naming Pattern field.

Uploading Tagged Screenshots to Crowdin

When adding source strings used in the designs, make sure to keep Send screenshots selected. As a result, the Crowdin plugin for Figma will upload screenshots along with the source strings.

Also, you can update screenshots with an Update screenshots option while editing a Crowdin string that is linked to the text fields in designs.

Additionally, you can mass upload screenshots to Crowdin for strings linked with text fields in designs.

  1. Open the Crowdin plugin for Figma.
  2. Select one or more frames with the linked strings.
  3. In the Strings tab, click to upload screenshots for selected frames.

To learn more, read the article Screenshots.

Previewing Strings

Preview translations from Crowdin for the strings used in the designs in Figma. You can preview translations in the new frames or the original ones. When previewing translations in the new frames, you can populate them with the actual translations or with string keys for further use by developers.

To preview strings populated with translations, follow these steps:

  1. Open the Crowdin plugin for Figma.
  2. In the Strings > Preview Strings section, select Preview in duplicated page or Preview in the current page.
  3. Select Create with language.
  4. Select the target language you want to preview translations for (optionally, you can select the preferred plural forms). You can also choose All languages.
  5. Choose the content you want to preview in Figma. Select All Frames or Selected Frames.
    Figma Plugin Preview Strings

To preview strings populated with key names, follow these steps:

  1. Open the Crowdin plugin for Figma.
  2. In the Strings > Preview Strings section, select Preview in duplicated page.
  3. Select Create with key names.
  4. Choose the content you want to preview in Figma. Select All Frames or Selected Frames.
    Figma Plugin Preview Keys

Filtering Strings

To view only the strings linked to specific text fields, follow these steps:

  1. Select the needed text fields.
  2. In the Strings tab, click Filter strings.
  3. Select Show strings linked to selected text elements.

In the same way, you can filter strings linked to text fields for the whole frame or multiple frames.

Marketing Visuals Localization

Use the Pages tab to localize static pages, like brochures and banners. In this tab, you can send texts with context for translators to Crowdin and upload translated copies back to Figma.

Sending Texts for Translation to Crowdin

You can send text for translation either from selected or all frames from a Figma file. Translators will work with those texts in the list view and use designs as an additional context for even higher translation quality.

In Crowdin, a root folder figma-plugin will be created. It will contain a subfolder named after your Figma file with HTML files for each frame inside. If needed, you can disable content segmentation in the plugin Settings so the long texts will not be split into sentences.

To send Figma designs for translation, follow these steps:

  1. Open the necessary Figma file.
  2. Go to Plugins > Crowdin for Figma.
  3. In the Pages > Figma to Crowdin section, select the content you’d like to translate. Select All Frames or Selected Frames.
    Figma Plugin Send Texts

When the source files are uploaded to your Crowdin project, you can invite contributors to translate and proofread them.

Read more about translation strategies.

Pseudo-localization

Even before translations are completed, you can test whether your application is ready to be localized using pseudo-localization. This feature allows you to simulate how the application’s UI will look with different languages to check whether the source strings should be modified before the project localization starts.

Once you send your texts for translation, you can start pseudo-localization.

  1. Open the necessary Figma file.
  2. Go to Plugins > Crowdin for Figma.
  3. In the Pages > Pseudo-localization section, select the content you’d like to test with pseudo-localization. Select All Frames or Selected Frames.
  4. In the appeared dialog, configure settings according to your preferences.
  5. Click Submit. Figma Plugin Pseudo-localization

Read more about Pseudo-localization.

Uploading Translations from Crowdin to Figma

You can synchronize texts between Figma and Crowdin projects whenever you want to test the translated copy inside Figma or generate multilingual assets.

To upload translated copies to Figma, follow these steps:

  1. Open the necessary Figma file.
  2. Go to Plugins > Crowdin for Figma.
  3. In the Pages tab, Crowdin to Figma section, select the target language you want to upload translations for. You can also select All languages.
  4. Select the content you want to preview in Figma. Select All Frames or Selected Frames.
    Note: Page names in Figma can consist of only letters (a-z, A-Z), numbers (0-9), and special characters - _ .

    Figma Plugin Upload Translations

After uploading translations to Figma, the modified file will contain a separate frame with translations for each target language. The newly uploaded translated versions won’t override the ones you uploaded previously. You can always delete the translated copies you no longer need.
Figma Plugin Uploaded Translations

If you’d like the newly uploaded translated versions to override the previously uploaded ones, open the plugin Settings and select Override existing translations.

Was this article helpful?