Adobe Photoshop Plugin

Translating with the Photoshop Plugin

In this article, we will explore how to;

Log into Smartling via Photoshop

  1. In Photoshop, open a Photoshop file
  2. Click the Plugins menu > Smartling > Smartling Account
  3. This opens up a new tab in your browser, where you can log in to your Smartling account
  4. Next, in the Account Summary model, select the Smartling Project you want your Photoshop content translated in
    • If the model has been closed, simply click the Plugins menu > Smartling > Smartling Account 
  5. Choose to exclude irrelevant strings 
    • Enable this setting to exclude strings that are just numbers, symbols or other sequences that don't require translation.
    • Unselect this checkbox to include this content for translation
  6. Click Save
  7. Once the confirmation flag appears, you can click X to close out the window


Preparing Photoshop Content for Translation in Smartling

Although, there is very little to no file prep. required before submitting Photoshop content for translation in Smartling, it might be worthwhile checking that all strings (layers containing text), are as they should be.

Smartling extracts the copy from text layers as strings for translation. All text within the text layers is ingested for translation.

However, if you would like to placeholderize content, (meaning make a word or string not translatable), you can simply apply curly brackets, i.e. {} or {{}}, around to word or string, then select the placeholder checkbox when you submit the content for translation (step 6).

If you use curly brackets for another purpose, and would like the content in the brackets translated, ensure to update them to another type of bracket before submitting the content for translation.


Submit Photoshop Content for Translation in Smartling

  1. Launch Photoshop
    • You must have the file open in Photoshop to take any action on it via the Smartling plugin
  2. Open the Photoshop file that you want to translate
    • This is the source file that the Smartling plugin will convert into a JSON file for translation
    • All Smartling Plugin options can be found under the Plugins menu at the top navigationScreenshot_2021-10-07_at_12.33.03.png
  3. Click Plugins > Smartling > Submit Translation from the Photoshop menu 
  4. Using the checkbox on the left, select the string(s) you want to submit for translation
    • You can unselect content that does not need a translation.
  5. To view the string key/variant, click the downward arrow on any of the strings.
  6. Click the pencil icon edit the key name.
  7. Choose to turn any text inside {} and {{}} into non-translatable placeholdersScreenshot_2021-08-19_at_19.15.15.png
  8. Click Next to proceed
  9. Complete the Submit Translation dialog.
    1. Choose to add the content to an existing Job and choose the existing Job from the dropdown, or choose to create a new Job and name the new Job
    2. Give the Job a deadline by inserting a due date and time in the field next to the Job name
      • This defaults to one day in advance from the current day, but you can update this to sometime in the future of the same day.
    3. You can give the linguists additional details on how you want the Job translated by providing a description
    4. Choose to pre-authorize the Job, meaning once you complete these steps, the Job will automatically authorize and proceed with the translation in the target language's default workflow.
      • If you choose not to select this checkbox, the Job will sit in Awaiting Authorization in Smartling until a user Authorizes the Job for translation. This option allows the user to decide the workflow in which the language should be translated in, as well as view a cost estimate before commencing translation.
    5. Select the target languages for the translation (required)Screenshot_2021-08-19_at_19.16.27.png
  10. Click Submit to submit the content to Smartling for translation
  11. Once complete, the Translation Submitted dialog will appear with the Job summary.
    • Click the hyperlinked Job name to open the Job in Smartling on your browser.
  12. Close to continue working in Photoshop.Screenshot_2021-10-06_at_16.55.45.png

Editing Key Identifiers

A key is a unique identifier for a string. By default, Photoshop 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 cannot contain spaces.  Note, key names must be unique per string. Key names cannot be repeated.

  • Click the downward arrow to reveal the assets and keys.Screenshot_2021-08-19_at_19.06.32.png
  • To edit the key, click the pencil icon. Click the tick to save.Screenshot_2021-08-19_at_19.05.47.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 Source String column in the Strings View.Screenshot_2021-10-07_at_12.56.38.png


  • Search for strings with a specific key identifier using the Key/Variant field
  • Note that the Key/Variant search box does not support spaces. If your key name has spaces in Photoshop, it will not return a result when searching in Smartling. It's best to use underscores (_) to separate words in key names.


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 Photoshop key identifier from the string, but rather add to it, so you can search for the string easily in Smartling.

Note that the edited key name is also visible in the source and translated JSON file that you can download from the files tab within the Job Details page in Smartling, however, the original key names (not the edited key names) are found in the exported JSON via the Smartling Plugin action Export (Manual).


Retrieve Translations from Smartling

Once your translations are complete in Smartling, you can send translations directly to your Photoshop app by Applying Translations via the Translation Status model. Alternatively, a Smartling user can download the translated files from Smartling and manually import them into Photoshop. 

Import Translations From File

To import translated JSON files into Photoshop:

  1. Click on Plugins > Smarting > Import (Manual) from the Photoshop Menu.
  2. Select your translated JSON file from your directory.
  3. Click Open to import or Cancel to exit menu.

Export Content to File

You can export a JSON file of your Photoshop page. One Photoshop page can be exported at a time. If your design has multiple pages, you will need to export each page individually.

  1. To export content, click on Plugins > Smarting > Export (Manual)
  2. Select the Page you want to Export. You can select multiple Pages to download.
  3. Select the strings you want to include in the exported file. Click the downward arrow on each string to expand to view sub-strings.
  4. Click Export
  5. A zip file will download to your local drive, containing a PNG and a JSON of each of your Photoshop pages

Was this article helpful?