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

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

ViewHelper for creating links to external targets.

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

**Table of contents**

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

## Examples

### Default

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

```html
<f:link.external uri="https://www.typo3.org" target="_blank">external link</f:link.external>
```

**Output**

```html
<a href="https://www.typo3.org" target="_blank">external link</a>
```

### Custom default scheme

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

```html
<f:link.external uri="typo3.org" defaultScheme="ftp">external ftp link</f:link.external>
```

**Output**

```html
<a href="ftp://typo3.org">external ftp link</a>
```

## Arguments of the `<f:link.external>` 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.

-   **data**

    -   *Type:* array

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

-   **defaultScheme**

    -   *Type:* string
    -   *Default:* 'https'

    Scheme the href attribute will be prefixed with if specified $uri does not contain a scheme already

-   **uri**

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

    The URI that will be put in the href attribute of the rendered link tag