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

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

ViewHelper for creating links to Extbase actions. Tailored for Extbase plugins, uses Extbase Request and Extbase UriBuilder.

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

**Table of contents**

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

## Examples

Link to the show-action of the current controller:

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

```html
<f:link.action action="show">action link</f:link.action>
```

**Output**

```html
<a href="index.php?id=123&tx_myextension_plugin[action]=show&tx_myextension_plugin[controller]=Standard&cHash=xyz">action link</a>
```

Depending on the current page and your TypoScript configuration.

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

-   **absolute**

    -   *Type:* bool
    -   *Default:* false

    If set, the URI of the rendered link is absolute

-   **action**

    -   *Type:* string

    Target action

-   **addQueryString**

    -   *Type:* string
    -   *Default:* false

    If set, the current query parameters will be kept in the URL. If set to "untrusted", then ALL query parameters will be added. Be aware, that this might lead to problems when the generated link is cached.

-   **additionalAttributes**

    -   *Type:* array

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

-   **additionalParams**

    -   *Type:* array
    -   *Default:* array (
    )

    Additional query parameters that won't be prefixed like $arguments (overrule $arguments)

-   **arguments**

    -   *Type:* array
    -   *Default:* array (
    )

    Arguments for the controller action, associative array (do not use reserved keywords "action", "controller" or "format" if not referring to these internal variables specifically)

-   **argumentsToBeExcludedFromQueryString**

    -   *Type:* array
    -   *Default:* array (
    )

    Arguments to be removed from the URI. Only active if $addQueryString = true

-   **aria**

    -   *Type:* array

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

-   **controller**

    -   *Type:* string

    Target controller. If NULL current controllerName is used

-   **data**

    -   *Type:* array

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

-   **extensionName**

    -   *Type:* string

    Target Extension Name (without \`tx\_\` prefix and no underscores). If NULL the current extension name is used

-   **format**

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

    The requested format, e.g. ".html

-   **language**

    -   *Type:* string

    link to a specific language - defaults to the current language, use a language ID or "current" to enforce a specific language

-   **linkAccessRestrictedPages**

    -   *Type:* bool
    -   *Default:* false

    If set, links pointing to access restricted pages will still link to the page even though the page cannot be accessed.

-   **noCache**

    -   *Type:* bool

    Set this to disable caching for the target page. You should not need this.

-   **pageType**

    -   *Type:* int
    -   *Default:* 0

    Type of the target page. See typolink.parameter

-   **pageUid**

    -   *Type:* int

    Target page. See TypoLink destination

-   **pluginName**

    -   *Type:* string

    Target plugin. If empty, the current plugin name is used

-   **section**

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

    The anchor to be added to the URI