# Icons

Using the Advanced Editor, you can easily bring in any [Font Awesome icon](https://fontawesome.com/v4/icons/) to decorate your elements.

![elements with icons to show element type](/files/3zkXH29JexwGQSIbsWTw)

To get started, add a new block of code. You can use any element [selector](/guides/selectors.md) to open the block, then use the icon property to specify which icon you’d like to bring in, and use the icon-color property to specify its color:

```scss
person {
  icon: user;
  icon-color: #444;
}
```

**Tip**: If you prefer to show just the icon instead of the element itself, set `color` to `transparent`;

```scss
organization {
  icon: building;
  icon-color: #444;
  color: transparent;
}
```

In the value for the `icon` property, you can also specify `solid` or `regular` to change the icon style:

```scss
organization {
  icon: building regular;
  icon-color: #444;
  color: transparent;
}
```

Note that, if you add icons to your elements, they will override any images you have added. If you'd like to add icons only for elements that don't have images, you can add this code to the bottom of your Advanced Editor:

```scss
// The element[image] selector tells Kumu to only apply these rules for elements with an image
element[image] {
  icon: off; // Setting 'icon' to 'off' will remove any icons you've added further up in the Advanced Editor
}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.kumu.io/guides/decorate/icons.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.