---
title: "Link.email ViewHelper <f:link.email>"
manual: "Fluid ViewHelper Reference"
version: "main"
permalink: "https://docs.typo3.org/permalink/t3viewhelper:typo3-fluid-link-email@main"
source: "Global/Link/Email.rst"
modified: "2026-09-17T05:12:06+00:00"
---

# Link.email ViewHelper `<f:link.email>`

ViewHelper to generate an email link (`mailto:`), respecting TYPO3s `spamProtectEmailAddresses` TypoScript setting.

Go to the source code of this ViewHelper: [Link\\EmailViewHelper.php (GitHub)](https://github.com/TYPO3/typo3/blob/main/typo3/sysext/fluid/Classes/ViewHelpers/Link/EmailViewHelper.php).

**Table of contents**

-   [Examples](https://docs.typo3.org/permalink/t3viewhelper:examples@main)
-   [Arguments of the <f:link.email> ViewHelper](https://docs.typo3.org/permalink/t3viewhelper:arguments-of-the-f-link-email-viewhelper@main)

## Examples

### Basic email link

**packages/my_extension/Resources/Private/Templates/Blog/Show.fluid.html**

```html
<f:link.email email="foo@bar.tld" />
```

**Output**

```html
<a href="#" data-mailto-token="ocknvq,hqqBdct0vnf" data-mailto-vector="1">foo(at)bar.tld</a>
```

Depending on [spamProtectEmailAddresses](https://docs.typo3.org/m/typo3/reference-typoscript/main/en-us/TopLevelObjects/Config.html#confval-config-spamprotectemailaddresses) setting.

### Email link with custom linktext

**packages/my_extension/Resources/Private/Templates/Blog/Show.fluid.html**

```html
<f:link.email email="foo@bar.tld">some custom content</f:link.email>
```

### Email link with custom subject and prefilled cc

**packages/my_extension/Resources/Private/Templates/Blog/Show.fluid.html**

```html
<f:link.email email="foo@bar.tld" subject="Check out this website" cc="foo@example.com">some custom content</f:link.email>
```

**Output**

```html
<a href="mailto:foo@bar.tld?subject=Check%20out%20this%20website&amp;cc=foo%40example.com">some custom content</a>
```

Depending on [spamProtectEmailAddresses](https://docs.typo3.org/m/typo3/reference-typoscript/main/en-us/TopLevelObjects/Config.html#confval-config-spamprotectemailaddresses) setting.

## Arguments of the `<f:link.email>` ViewHelper

> **Allows arbitrary arguments**
>
> This ViewHelper allows you to pass arbitrary arguments not defined below
> directly to the HTML tag created. This includes custom `data-` arguments.

-   **additionalAttributes**

    -   *Type:* array

    Additional tag attributes. They will be added directly to the resulting HTML tag.

-   **aria**

    -   *Type:* array

    Additional aria-\* attributes. They will each be added with a "aria-" prefix.

-   **bcc**

    -   *Type:* string

    The email address(es) for BCC of the email link

-   **body**

    -   *Type:* string

    A prefilled body for the email link

-   **cc**

    -   *Type:* string

    The email address(es) for CC of the email link

-   **data**

    -   *Type:* array

    Additional data-\* attributes. They will each be added with a "data-" prefix.

-   **email**

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

    The email address to be turned into a link

-   **subject**

    -   *Type:* string

    A prefilled subject for the email link