---
title: "Icon ViewHelper <core:icon>"
manual: "Fluid ViewHelper Reference"
version: "main"
permalink: "https://docs.typo3.org/permalink/t3viewhelper:typo3-core-icon@main"
source: "Core/Icon.rst"
rendered: "2026-09-27T06:54:49+00:00"
---

# Icon ViewHelper `<core:icon>` {#typo3-core-icon}

> [!NOTE]
> This ViewHelper is not available by default.
>
> [Import its namespace](https://docs.typo3.org/m/typo3/reference-coreapi/main/en-us/ApiOverview/Fluid/UsingFluidInTypo3.html#fluid-syntax-viewhelpers-import-namespaces)
> `{namespace core=TYPO3\CMS\Core\ViewHelpers\}` in the Fluid file or
> `xmlns:core="http://typo3.org/ns/TYPO3/CMS/Core/ViewHelpers/"` in the opening HTML tag.

ViewHelper to display an icon identified by its icon identifier.

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

## Arguments of the `<core:icon>` ViewHelper {#typo3-core-icon-arguments}

-   **alternativeMarkupIdentifier**

    -   *Type:* string

    Alternative icon identifier. Takes precedence over the identifier if supported by the IconProvider.

-   **identifier**

    -   *Type:* string
    -   *Required:* true

    Identifier of the icon as registered in the Icon Registry.

-   **overlay**

    -   *Type:* string

    Identifier of an overlay icon as registered in the Icon Registry.

-   **size**

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

    Desired size of the icon. All values of the IconSize enum are allowed, these are: "small", "default", "medium", "large" and "mega".

-   **state**

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

    Sets the state of the icon. All values of the Icons.states enum are allowed, these are: "default" and "disabled".

-   **title**

    -   *Type:* string

    Title for the icon