---
title: "Security.ifHasRole ViewHelper <f:security.ifHasRole>"
manual: "Fluid ViewHelper Reference"
version: "13.4"
permalink: "https://docs.typo3.org/permalink/t3viewhelper:typo3-fluid-security-ifhasrole@13.4"
source: "Global/Security/IfHasRole.rst"
modified: "2026-09-17T09:07:45+00:00"
---

# Security.ifHasRole ViewHelper `<f:security.ifHasRole>`

ViewHelper implementing an ifHasRole/else condition for frontend groups.

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

**Table of contents**

-   [Examples](https://docs.typo3.org/permalink/t3viewhelper:examples@13.4)
-   [Arguments of the <f:security.ifHasRole> ViewHelper](https://docs.typo3.org/permalink/t3viewhelper:arguments-of-the-f-security-ifhasrole-viewhelper@13.4)

## Examples

### Basic usage

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

```html
<f:security.ifHasRole role="Administrator">
  This is being shown in case the current FE user belongs to a FE usergroup (aka role) titled "Administrator" (case sensitive)
</f:security.ifHasRole>
```

Everything inside the `<f:security.ifHasRole>` tag is being displayed if the
logged in frontend user belongs to the specified frontend user group.
Comparison is done by comparing to title of the user groups.

### Using the usergroup uid as role identifier

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

```html
<f:security.ifHasRole role="1">
  This is being shown in case the current FE user belongs to a FE usergroup (aka role) with the uid "1"
</f:security.ifHasRole>
```

Everything inside the `<f:security.ifHasRole>` tag is being displayed if the
logged in frontend user belongs to the specified role. Comparison is done
using the `uid` of frontend user groups.

### IfRole / then / else

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

```html
<f:security.ifHasRole role="Administrator">
  <f:then>
    This is being shown in case you have the role.
  </f:then>
  <f:else>
    This is being displayed in case you do not have the role.
  </f:else>
</f:security.ifHasRole>
```

Everything inside the `<f:then></f:then>` tag is displayed if the logged in FE user belongs to the specified role.
Otherwise, everything inside the `<f:else></f:else>` tag is displayed.

## Arguments of the `<f:security.ifHasRole>` ViewHelper

-   **else**

    -   *Type:* mixed

    Value to be returned if the condition if not met.

-   **role**

    -   *Type:* string

    The usergroup (either the usergroup uid or its title).

-   **then**

    -   *Type:* mixed

    Value to be returned if the condition if met.