Skip to content
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Page navigation in Service Portal by URL

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>

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>

Parent Topic:Understanding Service Portal

Related topics

Add human readable keywords to page URLs

sndocs is an independent community mirror and is not affiliated with or endorsed by ServiceNow.

ServiceNow, the ServiceNow logo, Now, and other ServiceNow marks are trademarks and/or registered trademarks of ServiceNow, Inc., in the United States and/or other countries. Other company and product names may be trademarks of the respective companies with which they are associated.

© 2026 ServiceNow, Inc. All rights reserved.

Documentation content is redistributed under the Apache License 2.0 from the ServiceNowDocs repository.

ElementDescription
instanceUnique, secure web address for each instance. The default format is `https://.service-now.com`.
portal suffixSuffix established for the portal. For example, `/sp`.
guest languageThe 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.
keywordsHuman 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:///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.
idThe ID of the page to navigate to within the portal frame. For example, `?id=index`.
languageThe 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 parametersAdditional 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.