Override empty state illustrations with custom images

Modify or override the default empty state illustrations with your own custom images to ensure that visual elements reflect your company's branding.

Before you begin

To make your image theme-able, add the following two design tokens to your code using your preferred text editor before uploading the custom SVG to Theme Builder.

• --empty-state--main-object--fill

• --empty-state--main-object—outline

For more information, see Working with Image styles.

Role required: admin

About this task

Important:

Custom images apply to Workspaces and are not supported in the Core UI.

Procedure

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

   

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.
   The empty state illustrations are displayed on the main stage and grouped by type.

   Figure 2. Image styles tab selected

   

5. Use one of the following options to select the empty state illustration that you want to override.
   • Select the Filter () icon and expand the empty states category to select the specific empty state illustration that you want to override.
   • Scroll through the list of empty state illustrations within the main stage.
   The property panel opens automatically.
6. From the property panel, select the Images tab.

   Figure 3. Property panel Images tab

   

7. Select either the large, medium, or small image file of the illustration you want to override.
   Note:

   You can only override one image size at a time.
   The upload images modal appears.

   Figure 4. Upload images modal

   

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.

   Figure 5. Upload image modal with size and format limitations

   

9. Select Save.
   Your custom image appears on the main stage within the empty state category you have chosen.

   Figure 6. Add data empty state category with custom image displayed

   

   Figure 7. Add data empty state category with custom image displayed (design tokens applied to image)

   

10. Optional: Select the Remove override symbol if you want to restore the default empty state illustration.

    Figure 8. Image Remove override

    

11. Optional: 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.

Result

Once you've uploaded your custom image with the two design tokens applied, you can customize the colors using Theme Builder just as you would for default empty state illustrations. For information on customizing colors, see Customize the colors for empty state illustrations and custom images.

If your theme is published, your custom images are visible to users who have your theme applied upon refresh. For more information about publishing themes, see Publish your themes with Theme Builder.