Universally Documentation

Step-by-step guides, multilingual SEO tips, and best practices to help you translate and scale your WordPress website.

Edit translations manually

Every translated string can be edited by hand, marked as verified, retranslated or deleted, from the project's Translations screen. Machine translation gives you the first version. This is where you fix it.

Before you start

The Translations screen needs a paid plan. On a free project it shows an upgrade prompt instead of the editor, and revision history is unavailable there too.

Roles split three ways:

Role What they can do here
Owner, Admin everything: edit, retranslate, verify, unverify, delete
Editor edit and retranslate. The verify and delete buttons are not shown
Member read only

Strings appear here only after a page has been translated at least once, since that is when the text is extracted.

Find the string

  1. Open the project and choose Translations in the sidebar.
  2. Open Filter and pick a language, a status, or type a search term.
  3. Or open Pages and pick a single page to work through.

Everything that narrows the list lives in those two buttons, and whatever you have applied shows as chips to their left, each with a cross to remove it.

Filter holds four things, in this order:

Field Notes
Search Matches source or translation. Needs at least 2 characters
Language Always exactly one. It cannot be cleared, and Clear all leaves it alone
Status Translated, Missing, Unreviewed, Verified, Unchanged
Page Opens the same Pages list, so either route gets you there

The filter drawer applies when it closes, including when you dismiss it with Escape or by clicking outside. There is no cancel. Clear all is the only exit that discards what you were setting.

Status defaults to Translated, which shows strings that already have a translation in the chosen language. Untranslated strings are under Missing, not in the default view. That catches people out, so it is worth knowing before you conclude a string is absent. Every state and what puts a string in it is in Translation states.

Pages lists the pages strings were found on with a count each, so you can work through one page at a time instead of the whole site. The list is loaded when you open the drawer.

Edit it

Editing is inline. Click the translation text on the row, change it, then click away or press Cmd/Ctrl+Enter to save. Escape discards the edit. There is no separate edit button and no Save button.

Your version replaces the machine translation on the next page load, and saving marks the string Verified: your edit is the review, so there is no separate unreviewed-edit state.

If the string contains placeholders standing in for markup, keep each of them exactly once. Losing or duplicating one is refused with "This translation is missing or changed a placeholder and can't be saved", and your text stays in the field so you can fix it.

When a save does nothing

Three rules apply, and two of them fail quietly:

  • Placeholders must survive. If the source text carries formatting or inline markup, your translation has to keep the same placeholders. If it does not, the editor refuses the save and tells you so.
  • An empty edit is discarded, not saved. Clearing the field cancels the edit rather than blanking the translation. Use Delete translation for that.
  • Translations are limited to 10,000 characters. Anything longer is discarded without a message.

Mark a translation as verified

Mark as Verified records that someone has read the translation and is happy with it. It does not change the text, and it is the same status an edit of your own sets.

Use it to track progress: filter to Unreviewed, work down the list, and verify as you go. What is left is what still needs attention.

Mark as Unreviewed puts it back. Both buttons are Owner and Admin only.

Retranslate a string

Retranslate with AI on the row asks for a fresh machine translation. Use it when the source text changed, or when the original translation was poor and you would rather start from a new attempt than edit the old one. On a string with no translation yet the same button reads Translate with AI.

It replaces what is there, including your own edits, with no confirmation. Normal page translation never touches a string that already has a translation, so hand-edited text is safe from ordinary traffic. This button is the exception. If you click it by mistake, restore the previous version from History.

Revision history

The last 50 versions of each translation are kept, and older ones are dropped as new ones arrive. History on the row lists them with who made each change.

View diff on an entry highlights what changed since the version before it, and any earlier version can be restored.

This means editing is safe to experiment with: a wrong correction is one restore away.

Delete a translation

Delete translation on the row removes the translation for that string and language, and leaves the string itself in place. The next visitor request translates it again from scratch, so use this when a translation is wrong in a way that editing will not fix.

Deleting several at once is a different operation with different consequences. See Bulk actions and What deleting removes.

What you cannot do

There is no bulk import or export. Translations cannot be downloaded as a file, edited offline, and uploaded back. See Import and export translations for what to do instead.

Was this helpful?