Skip to content

Custom Placeholders

Custom Placeholders are designed for cases when the source texts contain some less common placeholders that are not highlighted in the source strings (in the Editor) by default.

Configure your Custom Placeholders

You can manage Custom Placeholders in the Organization Settings.

  1. Click on your profile picture in the upper-right corner and select Organization Settings. Organization Settings
  2. Switch to the Custom placeholders section on the left sidebar and click Add Placeholder.
  3. In the appeared dialog, specify a custom placeholder expression using the Expressions syntax elements and click Create. Custom Placeholder Expression

Once the custom placeholders are assigned to the project, project members will see them highlighted in the Editor during the translation process.

Custom placeholders syntax elements

To configure your custom placeholder expression, you can use the elements from the expression syntax table.

For example, if you’d like to highlight this [[Placeholder1]], your expression might look like this:

start, then "[[", range "a,z,A,Z,0,9", limit "1,20", then "]]", end

To simplify things a bit, let’s deconstruct the expression above.

  • start – indicates the beginning of the expression.
  • then "[[" – means that your custom placeholder starts with two opening square brackets.
  • range "a,z,A,Z,0,9" – means that your custom placeholder might include characters ranging a-z and/or A-Z and/or 0-9.
  • limit "1,20" – means that the length of the placeholder is from 1 to 20 characters.
  • then "]]" – means that your custom placeholder ends with two closing square brackets.
  • end – indicates the end of the expression.

Custom Placeholder expression examples

Below you can see a few examples of custom placeholder expression and how they will be highlighted in source strings in the Editor.

Custom placeholder enclosed in percent characters and curly brackets

String example:

A test string with a custom %{placeholder}%

Expression:

start, maybe "(", then "%", then "{", anything, then "}", maybe ")", then "%", end
Custom placeholder enclosed in double square brackets

String example:

A test string with a custom [[placeholder]]

Expression:

start, then "[[", anythingbut "[[", then "]]", multiple, end
Custom placeholder

String example:

A test string with a custom placeholder

Expression:

start, then "placeholder", end
Custom placeholder enclosed in paragraph characters

String example:

A test string with a custom §placeholder§

Expression:

start, then "§", anything, then "§", end
Long sentence that you might want to highlight as a single custom placeholder

String example:

A test string with a Long sentence that you might want to highlight as a single custom placeholder

Expression:

start, then "Long sentence that you might want to highlight as a single custom placeholder"
Was this page helpful?