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

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

ViewHelper for creating links to a file (FAL).

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

**Table of contents**

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

## Examples

### Link to a file

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

```html
<f:link.file file="{file}" target="_blank">See file</f:link.file>
```

**Output of a public file**

```html
<a href="https://example.com/fileadmin/path/to/file.jpg" target="_blank">See file</a>
```

**Output of a non-public file**

```html
<a href="https://example.com/index.php?eID=dumpFile&t=f&f=123&token=79bce812" target="_blank">See file</a>
```

### Link to download a file

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

```html
<f:link.file file="{file}" download="true" filename="alternative-name.jpg">Download file</f:link.file>
```

**Output of a public file**

```html
<a href="https://example.com/fileadmin/path/to/file.jpg" download="alternative-name.jpg">Download file</a>
```

**Output of a non-public file**

```html
<a href="https://example.com/index.php?eID=dumpFile&t=f&f=123&dl=1&fn=alternative-name.jpg&token=79bce812">Download file</a>
```

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

-   **download**

    -   *Type:* bool

    Specifies if file should be downloaded instead of displayed

-   **file**

    -   *Type:* TYPO3\\CMS\\Core\\Resource\\FileInterface
    -   *Required:* true

    Specifies the file to create a link to

-   **filename**

    -   *Type:* string

    Specifies an alternative filename. If filename contains a file extension, this must be the same as from 'file'.