CSA Guide

Service Portal: Introduction for Admins

Introduction

Service Portal is ServiceNow's modern self-service interface — a responsive, user-friendly alternative to the classic IT interface for end users. Where the classic UI is designed for IT professionals navigating complex records, the Service Portal is designed for employees requesting services, checking ticket status, and finding answers.

This guide gives administrators what they need to configure and maintain a Service Portal without writing custom widgets from scratch.

Portal Architecture

Portal
  └─ Theme (colors, fonts, header/footer)
  └─ Pages
       └─ Rows (layout)
            └─ Columns
                 └─ Widgets (functional components)

Portal

The top-level container. Multiple portals can exist (e.g., IT Portal, HR Portal). Each portal has its own URL suffix (/sp for IT, /hr_portal for HR).

Pages

Each page has a URL route (e.g., /sp?id=sc_home for the catalog home). Pages are made up of configurable rows and columns.

Widgets

Widgets are the functional building blocks — a catalog search bar, a news ticker, a ticket status widget. Hundreds of out-of-the-box widgets exist, and custom widgets can be built with HTML, Angular, and server-side scripts.

Accessing the Portal Designer

Service Portal > Service Portal Configuration
— or —
Navigate to your portal URL and append ?sp_debug=true to see widget boundaries

In Designer mode, you can drag-and-drop widgets, resize columns, and configure widget options without writing code.

Key Out-of-the-Box Widgets

Widget	Purpose
SC Header	Service Catalog search and navigation
Order Status	Shows user's open/recent requests
KB Search	Searches the Knowledge Base
My Requests	Lists open tickets for the logged-in user
Ticket Conversations	Shows comments and updates on a ticket
Popular Questions	Surfaces frequently viewed KB articles
Activity Stream	Live feed of updates on a record
Approval Summarizer	Pending approvals for the current user

Themes: Branding the Portal

Service Portal > Themes > New (or edit existing)

Theme configuration:

Primary color: Main brand color (used for buttons, links, headers)
Secondary color: Accent color
Header color: Navigation bar background
Footer color: Bottom bar
CSS variables: Override any design token
Logo: Upload company logo
Fonts: Google Fonts integration for custom typography

Changes to a theme apply instantly to all pages using that theme.

User Criteria for Portal Visibility

Control what catalog items, pages, and KB articles are visible in the portal using User Criteria:

User Criteria: All Employees
  - Company: My Company
  OR
  - Role: employee

Apply to catalog items (the Items tab), knowledge bases, and portal pages.

Homepage Configuration

The portal homepage is typically the most important page to configure. Common homepage layout:

[Full-width search bar]
[Service Catalog categories row]
[Two-column: Popular Requests | My Open Tickets]
[Knowledge Base - Popular Articles]
[News/Announcements widget]

Each row can have 1, 2, 3, or 4 columns. Drag widgets from the widget picker into columns.

Testing as a Non-Admin

Always test your portal as an end user, not an admin:

Use Impersonation to log in as a standard user
Navigate to the portal URL
Verify visible catalog items, KB articles, and ticket status
Submit a test request and follow the full journey

Portal visibility bugs are almost always User Criteria misconfigurations that only appear when impersonating a regular user.

Portal vs. Classic UI

Feature	Service Portal	Classic UI
Audience	End users	IT staff
Navigation	Simplified, card-based	Application Navigator
Record access	My tickets, requests	Full table access
Mobile-friendly	✅ Yes	Limited
Customization	Widget-based	Form/list configuration

End users should use the Service Portal. IT staff use the classic UI. Both surfaces live on the same instance and share the same data.

Best Practices

Brand the portal with your organization's colors and logo before launch
Test every catalog item from the portal as a regular user before go-live
Keep the homepage simple — focus on the top 5-7 actions users take most
Configure the search bar prominently — most users search rather than browse
Enable KB search on the homepage to deflect simple how-to questions
Use User Criteria, not ACLs, for portal visibility control
Validate mobile rendering — many employees use the portal on phones

Conclusion

The Service Portal is your organization's face for IT service delivery. A well-configured portal drives self-service adoption, reduces call volume, and improves user satisfaction. Administrators can accomplish 80% of portal customization without writing code — through themes, widget configuration, and page layout design. Start with a clean branded homepage, validate with real users, and iterate based on feedback.