---
title: "Deprecation: #80420 - EmailFinisher single address options"
manual: "TYPO3 Core Changelog"
version: "main"
permalink: "https://docs.typo3.org/permalink/changelog:deprecation-80420"
source: "Changelog/10.0/Deprecation-80420-EmailFinisherSingleAddressOptions.rst"
typo3-version: "10.0"
typo3-major: 10
type: "deprecation"
issue: 80420
forge: "https://forge.typo3.org/issues/80420"
tags: ["YAML", "NotScanned", "ext:form"]
rendered: "2026-09-20T18:31:11+00:00"
---

# Deprecation: #80420 - EmailFinisher single address options {#deprecation-80420}

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

## Description {#description}

The `EmailFinisher` of EXT:form has options to set multiple recipients for `To`, `CC` and `BCC`.
For consistency reasons and to limit the number of choices, resulting in easier configuration, the single value configuration options
have will be removed in favour for their respective multi value variants.

For this reason, the following options have been marked as deprecated and will be removed in TYPO3 11.0:

-   `recipientAddress`
-   `recipientName`
-   `replyToAddress`
-   `carbonCopyAddress`
-   `blindCarbonCopyAddress`

If any of these options are used, their values will be automatically migrated to their replacements.

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

## Impact {#impact}

Any of these options will no longer work in TYPO3 11.0.

## Affected Installations {#affected-installations}

All installations which use EXT:form and its `EmailFinisher`.

## Migration {#migration}

All single value options must be migrated to their list value successors.

### Multiple Recipients {#multiple-recipients}

Change `recipientAddress` and `recipientName` to `recipients`.

Before:

```yaml
finishers:
  -
    identifier: EmailToReceiver
    options:
      recipientAddress: to@example.org
      recipientName: 'To Example'
```

After:

```yaml
finishers:
  -
    identifier: EmailToReceiver
    options:
      recipients:
        to@example.org: 'To Example'
```

### Multiple Reply-To Recipients {#multiple-reply-to-recipients}

Change `replyToAddress` to `replyToRecipients`. Additionally this allows for setting the name of a Reply-To recipient.

Before:

```yaml
finishers:
  -
    identifier: EmailToReceiver
    options:
      replyToAddress: rt@example.org
```

After:

```yaml
finishers:
  -
    identifier: EmailToReceiver
    options:
      replyToRecipients:
        rt@example.org@example.org: 'Reply-To Example'
```

### Multiple Carbon Copy (CC) Recipients {#multiple-carbon-copy-cc-recipients}

Change `carbonCopyAddress` to `carbonCopyRecipients`. Additionally this allows for setting the name of a CC recipient.

Before:

```yaml
finishers:
  -
    identifier: EmailToReceiver
    options:
      carbonCopyAddress: cc@example.org
```

After:

```yaml
finishers:
  -
    identifier: EmailToReceiver
    options:
      carbonCopyRecipients:
        cc@example.org: 'CC Example'
```

### Multiple Blind Carbon Copy (BCC) Recipients {#multiple-blind-carbon-copy-bcc-recipients}

Change `blindCarbonCopyAddress` to `blindCarbonCopyRecipients`. Additionally this allows for setting the name of a BCC recipient.

Before:

```yaml
finishers:
  -
    identifier: EmailToReceiver
    options:
      blindCarbonCopyAddress: bcc@example.org
```

After:

```yaml
finishers:
  -
    identifier: EmailToReceiver
    options:
      blindCarbonCopyRecipients:
        bcc@example.org: 'BCC Example'
```