Figma Plugin

With the Crowdin plugin for Figma, you can use texts from Crowdin Enterprise 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 Enterprise.

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 Enterprise to your prototypes instead.
• Create and upload source strings from your designs to your Crowdin Enterprise project. This way, uploaded strings could be used by developers, which reduces time spent on development.
• Upload tagged screenshots to your Crowdin Enterprise project.

Installing Crowdin for Figma Plugin

1. Sign in to Figma.
2. Select Plugins > Manage plugins… in the File Browser.
3. Click Community on the left panel.
4. Use the Search field to find Crowdin for Figma plugin.
5. Switch to the Plugins category in the search results.
6. Click Install next to the plugin.

Connecting Figma with Crowdin Enterprise Account

Setting up Crowdin Enterprise Credentials

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

1. In Figma File Browser, go to Plugins > Crowdin for Figma.
2. Switch to Settings.
3. Provide your Personal Access Token.
4. Specify your organization domain name and click Connect.

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

• Go to Account Settings, Access tokens tab and click New token.
• Specify Token Name, select Scopes and Projects, click Create.

Selecting Crowdin Enterprise project

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

Additionally, you can select the specific branch your content will be uploaded to.

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 Enterprise 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 Enterprise.

Using Source Strings from Crowdin Enterprise 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.
3. Select the text layer you want to add text to and click on the needed string.

After using the source strings from Crowdin Enterprise in your designs, you can preview translations for these strings in Figma and upload screenshots for them to your Crowdin Enterprise project.

Adding Source Strings from Figma to Crowdin Enterprise

You can add the strings that are already used in the designs or create and add completely new strings.

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. Alternatively, skip this step if you want to add a new string.
3. In the Strings tab, click .
4. In the appeared dialog, fill in the required fields.
5. (Optional) To add labels to the strings, alternately select them from the Label drop-down menu and click Add Strings.
   

To add the same strings into multiple files in Crowdin Enterprise, alternately select the needed files from the File drop-down menu.

If some frames contain hidden elements that should not be added to Crowdin, clear the Push hidden elements option.

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

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 used the needed ICU string from Crowdin Enterprise in your design, you can configure its placeholders’ 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 Edit String 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 Enterprise 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.

Uploading Tagged Screenshots to Crowdin Enterprise

1. Open the Crowdin plugin for Figma.
2. In the Strings section, use texts from the Crowdin Enterprise project in your designs. Click to upload screenshots of the frames that include the used texts.
3. To update screenshots on Crowdin Enterprise, click again.

To learn more, read the article Screenshots.

Previewing Strings

Preview translations from Crowdin Enterprise 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 frames or Preview in the current frames.
3. Select Create with language.
4. Select the target language you want to preview translations for. You can also choose All languages.
5. Choose the content you want to preview in Figma. Select All Frames or Selected Frames.
   

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 frames.
3. Select Create with key names.
4. Choose the content you want to preview in Figma. Select All Frames or Selected Frames.
   

Marketing Visuals Localization

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

Sending Texts for Translation to Crowdin Enterprise

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 Enterprise, 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 Page Translation > Figma to Crowdin section, select content you’d like to translate. Select All Frames or Selected Frames.

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

Read more about translation strategies.

Uploading Translations from Crowdin Enterprise to Figma

You can synchronize texts between Figma and Crowdin Enterprise 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 Page Translation 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 - _ .

   

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.

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