---
title: "Extension Configuration"
manual: "DeepL Translate (CORE)"
version: "main"
permalink: "https://docs.typo3.org/permalink/web-vision/deepltranslate-core:extensionconfiguration@main"
source: "Reference/ExtensionConfiguration/Index.rst"
rendered: "2026-10-06T14:40:53+00:00"
---

# Extension Configuration {#extensionconfiguration}

Some general settings can be configured in the Extension Configuration.

1.  Go to **System > Settings > Extension Configuration**
1.  Choose **deepltranslate_core**

The settings are divided into several tabs and described here in detail:

**Properties**

-   [Settings](https://docs.typo3.org/permalink/web-vision/deepltranslate-core:settings@main)
-   [API](https://docs.typo3.org/permalink/web-vision/deepltranslate-core:api@main)

## Settings {#deeplapikey}

Tab **Settings** provides basic extension settings required for minimal
operational state.

![Screenshot of :guilabel:\`Extension Configuration > deepltranslate_core > Settings\`](../../Images/Reference/configuration-settings.png)

-   **apiKey**

    -   *Type:* string
    -   *Required:* true

    Add your DeepL API Key here, either [DeepL Free API](https://www.deepl.com/pro-checkout/account?productId=1200&yearly=false&trial=false) or [DeepL Pro](https://www.deepl.com/de/pro).

## API {#api}

Tab **API** provides the ability to set default settings used for DeepL API.
requests.

> [!NOTE]
> Options have been added in preparation for upcoming **Glossary API v3**
> usage in **deepltranslate_glossary** and also in **deepltranslate_core**,
> but have not been implemented yet. They are not used yet.

![Screenshot of :guilabel:\`Extension Configuration > deepltranslate_core > API\`](../../Images/Reference/configuration-api.png)

-   **modelType**

    -   *Type:* string
    -   *Default:* `prefer_quality_optimized`: Prefer quality optimized (with fallback)

    DeepL model, available options:

    -   `latency_optimized`: Latency optimized
    -   `quality_optimized`: Quality optimized
    -   `prefer_quality_optimized` Prefer quality optimized (with fallback)

-   **splitSentences**

    -   *Type:* string
    -   *Default:* `on`: Split at punctuation and newlines

    Enable Text splitting, available options:

    -   `off`: No splitting
    -   `on`: Split at punctuation and newlines
    -   `nonewlines`: Split only at new lines

-   **preserveFormatting**

    -   *Type:* bool
    -   *Default:* `false`

    Keep existing formatting

-   **ignoreTags**

    -   *Type:* string

    Exclude content from being translated in between these tags; Comma separated, useful for
    available options:

    -   `placeholders`
    -   `shortcodes`
    -   `pre`

    For example: `shortcodes,pre`

-   **nonSplittingTags**

    -   *Type:* string

    Only for tag_handling XML! Prevent splitting inside these tags. Comma
    separated, allows the API keeping the text unsplitted.

-   **splittingTags**

    -   *Type:* string

    Split inside these tags. Comma separated list, defines tags that should be
    splitted, for example: `p,div`

-   **outlineDetection**

    -   *Type:* bool
    -   *Default:* `true`

    Enable automatic detection of document structure in XML/HTML