---
title: "system.util.setLocale"
description: "Sets the user's current Locale."
---

# system.util.setLocale

> Sets the user's current Locale.

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

## Description
Sets the user's current Locale. Any valid Java locale code (case-insensitive) can be used as a parameter, including ones that have not yet been added to the Translation Manager. An invalid locale code will cause an Illegal Argument Exception.

## 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
`system.util.setLocale(locale)`

### Parameters
Type | Parameter | Description 
------- | ------- | ------
Object | `locale` |  A locale code, such as "en_US" for US English, or a java.util.Locale object.

### Returns
Nothing

### Scope
Vision Client

## Code Examples
```python title="Example #1"
# This script will set the client locale to Arabic.
  
system.util.setLocale('ar')
```