---
title: "system.i18n.translate"
description: "Translates a list of terms in bulk."
---

# system.i18n.translate

> Translates a list of terms in bulk.

This function is used in **Python Scripting**.

## Description

Translates a list of terms in bulk using the [Translation Manager](platform/localization-and-languages/localization-and-languages.md#translation-manager). To translate a single term, see [system.util.translate](appendix/scripting-functions/system-util/system-util-translate.md).

## Client Permission Restrictions

This scripting function has no [Client Permission](ignition-modules/vision/vision-project-properties/vision-project-properties.md#vision-permissions-properties) restrictions.

## Syntax

:::tip
This function accepts [keyword arguments](platform/scripting/python-scripting/user-defined-functions.md#keyword-arguments).
:::

`system.i18n.translate(terms, [locale], [strict])`

### Parameters

| Type | Parameter | Description |
|---|---|---|
| List | `terms` | The terms to translate. |
| Locale or String | `locale` | The locale to translate the terms to, such as `"it"` or `"en-IE"`. Accepts a Java Locale object, a [BCP-47 language tag](platform/localization-and-languages/locale-formats/locale-formats.md), or a Java locale identifier. If omitted, the function attempts to use the default locale of the current context, such as the Perspective Session or the Gateway. [optional] |
| Boolean | `strict` | If True, a term without a defined translation returns None. If False, the original term is returned. [optional] |

### Returns

**List** - The translated terms.

### Scope

Gateway, Vision Client, Perspective Session

## Code Examples

```python title="Code Snippet"
# Translate several terms to Italian in a single call.
terms = ["Hello", "Goodbye", "Tank"]
translations = system.i18n.translate(terms, locale="it")

print translations
```

```python title="Code Snippet - Strict Mode"
# With strict=True, any term without an Italian translation is returned as None.
translations = system.i18n.translate(["Hello", "Untranslated Term"], strict=True, locale="it")

print translations
```