> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.itential.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.itential.com/_mcp/server.

# toLocaleLowerCase

> Use the toLocaleLowerCase task to convert a string to lowercase according to locale-specific case mappings.

The `toLocaleLowerCase` task converts a string value to lowercase according to locale-specific case mappings. The locale is based on the language settings of the browser. For most languages this task will function exactly like the `toLowerCase` task and produce the same output; however, certain languages may behave differently (for example, case mappings for Turkish do not follow the default case mappings in Unicode).

## Potential use case

Suppose you have a dataset in uppercase format and you want to display it in lowercase. You could use the `toLocaleLowerCase` task to convert the entire dataset to lowercase characters.

## Properties

| Incoming | Type   | Description                                                                                   |
| -------- | ------ | --------------------------------------------------------------------------------------------- |
| `str`    | String | Required. The string to convert to lowercase.                                                 |
| `locale` | String | The locale to be used to convert to lowercase according to any locale-specific case mappings. |

| Outgoing          | Type   | Description                                                                                           |
| ----------------- | ------ | ----------------------------------------------------------------------------------------------------- |
| `lowercaseString` | String | A new string representing the incoming string converted to lowercase according to the current locale. |

## Example

In this example, the `str` is given a reference variable of "HELLO WORLD" in all caps. The `locale` would only be populated if it were a language such as Turkish, which needs specific letters to be capitalized for meaning.

![](/_fern-img/cd61e11fc6c5308619e11c7eea8df5bdb211680bbdf050c83839c10c6c0851c4.webp)

The expected result is that all letters from the reference variable are now lowercase and appear as "hello world".

![](/_fern-img/0b232164ef78b83e9b9f59c4860dc5831d75fd86d67bf5c44db25c6fc78ad3f7.webp)

## Related reading

For more information on using the locales parameter, see [Intl on the MDN site](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl).