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

# Uri.external ViewHelper `<f:uri.external>`

ViewHelper for creating URIs to external targets, enforcing a specific scheme (https by default). The specified URI is passed through without further resolving or transformation.

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

**Table of contents**

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

## Examples

### Default

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

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

**Output**

```text
https://www.typo3.org
```

### Custom default scheme

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

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

**Output**

```text
ftp://typo3.org
```

## Arguments of the `<f:uri.external>` ViewHelper

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

    target URI