---
title: "Deprecation: #87200 - EmailFinisher \"format\" option"
manual: "TYPO3 Core Changelog"
version: "main"
permalink: "https://docs.typo3.org/permalink/changelog:deprecation-87200"
source: "Changelog/10.0/Deprecation-87200-EmailFinisherFormatOption.rst"
modified: "2026-09-15T10:46:36+00:00"
---

# Deprecation: #87200 - EmailFinisher "format" option

See [forge#87200](https://forge.typo3.org/issues/87200)

## Description

The `format` option of the `\TYPO3\CMS\Form\Domain\Finishers\EmailFinisher` has been marked as deprecated and
will be removed in TYPO3 11.0. It is replaced by the new `addHtmlPart` option which can be used to disable HTML
and enforce plaintext-only mails. If set, mails will contain a plaintext and HTML part, otherwise only a plaintext part.

If the `format` option is used, its value will be automatically migrated to `addHtmlPart`:

-   `format: html` becomes `addHtmlPart: true`
-   `format: plaintext` becomes `addHtmlPart: false`
-   a missing `format` becomes `addHtmlPart: true`

Opening and saving a form with the form editor once also performs this migration and makes it permanent.

## Impact

The `format` option will no longer work in TYPO3 11.0.

## Affected Installations

All installations which use EXT:form and its `\TYPO3\CMS\Form\Domain\Finishers\EmailFinisher`.

## Migration

Replace `format: html` with `addHtmlPart: true`.

Replace `format: plaintext` with `addHtmlPart: false`.
