Unable to change background image in Service Portal branding editor

When using the Service Portal branding editor, the background image option does not display the expected upload button. Instead, only a text box appears.

• Branding editor shows a text box instead of image upload controls.
• Attempting to change the homepage background image is not possible.

  

This occurs when the Quick start config field in the Portal record (sp_portal table) is misconfigured:

• The hero_background.sys_id property does not point to the first container of the Homepage.

 

Update the Quick start config in the Portal record to reference the correct container:

1. Navigate to the Portal record (sp_portal).
2. Locate the Quick start config field.
3. Ensure the hero_background.sys_id points to the first container of the homepage (Container 1).
   

   Example configuration:

   [{
     "tagline": {
       "table": "sp_instance",
       "sys_id": "a89f189d4f670340b06f66a01310c7d4",
       "field": "title"
     },
     "hero_background": {
       "table": "sp_container",
       "sys_id": "be98a8d2cb20020000f8d856634c9c63",  // Update this value
       "field": "background_image"
     }
   }]

4. To find the correct container sys_id:
   • Open the Homepage record.
   • Click on Container 1.
   • Copy the sys_id of that container.
5. Replace the existing hero_background.sys_id with this value.
6. Save the Portal record.

The branding editor will now display the correct image upload option.

Branding and theming

Create a theme with Theme Builder