Page navigation in Service Portal by URL

Watch

Save as PDF

Share this page

Feedback

Configure user experiences

HomeVancouver Now Platform user interfaceConfigure user experiencesConfigure UIs and portalsService PortalExploring Service PortalUnderstanding Service PortalPage navigation in Service Portal by URL

Table of Contents

Page navigation in Service Portal by URL

Release version:
Vancouver
Yokohama
Xanadu
Washington DC
UpdatedAug 3, 2023
2 minutes to read

Vancouver
Service Portal Designer

If you're an existing customer using the Service Portal (sp) portal for employee self-service use cases, we recommend that you migrate to the Employee Center (esc) portal for a better experience.

You can navigate to a portal or a page in Service Portal using a URL.

Service Portal URLs have the following structure:

https://<instance>/<portal suffix>/<guest language>/<keywords>?id=<page id>&lang=<language>&<page parameters>

Search:


Element	Description
instance	Unique, secure web address for each instance. The default format is `https://<instance name>.service-now.com`.
portal suffix	Suffix established for the portal. For example, `/sp`.
guest language	The language ID of the portal language. For example, `es` for Spanish. The page returns in the language specified if the language is active and the user accessing the page is a guest user.
keywords	Human readable keywords that improve search engine optimization (SEO) and click-through rates for public pages. Human readable URLs also help users understand what to expect on a page for public and non-public pages. For example, https://<instance>/kb/en/faq/what-is-a-cookie?id=kb_article_view&sysparm_article=KB0000007. For more information, see Add human readable keywords to page URLs.
id	The ID of the page to navigate to within the portal frame. For example, `?id=index`.
language	The language ID of the portal language. For example, `lang=es` for Spanish. The page returns in the language requested if the language is active and the user accessing the page is a guest user or an authenticated user without a language preference set.
page parameters	Additional parameters are required by some pages to load dynamic content by looking up a record (table, sys_id). Find the `$sp.getParameter` calls in a widget server script to see the parameters that a widget uses. For more detail on this method, see GlideSPScriptable - Scoped. If you don’t include these additional parameters when required, you might get a `You are either not authorized or record is not valid` error message.

For example, the URL for a public knowledge base page in Spanish in Service Portal could be https://<instance>/sp/es/faq/what-is-a-cookie?id=kb_article&sys_id=KB0000007.

Note: If you use article versioning with the Knowledge Management - Service Portal (com.snc.knowledge_serviceportal) plugin, you must add the article version number to the URL to open a knowledge article in the base system or knowledge portals. For example, instead of accessing an article using the URL https://<instance>/sp?id=kb_article&sys_id=KB0000005, you must include the article version number: https://<instance>/sp?id=kb_article&sys_id=KB0000005%20V1.0. To learn more, see Article versioning.

Referencing a page ID

Widgets and widget instance options reference Service Portal pages using the page ID. For example, a link to the sc_home page within a widget HTML template might appear as follows:

<div><a href="?id=sc_home">${Order something...}</a></div>

Vancouver Now Platform user interface

Filters

Versions

Products