Skip to content
Release: Australia · Updated: 2025-01-30 · Official documentation · View source

Theming for Now Assist in Virtual Agent enhanced chat

You can customize the look and feel of the Now Assist in Virtual Agent enhanced chat experience in your ServiceNow portal by updating the relevant Cascading Style Sheet (CSS) variables.

As a Virtual Agent admin or admin, you can customize the default enhanced chat theming variables. Information on how to customize theming can be found in Create a portal theme. Edit these variables in the following table within the CSS variables field (sp_theme) record. You can also configure these variables with a CSS Include associated with a portal's theme.

Note:

The chat header logo is shared between standard and enhanced chat, and it’s determined by the selected standard chat branding profile. You can’t configure a separate chat header logo for each experience. Updating the chat header logo in one experience updates it for the other. To view the branding profile, navigate to Assistant Designer > Assistants > Branding.

For the variables, nass refers to enhanced chat.

For more information about enhanced chat, see Enhanced chat.

VariableDescriptionDefault Values
$now-sp-nass-agent-bubble-font-colorAgent text message font color.$text-color
$now-sp-nass-chat-user-message-bubble-bg-colorUser text message bubble background color.$brand-primary-lightest
$now-sp-nass-user-bubble-font-colorUser text message font color.$text-color
$now-sp-nass-timestamp-colorTimestamp text color.$text-muted
$now-sp-nass-secondary-text-colorSecondary text color for example for Active.$gray-dark
$now-sp-nass-system-msg-text-colorSystem message text color.$text-muted
$now-sp-nass-base-input-field-placeholder-and-highlight-text-colorInput text color and with .45 opacity for placeholder.$text-color
$now-sp-nass-base-link-colorLink color.$brand-primary
$now-sp-nass-color-secondary\_2Now Design System secondary-2 color.$brand-primary-darker
$now-sp-nass-modeless-dialog-header-bg-colorBackground color for primary Now Assist header bar.\#ffffff
$now-sp-nass-modeless-dialog-header-text-colorText color for primary Now Assist header.$text-color
$now-sp-nass-base-toolbar-labels-and-icons-colorLeft-panel tool bar icons.$gray-light
$now-sp-nass-toolbar-icons-color--hoverLeft-panel tool bar icons in hover state.$gray-dark
$now-sp-nass-toolbar-icons-color--activeLeft-panel tool bar icons in active state.$text-color
$now-sp-nass-toolbar-icons-fullscreen-mode-colorLeft-panel tool bar icons in full-screen mode.darken \($brand-primary-darker, 15%\)
$now-sp-nass-toolbar-icons-fullscreen-mode-color--activeLeft-panel tool bar icons in full-screen mode for active state.$brand-primary-darker
$now-sp-nass-window-control-icons-colorWindow controls icons.$text-muted
$now-sp-nass-window-control-icons-color--hoverWindow controls icons in hover state.$text-color
$now-sp-nass-window-control-icons-color--activeWindow controls icons in active state.$text-color
$now-sp-nass-feedback-and-search-result-panel-colorFeedback panel and search result icon.$text-muted
$now-sp-nass-feedback-and-search-result-panel-selected-colorSelected icon in feedback panel.$text-muted
$now-sp-nass-action-and-kb-citation-colorAction and Knowledge Base link color$link-color
$now-sp-nass-color-primary-0Primary-0 for pills/primary buttons.$brand-primary-lightest
$now-sp-nass-color-primary-2Primary-2 for pills/primary buttons in active state.$brand-primary-darker
$now-sp-nass-button-primary-bg-colorSubmit button in choice picker control.$btn-primary-bg
$now-sp-nass-button-primary-bg-active-colorButton primary active background color.$btn-primary-bg
$now-sp-nass-button-selection-text-colorNow Design System secondary-1 color$brand-primary
$now-sp-nass-tooltip-bg-colorTooltip background color for input field icons.$tooltip-bg
$now-sp-nass-tooltip-text-colorTooltip text color for input field icons.$tooltip-color
$now-sp-nass-alert-critical-colorUnread indicator color.$brand-danger
$now-sp-nass-input-field-icon-colorIcon and attachment icon in the input field$text-muted
$now-sp-nass-color-alert-moderate-3Animated loading icon color.\#4345a6
$now-sp-nass-body-bgBody primary background color.\#ffffff
$now-sp-nass-base-highlight-colorBackground-color of matched text when searching emojis.lighten \($warning, 35%\)
$now-sp-nass-color-primary-3Bare buttons color in active state.darken \($brand-primary-darker, 15%\)
$now-sp-nass-color-background-primaryContent background color.\#ffffff
$now-sp-nass-header-panel-bg-colorHeader panel background color.\#ffffff
$now-sp-nass-button-bg-action-colorImage picker select button background color.$brand-primary
$now-sp-nass-primary-button-action-text-colorImage picker select button color.$sp-btn-text-color
$now-sp-nass-base-separator-colorSeparator.$border-tertiary
$now-sp-nass-chat-agent-message-bubble-bg-colorAgent message bubble background color.$gray-light
$now-sp-nass-citation-badge-colorCitation badge color.$gray-lighter
$now-sp-nass-divider-and-border-tertiary-colorDivider and border color of mid-topic switch in search results.$border-tertiary
$now-sp-nass-highlight-value-tertiary-info-bg-colorHighlighted info value in the mid-topic card.$state-info-bg
$now-sp-nass-FAB-iconIcon imagery that appears on the floating action button.ai-sparkle-icon
$now-sp-nass-FAB-gradient-color-1First color of background gradient for chat floating action button icon.$brand-primary-lighter
$now-sp-nass-FAB-gradient-color-2Second color of background gradient for chat floating action button icon.$brand-info
$now-sp-nass-FAB-gradient-hover-color-1First color of background gradient for chat floating action button icon in hover state.$brand-primary-darker
$now-sp-nass-FAB-gradient-hover-color-2Second color of background gradient for chat floating action button icon in hover state.darken \($brand-info, 10%\)
$now-sp-nass-FAB-gradient-active-color-1First color of background gradient for chat floating action button icon in active state.$brand-primary
$now-sp-nass-FAB-gradient-active-color-2Second color of background gradient for chat floating action button icon in active state.$brand-info
$now-sp-nass-FAB-icon-size-factorHandles size of Image within the chat icon.1