> ## Documentation Index
> Fetch the complete documentation index at: https://deepl-c950b784-docs-language-table-from-v3.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Translating HTML
> Learn how to translate HTML content with the DeepL API and exclude specific elements from translation.
To translate HTML content, set the `tag_handling` parameter to `html`. The API extracts the text from the HTML structure, translates it, and places the translation back into the structure. Without `tag_handling`, tags are treated as regular text.
Set `tag_handling_version` to `v2` to use the improved tag handling algorithm. HTML input is never strictly parsed, so invalid HTML doesn't cause errors in either version. For version details and defaults, see the [`tag_handling_version` parameter](/api-reference/translate/request-translation).
```bash Example request theme={null}
curl -X POST https://api.deepl.com/v2/translate \
--header "Content-Type: application/json" \
--header "Authorization: DeepL-Auth-Key $API_KEY" \
--data '{
"text": ["This is a premium feature.
"],
"target_lang": "DE",
"tag_handling": "html",
"tag_handling_version": "v2"
}'
```
```json Example response theme={null}
{
"translations": [
{
"detected_source_language": "EN",
"text": "Dies ist eine Premium-Funktion.
",
"tag_handling_version": "v2"
}
]
}
```
You don't need to set `split_sentences` for HTML: with `tag_handling=html` it defaults to `nonewlines`, which splits sentences on punctuation only and gives the best translation quality for HTML. To also split sentences on newlines, set `split_sentences=1`.
To translate non-HTML XML content, see [Translating XML](/docs/translate/translating-xml).
## Exclude elements from translation
To exclude an element from translation, add the `translate="no"` or `class="notranslate"` attribute to it. In the following example, `translate="no"` prevents translation of the paragraph:
```markup Example request theme={null}
My First Heading
My first paragraph.
```
```markup Example response theme={null}
Meine erste Überschrift
My first paragraph.
```