> ## Documentation Index
> Fetch the complete documentation index at: https://doc.lucidworks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# widget:icon

export const LwTemplate = ({title = "Key questions to get you started", icon = "sparkles", cta = "Powered by Agent Studio", linkHref = "https://lucidworks.com/demo/?utm_source=docs&utm_medium=referral&utm_campaign=docs_cta_ai"}) => {
  const [isLoaded, setIsLoaded] = useState(false);
  useEffect(() => {
    const timer = setTimeout(() => {
      setIsLoaded(true);
    }, 500);
    return () => clearTimeout(timer);
  }, []);
  return <div className="lw-template-container">
      <Card title={title} icon={icon}>
        {isLoaded && <span dangerouslySetInnerHTML={{
    __html: `<lw-template id="a029c1a9-28be-427e-b0e1-5d918920246a"></lw-template
            >`
  }} />}
        <Link href={linkHref} className="agent-studio-link text-left text-gray-600 gap-2 dark:text-gray-400 text-sm font-medium flex flex-row items-center hover:text-primary dark:hover:text-primary-light group-hover:text-primary group-hover:dark:text-primary-light">Powered by Lucidworks Agent Studio</Link>
      </Card>
    </div>;
};

[localhost link]: http://localhost:3000/docs/4/app-studio/reference/tags/lightning.directive.widgetIcon

[mintlify link]: https://doc.lucidworks.com/docs/4/app-studio/reference/tags/lightning.directive.widgetIcon

[old doc.lw link]: https://doc.lucidworks.com/app-studio/4.2/1064

<LwTemplate />

## Description

Creates an icon

## Usage

as element:

```xml wrap  theme={"dark"}
<widget:icon
       icon="{string}">
</widget:icon>
```

#### Parameters

| Param | Type       | Details                          |
| ----- | ---------- | -------------------------------- |
| icon  | **string** | The name of the icon to display. |

## Example

#### Source

```xml wrap  expandable  theme={"dark"}
<layout:grid>
    <layout:block medium="1-3">
        <h3 id="example_icons">Icons</h3>
        <widget:icon icon="heart"></widget:icon> heart<br />
        <widget:icon icon="heart-empty"></widget:icon> heart-empty<br />
        <widget:icon icon="bookmark"></widget:icon> bookmark<br />
        <widget:icon icon="bookmark-empty"></widget:icon> bookmark-empty<br />
        <widget:icon icon="search"></widget:icon> search<br />
        <widget:icon icon="download-cloud"></widget:icon> download-cloud<br />
        <widget:icon icon="upload-cloud"></widget:icon> upload-cloud<br />
        <widget:icon icon="star"></widget:icon> star<br />
        <widget:icon icon="star-empty"></widget:icon> star-empty<br />
        <widget:icon icon="star-half"></widget:icon> star-half<br />
        <widget:icon icon="star-half-alt"></widget:icon> star-half-alt<br />
        <widget:icon icon="lock"></widget:icon> lock<br />
        <widget:icon icon="lock-open-alt"></widget:icon> lock-open-alt<br />
        <widget:icon icon="attention"></widget:icon> attention<br />
        <widget:icon icon="cog"></widget:icon> cog<br />
    </layout:block>
    <layout:block medium="1-3">
        <h3 id="example_styles">Styles</h3>
        <p>Tiny</p>
        <widget:icon icon="heart" style="tiny"></widget:icon> <br />
        <p>Small</p>
        <widget:icon icon="heart" style="small"></widget:icon> <br />
        <p>Large</p>
        <widget:icon icon="heart" style="large"></widget:icon> <br />
        <p>Huge</p>
        <widget:icon icon="heart" style="huge"></widget:icon> <br />
        <p>Massive</p>
        <widget:icon icon="heart" style="massive"></widget:icon> <br />
    </layout:block>
    <layout:block medium="1-3">
        <h3 id="example_colours">Colours</h3>
        <p>
            <widget:icon icon="heart" style="massive text-carrot"></widget:icon> Carrot
        </p>
        <p>
            <widget:icon icon="heart" style="massive text-sunflower"></widget:icon> Sunflower
        </p>
        <p>
            <widget:icon icon="heart" style="massive text-grass"></widget:icon> Grass
        </p>
        <p>
            <widget:icon icon="heart" style="massive text-mint"></widget:icon> Mint
        </p>
        <p>
            <widget:icon icon="heart" style="massive text-sky"></widget:icon> Sky
        </p>
        <p>
            <widget:icon icon="heart" style="massive text-lavender"></widget:icon> Lavender
        </p>
        <p>
            <widget:icon icon="heart" style="massive text-strawberry"></widget:icon> Strawberry
        </p>
    </layout:block>
</layout:grid>
```

#### Result

<img src="https://mintcdn.com/lucidworks/J_LymSfRoWq3UOvg/assets/images/app-studio/as-examples/tags/widgetIcon.png?fit=max&auto=format&n=J_LymSfRoWq3UOvg&q=85&s=85eba95279b380c17e1f475d17d9c9d9" alt="Result" width="1024" height="589" data-path="assets/images/app-studio/as-examples/tags/widgetIcon.png" />