Skip to content
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

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.

Image omitted: tb-icon-variants-illustration.png
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:

FieldDescription
Dimensions limitw12 × h12 px
FormatSVG
File size limit2 MB
FieldDescription
Dimensions limitw16 × h16 px
FormatSVG
File size limit2 MB
FieldDescription
Dimensions limitw24 × h24 px
FormatSVG
File size limit2 MB
FieldDescription
Dimensions limitw32 × h32 px
FormatSVG
File size limit2 MB
  • Override icon illustrations with custom images
    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