Settings

In the Settings tab, there are three options. They provide a way to improve the experience using while the plugin.

Settings tab

For security reasons, the Figma Developers API does not allow access to the document URL. That’s why the Figma File share link has its place in the settings. When enabled, each string will show a backlink to its Figma file TextNode representation.

This way, every contributor working on a project will instantly have an actual context, even if the design was updated recently.

An example:

  1. Copy share link using this approach. Then, paste the link to Figma File share link field and click the save icon.

Figma file share link saved

  1. Upload content from Figma to Localazy.

  2. Go to the Localazy project and navigate to a string detail. You will see a backlink in a Translation note field. This works for both the source language and translations.

Localazy translation note (source)

Localazy translation note (translation)

  1. Click on the backlink, and you will be taken into the Figma file and focused on the TextNode.

Backlinked translation note

This setting is stored in the current Figma file. Therefore once stored, every user accessing the document will have it ready, with no need to fill and save it again.

Currently, only backlinks of certain character lengths are supported. If your string is nested inside a couple of other elements, the backlink will lead you to the correct Figma file but not focus on the TextNode. We have reported this issue to Figma. Until resolved, you can overcome this by using Direct Link Figma Plugin.

Use node name as source key 🔗

By default, Figma internal TextNode id will be used to identify a string. This id typically looks somehow like this: 13:849 or I30:1470;13:208;8:426.

But sometimes, designs can be intentionally prepared the way that TextNode names are later used as locale source keys in project code. It may save a lot of time when turning a design into a code. This feature will be applied by ticking the checkbox.

This option is stored in a current Figma file. Every user accessing the document will have it set the same.

It is important to notice that while using TextNode node names as source key, you need to manage the node names by yourself as there might be duplicates. These duplicates will resolve in overwriting a string in Localazy. If not active, ids in the Figma file are always unique.

Upload and download the entire file 🔗

This option allows to switch the upload & download context according to your needs. Implicitly, context is set to a currently active page. The context setting is applied only if there is nothing selected - if so, then only the selection will be uploaded/downloaded. You can always see your current upload & download context in the Upload tab and Download tab.

We recommend using the page context in large Figma files containing thousands of TextNodes. It increases the performance of an upload and download process the plugin does not have to traverse the whole Figma document tree, only an active page.