---
sourceDocument: Australia ServiceNow AI Platform user interface
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/platform-user-interface

 Release :

    - australia

ft:locale :

    - pt-BR

ft:publication_title :

    - Australia ServiceNow AI Platform user interface

ft:clusterId :

    - platux

bundleId :

    - platux

workflow :

    - Platform


---

# Override icon illustrations

# Override icon illustrations with custom images {#ariaid-title1}

* Versão de lançamento: Australia
* 
* Atualizado 12 de mar. de 2026
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 min. de leitura

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.

## Antes de Iniciar

Role required: ui_builder_admin

For information on granular roles, see [Granular admin roles](https://www.servicenow.com/docs/access?context=granular-admin-roles&version=australia&pubname=australia-platform-security&ft:locale=en-US).

## Por Que e Quando Desempenhar Esta Tarefa

When you replace the base image, Theme Builder creates the other icon sizes by resizing your new base image automatically. This means that you only need to maintain one source file, and Theme Builder keeps every size in sync for you. If
the automatically generated sizes lose sharpness or important details, you can replace any size independently.

You can override an entire icon set via a single base image or provide size‑specific assets for precise control.  
Use the base image override when:

* You want to move quickly with a single source of truth.
* Minor changes from scaling are acceptable.
{#override-icon-with-custom-image__ul_gt2_v1g_f3c}  
Use per‑size overrides when:

* You need uniform stroke weights across sizes.
* Fine details get lost at 12×12 or 16×16, and you want simplified small-size art.
* Your design team maintains a bespoke icon set according to size.
{#override-icon-with-custom-image__ul_vtl_2bg_f3c}  
Importante:  
Custom images apply to Workspaces and aren't supported in the Core UI.

## Procedimento

1. Navigate to AllNow Experience FrameworkThemesTheme Builder.  
   The Theme Builder landing page opens in a new tab and is displayed in the Home page view.
2. Use the Page drop-down list to select the Editor page view.  
   Figura 1. Editor page view
3. From the Theme drop-down list, select the theme that you want to edit.
4. Select the Image styles tab from the general styles panel and expand Icons.
5. Use one of the following options to select the icon illustration set that you want to override.  
   * Select the Filter icon ![]() and expand the icon category to select the specific illustration set that you want to override. Enable Only show modified images to display only icons you have changed.
   * Enter text in the search field to filter the icon library. The results update as you enter and show matching default and custom icons available in the theme's icon library.
   * Scroll through the list of icon illustrations in the main stage. Use the records-per-page control to view 10, 20, 50, or 100 icons at a time as you browse.
   {#override-icon-with-custom-image__ul_yvl_s35_bfc}  
   Once you have selected an illustration, the property panel opens.Figura 2. Image styles tab with Icons expanded
6. From the property panel, select the file name for the icon size you want to override.  
   Nota:  
   To update all sizes, replace the Base image. Replacing other sizes affects only that size. If you override the base image, all smaller sizes scale automatically and any individual size overrides you've already applied are replaced.
7. Use one of the following options to upload your custom image:
   * Select Browse, choose your custom image file from your computer's file browser, and select Open.
   * Drag your custom image file from your computer's file browser and drop the image directly into the modal.

   {#override-icon-with-custom-image__choices_ubj_tfz_v2c}  
   Refer to the upload image modal for size and format limitations or see [Icon illustrations in Theme Builder](https://servicenow-prod.fluidtopics.net/Rsf5l8DMkO587CyGN6wqZg "Icons are used to visually represent actions and concepts through simple, themed graphics."). If your custom image doesn't meet the required size and format, your image isn't saved.
8. Preview your image within the modal and select Save.  
   Your custom image appears on the main stage within the icon illustration type that you have chosen. The file name for your custom image is now listed in the property panel.
9. **Opcional:** Select the Remove override icon to restore the default icon illustration.  
   Nota:  
   Removing the base image override resets the icon to its default state and clears all individual size overrides.
10. Preview your edits before publishing your theme to your instance.  
    Icon scaling can introduce sharpness or detail issues that are only visible in a live experience.
    1. Select the Experiences tab from the Global styles panel.
    2. Select the experience that you want to preview from the Experience drop-down list.
    3. Select the Open in new tab icon ![]() to open the experience in a new tab.  
       Figura 3. Experience preview
    {#override-icon-with-custom-image__substeps_ylj_jqn_w2c}

## Resultado

If your theme is published, your custom images are visible to users who have your theme applied on refresh. For more information about publishing themes, see [Publish your themes with Theme Builder](https://servicenow-prod.fluidtopics.net/mh8~2NoMfoPjrgtYb4sbmw "Publish multiple themes to your web instance or a single theme to your mobile instance to reflect your company's brand.").