This feature is currently in beta. It is available on Start plan and above.

Introduction

Automations allow you to define custom actions that have to be performed automatically whenever translation value for the chosen language is being changed via UI, API, or integrations. For example, you may create a rule that will provide machine translations for the French language whenever English translations are modified.

Automations is a new feature that supersedes language auto-fill rules.

Getting started

To get started with automations, open your project, click More > Settings and proceed to the Automations tab. Click Create to add a new automation.

Quotas

The number of available automations depends on your subscription plan. Automations are counted across all team projects and each language pair is counted as a separate automation.

The number of characters you can translate using machine translation is also limited and displayed in the top right corner of the automations page (check the screenshot above). The MT characters limit counter resets on the first calendar day of every month.

If you exceed the given automation limits then automations are disabled and are no longer triggered. Machine translations also won't be run if the MT character limit is exceeded.

Subscription plan

Available automations

MT character limits

Free

0

0

Legacy

10

10,000

Trial

150

10,000

Start

25

250,000

Essential

50

500,000

Pro

100

1,000,000

Enterprise

Custom (start at 150)

Custom (starting at 1,500,000)

Extra 25 automations for $50/mo or $480/year

Extra 1,000,000 MT chars for $30/mo or $288/year

Please contact our support to learn more

Creating automation

Automation options

After clicking Create, you will see the following screen:

Let's discuss the available options:

  • Monitor for changes — select a language that you would like to monitor. Whenever this language is changed (find detailed information on trigger conditions below), certain actions will be applied to the automated languages.
  • Automated languages — choose one or more project languages to apply automations to. You may also select "All project languages". In this case, all newly added languages will also be automated, and the number of available automations will be re-calculated.
  • Minimal change required — possible values range from 0% to 100%. This setting provides the minimal monitored language change required to trigger the automation.
  • Allow cascade triggering — when enabled, the current automation can be triggered by other automations. For example, suppose you've created a rule to monitor English language and apply TM to Russian translations. You also have another rule to monitor Russian language and use machine translation for French language. If cascade triggering is allowed for the second rule, then the corresponding action will be run whenever Russian translations are modified by the action from the first rule.
  • Actions — provide an actions sequence that should be applied to the target languages. Next action in the sequence will only be attempted if the previous one failed or is not applicable. To remove an action, click on the small "cancel" icon next to the action (in the top right corner).

When you are ready, click Save changes or Add another rule to provide another automation.

Available actions

The following automation actions are available:

  • Insert monitored language translation — copy the monitored translation language value into the automated languages values.
  • Apply translation memory — try to use translation memory entries to perform translation. You will also need to provide a value for the translation memory threshold.
  • Use machine translation — employ MT to perform translation. You'll need to choose a translation provider: Google Translate or DeepL.
  • Pseudolocalize — apply pseudolocalization to the automated languages. You can also increase translation length by entering a percentage number.
  • Change translation status — modify translation status for the automated languages (see the common action options below).

Common action options

The following options are common for all actions:

  • Force this action — the chosen action will be forcefully applied even if the target language translation is not empty. By default, automations are applied only to empty translation values; if the value is not empty, it will be skipped.
  • Clear statuses — unassign all statuses from the translation value before applying new ones.
  • Mark as Unverified — when enabled, the translation value will be marked as unverified.

Global automation options

  • Auto-toggle Unverified — if you update base language translations, Lokalise will automatically toggle other language translations as Unverified. This action is performed before automations. Please note that previously this option was found in the Project settings but we've moved it under Automations now.

Automation mechanics

Actions logic

If you have specified multiple actions for the same automation (for example, "Apply translation memory" and "Use machine translation") then only a single action will be performed. First the automation will try to apply TM to the chosen languages, and only if this operation fails then it will try to use machine translation. If the first action succeeds, however, the second one will be ignored.

Also remember that by default automations are applied only to empty values. To override this behavior, enable the Force this action option.

Action triggers

Automations get triggered after certain operation had happened:

  • Find and replace — never triggers
  • API v1 — never triggers
  • API v2:
    - Update a translation — always triggers
    - Upload a file, create a key, update a key — triggers only if the use_automations parameter is enabled (off by default)
  • UI:
    - File import, key add — triggers only if the corresponding checkbox is enabled (see below)
    - Offline XLIFF — always triggers
    - Spellcheck replace term — always triggers
  • Bulk:
    - Copy keys, clear translations, restore history, pseudolocalize — never triggers
    - Fill with key name, fill with text, source to target. apply TM — triggers only if the corresponding checkbox is enabled
  • Language settings (change plural forms) — never triggers
  • File import via Git integrations — triggers only if the corresponding checkbox is enabled
  • Content integrations (Contentful, WordPress, Zendesk Guide, Intercom Articles) — always triggers
  • Design integrations (Figma, Adobe XD, Sketch) — always triggers
  • Link keys, merge keys — never triggers
  • Translation image set — never triggers
  • Translation editor, in-context editor — always triggers
  • Branch merging — never triggers
  • Machine translation orders — never triggers
  • Gengo orders — always triggers

Language permissions and statuses

  • If the contributor is making changes to a monitored language, the automation will be triggered even if this contributor has no permissions for the target language. As an example, suppose you have an automation monitoring English language. Whenever a change is made, machine translation should be used to populate French. Ann is a contributor who has read/write access to English language. She, however, has no permission to view or modify French. Still, if Ann modifies English, the automation will trigger and MT will be used to provide French translations.
  • If Contributing within tasks only option is enabled in the project settings, automations will still propagate to the locked languages.
  • Only unlocked translations trigger automations. In other words, if some translation is locked because it was included in an order or a task, it should not trigger an automation.

Using automations during key creation

By default, automations won't be run during the key creation. To enable them, tick the Automations checkbox:

Using automations during file import

By default, automations won't be run during the file import. To enable them, tick the Automations checkbox:

Did this answer your question?