Override modal illustrations with custom images

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 2 minutes de lecture

    • Modify or override the default modal illustrations with your own custom images to promote visual elements that reflect your company's branding.

    Avant de commencer

    Role required: ui_builder_admin

    For information on granular roles, see Granular admin roles.

    Verify that your custom images use the desired colors and meet your branding requirements before uploading to Theme Builder.

    Pourquoi et quand exécuter cette tâche

    Important :
    Custom images apply to Workspaces and aren’t supported in the Core UI.

    Procédure

    1. Navigate to All > Now Experience Framework > Themes > Theme 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.
      Figure 1. Editor page view
      Example view of the Editor page.
    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 Modals.
    5. Use one of the following options to select the modal illustration that you want to override.
      • Select the Filter icon icon and expand the modal category to select the specific modal illustration that you want to override.
      • Scroll through the list of modal illustrations within the main stage.
      Once you have selected an illustration, the property panel opens.
      Figure 2. Image styles tab with Modals selected and Platform/Onboarding all illustration selected
      Image styles tab selected with modal illustrations listed on main stage and property panel opened.
    6. From the property panel, select the Images tab.
    7. Select the default modal illustration file name.
      For example, the file name listed for this illustration is onboarding-all-v2.svg.
      The upload images modal appears.
    8. 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.
      Refer to the upload image modal for size and format limitations. If your custom image doesn’t meet the required size and format, your image isn’t saved.
    9. Preview your image and select Save.
      Your custom image appears on the main stage within the modal type that you have chosen. The file name for your custom image is now listed in the property panel.
      Figure 3. Platform/Onboarding all modal illustration with custom image displayed
      Platform/Onboarding all modal illustration type with custom image displayed on main stage.
    10. Facultatif : Select the Remove override symbol if you want to restore the default modal illustration.
      Figure 4. Remove override
      Remove custom image override symbol.
    11. Facultatif : Preview your edits before publishing your theme to your instance.
      1. Select the Experience preview 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.
        Figure 5. Experience preview
        Global styles experience preview screen with Admin Center experience selected.

    Résultats

    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.