How to review and edit translations

In TeleportHQ, you review and fix translations in the Manage content window: click the language button at the top left of the canvas, choose Manage Content, pick a page or component on the left, and edit any text in any language. To fix one text in place, select that language in the language button and edit the text on the canvas. An edit made in a secondary language only changes that language. To work with a professional translator, export the texts as a CSV or XLIFF file and import the translated file back.

Before you start#

• Your site needs at least two languages. See How to add a language.
• You need a role that can edit the project's components.

Steps#

Edit translations in one table#

1. At the top left of the canvas, click the language button (a globe and your current language).
2. Click Manage Content. The Manage content window opens on the page you have open in the editor.
3. Edit the texts:
   1. On the left, pick the page or component whose texts you want, from Pages, Components or CMS pages.
   2. At the top, type in Search in the selected page or component to find a text, for example classes.
   3. Automatically translate content: with it on, a text you change in the main-language column is translated into the other languages.
   4. The table: the first column is your main language, for example English (Main Language), and each other column is a language. Click a text in a language column and correct it. A text still waiting for a translation shows Still in English.
4. Close the window with the × at the top right.

When some texts of the selected page are still in your main language, a bar above the table shows Untranslated only, to list those texts only, and Translate everything missing, to fill them in with AI. To see where a text is used, click the eye button in its main-language cell (tooltip Show on page): the window closes and the element is selected on the canvas. With more than two languages, the Languages buttons show or hide columns.

Edit one language on the canvas#

1. Click the language button and select the language to fix. For example, Spanish.
2. Double-click the text on the canvas and type the correct translation.
3. The You are updating content in a secondary language window explains that the change only affects the Spanish version. Click OK.

Translate a page's title and description#

1. In the left sidebar, click Pages, Components & Tree View.
2. Right-click the page, or click the … at the end of its row, and choose Page SEO Settings.
3. In the card You have multiple languages used inside your project, choose the language to edit.
4. Type the translated Meta Title and Meta Description.

See How URLs and SEO work on a multilingual site.

Send your texts to a translator#

1. Click the language button, then Export / import for translators. The Work with translators window opens.
2. Choose the settings:
   1. Language: the language to translate into, for example Spanish. Format: XLIFF 1.2 (translation tools) or CSV (spreadsheets).
   2. Export downloads a file with every main-language text and its current translation. Import translated file reads the file your translator sends back.
3. Click Export and send the file to your translator.
4. When the translated file comes back, open the same window, choose the same Language and Format, click Import translated file and pick the file.

"Formatting and links stay in the project; only words travel." The window then says how many texts were updated, for example "12 texts updated · 30 unchanged".

Check that it worked#

Select the language in the language button and look at the page on the canvas. Then click Preview in the floating toolbar at the bottom center of the editor to see the page as a visitor would. The fixed texts show your corrections.

Troubleshooting#

My fix in Spanish was overwritten When Translate text elements automatically is on, changing a text in your main language translates that text again into every language, which replaces your fix. Make your main-language changes first, then fix the translations. Or turn off Translate text elements automatically (Project settings → Editor → Preferences → Editing) while you fine-tune. See How to translate your site automatically.

"No text matches your search" "Try another search, or pick a different page or component." The search only looks inside the page or component selected on the left.

"This text is not shown by any element on your pages any more." The text is left over from an element that was removed. You can ignore it.

"Your current role does not have enough permissions to update internationalization content" Your role can't edit translations. Ask a workspace owner or admin to change your role.

An import says "The file is a … translation; choose that language to import it." or "The file is not valid XLIFF." Pick the language the file was exported for, and the same format, then import it again. Texts changed or removed since the export are skipped.

A text changed in every language when I only wanted one You edited it while the main language was selected. Select the language you want to change first, then edit.

Good to know#

• Image alt text, placeholders and other hidden texts are in the table too.
• Blog posts, Help Center articles, store products, bookable items and categories are translated in their own forms, under Content language, not in Manage Content. See How to translate blog posts.
• A form's success and error messages are translated in the form's settings. See How to choose what happens after someone submits a form.
• Translations show on your live site after you publish.