Radical Design Course by Jack McDade

From the creator of Statamic

Learn how to make your websites standout and be remembered.

Taking your approach on designing things actually makes it fun, more natural, and overall easier.

— Dominik, Developer

User:Is Tag

Anything inside the user:is tag will only be rendered if the user has a specific role.

Overview

User tags are designed for sites that have areas or features behind a login. The user:is tag is used to check if the currently logged in user has a one or more specific roles.

Example

We want to show some content on a page especially for authors.

{{ user:is role="author" }}
<div class="markdown">
{{ content }}
</div>
{{ /user:is }}
{{-- Using Antlers Blade Components --}}
<s:user:is role="author">
<div class="markdown">
{{ $content }}
</div>
</s:user:is>
 
{{-- Using Fluent Tags --}}
@if (Statamic::tag('user:is')->role('author')->fetch())
...
@endif

Isn't

We also support the negative use case using user:isnt tags.

{{ user:isnt role="author" }}
<a href="/apply">Apply to be an author!</a>
{{ /user:isnt }}
{{-- Using Antlers Blade Components --}}
<s:user:isnt role="author">
<a href="/apply">Apply to be an author!</a>
</s:user:isnt>
 
{{-- Using Fluent Tags --}}
@if (Statamic::tag('user:isnt')->role('author')->fetch())
...
@endif

Super Users

While super users have permission to do everything, they do not automatically inherit all roles. Keep this in mind when testing your template logic.

Parameters

role|roles

string

The role(s) to check against. You may specify multiple roles by pipe separating them: {{ user:is roles="writer|editor" }}.

Docs feedback

Submit improvements, related content, or suggestions through Github.

Betterify this page →
Hello there! Are you looking for the Statamic v2 documentation?