Page navigation in Service Portal by URL

concept australia Updated Sep 10, 2026 2 min read navigate-by-portal-url.md
Raw file servicenow.com

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

Service Portal URLs have the following structure:

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

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:///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:

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

Parent Topic:Understanding Service Portal

Related topics

Add human readable keywords to page URLs

Search documentation
Search document titles and file paths on the australia branch