---
title: "translate key · RUAL Documentation"
description: "Translates a given key."
canonical: https://docs.rual.nl/block-types/translations/value_translate_key
language: en
---

# translate key

This block is part of the [`translations`](https://docs.rual.nl/block-types/translations) group and was last modified in core [`v10.4.28`](https://docs.rual.nl/core-versions/100428).

Translates a given key.

- language `value`

- translation `value`

Translates the STATIC key configured on the block (not a pin), trimmed and lowercased. Language priority: language pin, then the request's language, then the entity default, with a retry in the entity's fallback language; an untranslated key outputs the key itself. {{bp-name}} placeholders inside the resolved translation are replaced with the matching template-name in-pin values; a missing pin renders as "".

[translate key](https://docs.rual.nl/block-types/translations/value_translate_key) outputs the translation of the key set on the block, for the language on its pin. The translation feeds a [custom text](https://docs.rual.nl/block-types/state ui/state_text) element inside a [paragraph](https://docs.rual.nl/block-types/state ui/state_p), which is how multilingual pages are built.

![Studio canvas example for the translate key block: translated text on the page.](https://docs.rual.nl/canvas-examples/value_translate_key.png)

### Commonly used with

In production blueprints, this block is most often wired together with:

- [custom text](https://docs.rual.nl/block-types/state%20ui/state_text): this block feeds into it.

- [hyperlink](https://docs.rual.nl/block-types/state%20ui/state_a): this block feeds into it. A anchor element, that can be used to create an link to an intern/extern page.

- [h3](https://docs.rual.nl/block-types/state%20ui/state_h3): this block feeds into it. A H3 element.

- [render](https://docs.rual.nl/block-types/state%20ui/state_render_page): this block feeds into it. Sends the combined HTML to the frontend and renders the page into React components.

- [label](https://docs.rual.nl/block-types/state%20ui/state_label): this block feeds into it. Represents a caption for an item in a user interface.

- [h1](https://docs.rual.nl/block-types/state%20ui/state_h1): this block feeds into it. A H1 element.

### Version history

Introduced in [`v10.4.28`](https://docs.rual.nl/core-versions/100428).