Please note that this plugin is a paid product. For pricing information, please reach out to your Smartling Customer Success Manager.

To use the Smartling Figma plugin, you must have access to Smartling as an Account Owner, Project Manager, or Requester. The plugin can be used in either Figma in the browser or the Figma desktop app.

Prerequisites and Limitations

1. Access to Smartling as an Account Owner, Project Manager, or Requester
   • This means having an activated user account (i.e. you have signed in to Smartling successfully)
2. Some cybersecurity software programs, such as ZScaler and InfoBlox, may block your access to the plugin. Disabling these programs will allow you to log in to Smartling and choose a project via the plugin.
3. If you use an organization or enterprise Figma plan, organization admins can restrict access to 3rd party plugins, requiring approval before they can be used. When enabled, members can only use plugins and widgets that have been approved by an organization admin. Ensure the Smartling plugin is approved by an Admin on your Figma account.

Download Figma Desktop App

Refer to the Figma documentation for the latest guide to the Figma app. Alternatively, you can access Figma directly in your browser. 

Create a Figma Project in Smartling

• Log in to Smartling with an Account Owner user role.
• Create a new project.
  • Select the Project Type "Connector".
  • Select Figma as your connecting platform.
• After creating the project, please ensure that all default workflows, vendor assignments and Linguistic Assets are set up correctly for this new project.

Save the Smartling Figma Plugin

These instructions pertain to the Figma 2024 UI (Figma UI3). If you are using an earlier version of Figma, you may see a slightly different interface. Please consult the Figma documentation for more info on using plugins.

In Figma, you can "Save" plugins to add them to your Figma account. To save the Smartling plugin: 

1. Open the Figma desktop app or launch Figma in your browser
2. Go to the Smartling Figma plugin page 
3. Click the bookmark icon to Save the plugin to your account
   

You can also Save the Smartling plugin directly from within Figma designer via the Actions menu.

1. Click the Actions menu icon.
   
2. Go to Plugins & widgets and search for "Smartling" 
3. Click on the Smartling plugin to open the plugin page
4. Click Save

Tip: Watch this Figma tutorial on how to save and remove Figma plugins.

Note: The plugin license fee is added to your Smartling license. No payment is taken through the installation flow of the plugin. For more information on "Third-party payment", read the Figma documentation.

Connect the Figma Plugin to Smartling

1. Open a new or existing Figma file.
2. In the Figma menu (top left), click Plugins > Smartling. Here you'll notice all the translation features available.
   
    
3. Select the Smartling Account option.
4. The Smartling Account section will open a browser to prompt you to authenticate with Smartling. 
   • On the browser, sign in with your Smartling credentials
5. Select the Smartling project you want to submit Figma content to for translation.
6. Select any of the optional checkboxes to control which content is sent for translation and how it is parsed:
   • Exclude irrelevant strings
     •  Enabling this setting prevents any string that contains only numbers, special characters, or emojis from being submitted for translation
   • Remove all formatting before submission
     • Enabling this setting removes any HTML markup from the submitted file, so linguists only see text for translation
     • This also removes the markup from the translated version
   • Remove all invisible text nodes
     • Enabling this setting will ensure only visible text nodes are sent for translation
     • If the file has invisible text nodes (hidden) that you do not want translated, enabling this setting removes them from the submitted file
     • The hidden text nodes are also removed from the translated version of the file
   • Exclude locked layers from translation
     • Enable this setting to ensure that any content in locked layers is not sent for translation
   • Create visual context images using frames rather than the entire page. Text outside of frames is ignored (recommended - see more on Visual Context)
     • Enabling this setting automatically sends text frames as visual context
     • Text nodes outside of frames will not be sent for translation
     • We recommend grouping text and images by frames in Figma before submitting a file for translation
     • Frames within frames are not submitted to Smartling
     • Sections or slices are not yet supported
   • Use short variants keys.
     • Enabling this setting means the names of the text nodes will be used as keys in Smartling
     • If you enable this setting, please ensure your text nodes are named according to how you want the keys to appear. The plugin cannot ensure the uniqueness of keys when this setting is enabled.
     • If this option is disabled, the plugin will use the entire node path, incorporating node IDs, as the key. This method guarantees unique keys.
   • Turn text inside {} and {{}} into non-translatable placeholders.
     • Enable this setting so that any text within curly braces will be ingested as a placeholder.
7. Click Save.
8. Once the confirmation flag appears, you can click X to close out the window.

Visual Context

Using the Figma plugin provides automatic visual context for linguists working in the CAT Tool.

By default, visual context is submitted for the entire page. However, only images up to 50M pixels or 20MB are supported.

Alternatively, you can choose to submit images as frames (as mentioned in the settings above). This exports the design frame by frame, so each frame is checked against the limit individually rather than as part of the whole page, which can help reduce the chance of exceeding the limit. However, if an individual frame itself exceeds the 50M pixel or 20MB limit, context will not be generated for that frame.

If a page or frame exceeds the limit, you'll need to resize the image manually and upload it through the Smartling dashboard.

Now you're ready to start translating with the Smartling Figma plugin.