Placeholders in the Editor

Placeholders are variables that are supposed to replace certain text content, for example: names, numbers, dates, images, etc. Placeholders are also often used when localizing software, games and websites. You can easily copy placeholders from the source text to the translation when working on a text, and the system will alert you if you forget one. 

By default,  placeholders can be marked up while uploading HTML, JSON, MQXLIFF, PHP, PO, STRINGS, TJSON, XLSX, XML localization files or while uploading RESX or INC files. Placeholders can also be used in bilingual files (TTX, XLF, XLIFF, SDLXLIFF).

Since placeholders replace text, numerals, and other items, in most cases they must be copied to the translation. If placeholders in the Source and Target do not match, the system will warn of an error.

Inserting placeholders using hotkeys

To insert a placeholder, click on the target text where the placeholder should be, and press Ctrl+Alt and the placeholder number: Ctrl+Alt+1, Ctrl+Alt+2, etc.

You can also press the  button that will appear in your toolbar if the segment contains a placeholder or Ctrl+Q. If a segment contains multiple placeholders, they will be inserted in the same order as they appear in the Source.

Inserting placeholders using the mouse

To insert a placeholder, place your cursor in the target text where the placeholder should be, and then click on the placeholder icon in the Source:


Adding custom placeholders

You can add your own placeholder formats on the Placeholders tab that can be accessed from the Settings menu. Placeholders are applied one after another starting from the uppermost.


By the way, you can test placeholders via this tool.

Please note that placeholder settings are valid for the whole account, that is, for every project within. So if you need different placeholders for different projects, we strongly advise you against restarting markup or refreshing project files after you change your placeholder settings or their order.

Placeholder markup

To apply placeholders to a particular file during project creation, click its name in the Documents section after upload. The Settings menu will appear on the right.

Click the Use placeholders to import variables checkbox.


Note: you have to choose settings separately for each file.

Once project creation is completed, placeholder markup will be applied to the selected files.

You can also apply placeholder markup after you have created the project.

To do this, go to the project page and hit the Mark Up Placeholders button. This button also allows you to refresh placeholder markup after you add/remove placeholders or change their order in the settings.


Please note that if placeholders were added to already confirmed segments after markup refresh, these segments will no longer be confirmed since a missing placeholder is a critical error.

If you want to utilize placeholders for Office formats or some others, please contact us at

Was this helpful?


Similar articles:

    No related articles