---
title: "Basic Usage"
manual: "DeepL Translate"
version: "5.1"
permalink: "https://docs.typo3.org/permalink/web-vision/deepltranslate-core:basic-usage@5.1"
source: "Editor/Usage/Index.rst"
rendered: "2026-11-16T10:59:37+00:00"
---

# Basic Usage {#basic-usage}

## Translating content elements {#translating-content-elements}

Once the extension is installed and the API key provided, we are ready to start
translating content elements. When translating a content element, there are four
additional options besides the normal translate and copy.

-   DeepL Translate (auto detect).
-   DeepL Translate.

![DeepL Options](../../Images/Editor/deepl.png)

## Translating a page {#translating-a-page}

*deepltranslate_core* adds a separate dropdown for DeepL translation of a page to
the list and web module. The dropdown is filtered to not translated pages and
against DeepL API possible translation languages.

![Dropdown for DeepL translation](../../Images/Editor/translation-dropdown.png)

## Translating a single element {#translating-a-single-element}

In list view, you are able to translate single elements by clicking the DeepL
translate button for the language you want.

![Translation buttons in list view](../../Images/Editor/translation-buttons-page.png)

Languages that are not available will have no DeepL button. In this case,
use normal translation.

![Translation button for tx_news, one language not available in DeepL](../../Images/Editor/translation-button-news.png)

> [!NOTE]
> Fields of custom extensions need to be properly
> [configured](https://docs.typo3.org/permalink/web-vision/deepltranslate-core:tableconfiguration@5.1) to enable translation.
