Configure portal branding

  • Release version: Zurich
  • Updated July 31, 2025
  • 2 minutes to read
    • Summarize
    Summarized using AI
    This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete.

    Summary of Configure portal branding

    The Branding Editor in Service Portal allows you to customize the look and feel of your portal, enabling a unique and branded user experience. Accessible viaService Portal > Service Portal Configuration > Branding Editor, you can select a specific portal and modify its appearance using the Quick Setup and Theme Colors tabs.

    Show full answer Show less

    Quick Setup tab

    This tab provides essential configuration options to personalize your portal’s branding:

    • Portal Title: Changes the portal’s name, which also updates the portal form title in the platform UI.
    • Logo: Upload a logo displayed in the header, scaled to a max height of 46 px and width of 200 px.
    • Logo Padding: Adjusts the logo’s position relative to the header edges, stored as CSS variables on the portal form.
    • Tag Line & Background: Customizable fields defined by a JSON schema that map to specific records and fields (e.g., homepage tag line text and background image).
    • Tag Line Color: Choose the text color for the tag line.
    • Homepage Background Color: Set a background color using color names, hex, RGB, or the color palette.
    • Background Image: Upload an image for the homepage background, stored in the container record for the widget.

    All colors and images set here update in real time and are stored as CSS variables in the portal form.

    Theme Colors tab

    This tab allows detailed color customization for various portal elements:

    • Navbar: Customize header menu colors.
    • Brand: Modify page background and widget background colors.
    • Text: Set the color for text displayed on pages.

    Changes on this tab also update the CSS variables field on the portal form, providing consistent styling across the portal UI.

    Practical Benefits for ServiceNow Customers

    Using the Branding Editor, customers can easily tailor their portals to reflect their corporate identity without coding. Real-time previews help ensure the appearance meets expectations before publishing. The CSS variable storage allows consistent application of styles and simplifies future updates. This capability enhances user engagement by providing a visually cohesive and professionally branded portal experience.

    Use Branding Editor to give your portal its own look and feel.

    To access the Branding Editor, navigate to Service Portal > Service Portal Configuration, then click Branding Editor.

    Select the portal you want to customize the theme for from the portal list. Then use the options on the Quick Setup and Theme Colors tabs to customize your portal.

    Figure 1. Branding Editor
    Branding Editor
    Table 1. Quick Setup tab options
    Field Description
    Portal Title

    The name of your portal. Changing the name of the portal in the Branding Editor also changes the title on the portal form field in the platform UI.
    Logo The logo that appears in the header for your portal. This image is scaled to a maximum height of 46 px and a maximum width of 200 px.
    Logo padding Where you want the logo to sit in location to the edge of the header. This information is stored in the CSS variables section on the portal form.
    Tag line & background

    Fields defined by the JSON schema in the Quick start config field on the portal record in the platform UI. The sample Service Portal adds Tag Line and Background to the Branding Editor using the following schema:

    [{
	"tagline": {
		"table" : "sp_instance",
		"sys_id" : "34fe3d96cb20020000f8d856634c9cf4",
		"field" : "title"
	},
	"hero_background": {
		"table" : "sp_container",
		"sys_id" : "be98a8d2cb20020000f8d856634c9c63",
		"field" : "background_image"
	}
}]
    Tag line Introduce your users to a portal page with a tag line. This text is stored in an instance of the homepage search widget.
    Tag line color Select a color for the tag line.
    Homepage background color Add a color for your background. You can type in a color name, hex color, decimal (RGB), or select from the color palate.
    Background image Upload an image to appear in the background of your homepage. This image is stored in the container for the widget on your homepage.
    For any colors on the theme tab, you can use the standard color name, hex code, decimal (RGB) code, or select the color from the color palate. All the color definitions are stored in the CSS variables field of the portal form. The theme preview updates in real time as you make changes.
    Table 2. Theme colors tab
    Field Description
    Navbar Use the fields in this section to customize the colors for the header menu.
    Brand Use the fields in this section to customize the page colors. For example, the page background or the widget background.
    Text Use the fields in this section to customize the color of the text on a page.

    Changes made to the theme colors in the Branding Editor appear in the CSS variables field of the portal form in the platform UI.