Service Portal
The branded, user-friendly front end built on widgets.
The Service Portal is the consumer-grade front end employees and customers actually use, a responsive website onto the same catalog, knowledge and requests that agents work behind the scenes. It hides the back-end forms behind something friendly, and it is built entirely from widgets.
- The building blocks
- Anatomy of a widget
- Security is inherited, not re-implemented
- Service Portal vs Next Experience
- Common mistakes
The Service Portal is the consumer-grade front end employees and customers actually use, a responsive website onto the same catalog, knowledge and requests that agents work behind the scenes. It hides the back-end forms behind something friendly, and it is built entirely from widgets.
The building blocks
Anatomy of a widget
A widget has three parts, which map neatly onto client/server thinking, this is the mental model to internalise:
The server script runs on the instance and populates a data object; the client controller and HTML render it. Client and server talk via c.server.update() / input, the portal equivalent of the GlideAjax pattern.
Security is inherited, not re-implemented
Service Portal vs Next Experience
Service Portal remains widely deployed, while newer builds increasingly use Next Experience and Employee Center for a unified, multi-department front door. The concepts, pages, widgets, catalog, knowledge, carry across, and the two often coexist.
Common mistakes
- Putting data queries in the client controller instead of the server script.
- Cloning widgets to tweak one thing instead of using widget options / instances.
- Assuming the portal bypasses ACLs, it does not.
- Heavy inline styling instead of the theme's CSS variables.
Practice challenge
FAQ
How to access Theme Builder in ServiceNow?
In the platform navigator, search for Theme Builder (or open Now Experience Framework → Theme Builder). You need a theming/admin role. It opens a visual editor where you pick a theme and preview changes live.
How to customize themes in ServiceNow?
For the Service Portal, open Service Portal → Portals, pick your portal and edit its Theme record, set primary/brand colours, logo, header and CSS variables. For the newer UI, use Theme Builder to adjust colour tokens, typography and density, then publish. Keep changes in an update set.