---
title: "Link.email ViewHelper <f:link.email>"
manual: "Fluid ViewHelper Reference"
version: "14.3"
permalink: "https://docs.typo3.org/permalink/t3viewhelper:typo3-fluid-link-email@14.3"
source: "Global/Link/Email.rst"
rendered: "2026-10-01T16:43:06+00:00"
---

# Link.email ViewHelper `<f:link.email>` {#typo3-fluid-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@14.3)
-   [Arguments of the <f:link.email> ViewHelper](https://docs.typo3.org/permalink/t3viewhelper:arguments-of-the-f-link-email-viewhelper@14.3)

## Examples {#typo3-fluid-link-email-example}

### Basic email link {#typo3-fluid-link-email-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 setting.

### Email link with custom linktext {#typo3-fluid-link-email-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 {#typo3-fluid-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 setting.

## Arguments of the `<f:link.email>` ViewHelper {#typo3-fluid-link-email-arguments}

> **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