Icon illustrations in Theme Builder

---
title: Icon illustrations in Theme Builder
description: Icons are used to visually represent actions and concepts through simple, themed graphics.
locale: en-US
canonical_url: https://www.servicenow.com/docs/r/platform-user-interface/tb-icon-illustrations.html
release: brazil
topic_type: concept
last_updated: "2026-09-10"
reading_time_minutes: 1
breadcrumb: [Image styles, Manage or edit a theme, Configuring Next Experience with Theme Builder, Working with themes, Configure, Next Experience UI, Configure UIs and portals, Configure user experiences]
---

# Icon illustrations in Theme Builder

Icons are used to visually represent actions and concepts through simple, themed graphics.

## Default icon illustrations

Icons are simple visual symbols used to represent actions, statuses, and concepts. They automatically inherit color and style from the surrounding UI to maintain visual consistency across the experience.

**Important:** Icon illustrations apply to Workspaces and are not supported in the Core UI.

\[Omitted image "tb-icon-variants-illustration.png"\] Alt text: Action icon with outline and fill variants.

## How icons differ from other default illustrations

-   Icons don’t show explicit colors; they are rendered in black and white.
-   Icons are organized by style \(outline/fill\) and size \(small, medium, large, and extra large\).
-   Icon color is contextual based on the component that they are associated with.
-   Icon library contains approximately 800 icons, displayed in paginated groups on the main stage.

## Custom images

Upload your custom images to Theme Builder to replace the default icons.

When you replace an icon’s base image, Theme Builder automatically scales it down and applies it to all sizes. If you want more control, you can override each size individually with its own custom file, ensuring clarity and consistent stroke weight where it matters.

The size and format limitations for each of the four file sizes are as follows:

|Field|Description|
|-----|-----------|
|Dimensions limit|w12 × h12 px|
|Format|SVG|
|File size limit|2 MB|

|Field|Description|
|-----|-----------|
|Dimensions limit|w16 × h16 px|
|Format|SVG|
|File size limit|2 MB|

|Field|Description|
|-----|-----------|
|Dimensions limit|w24 × h24 px|
|Format|SVG|
|File size limit|2 MB|

|Field|Description|
|-----|-----------|
|Dimensions limit|w32 × h32 px|
|Format|SVG|
|File size limit|2 MB|

-   **[Override icon illustrations with custom images](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/platform-user-interface/override-icon-with-custom-image.md)**  
Modify or override the default icon illustrations with your own custom images to promote visual elements that reflect your company's branding. When you override an icon, Theme Builder updates the icon wherever it is used across the interface.

**Parent Topic:**[Working with Image styles](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/platform-user-interface/working-with-image-styles.md)