Product documentation Docs
    • English
    • Deutsch
    • 日本語
    • 한국어
    • Français
  • More Sites
    • Now Community
    • Developer Site
    • Knowledge Base
    • Product Information
    • ServiceNow.com
    • Training
    • Customer Success Center
    • ServiceNow Support Videos
  • Log in

Product documentation

  • Home
How search works:
  • Punctuation and capital letters are ignored
  • Special characters like underscores (_) are removed
  • Known synonyms are applied
  • The most relevant topics (based on weighting and matching to search terms) are listed first in search results
Topics are ranked in search results by how closely they match your search terms
  • A match on the entire phrase you typed
  • A match on part of the phrase you typed
  • A match on ALL of the terms in the phrase you typed
  • A match on ANY of the terms in the phrase you typed

Note: Matches in titles are always highly ranked.

  • Release version
    Table of Contents
    • Now Platform capabilities
Table of Contents
Choose your release version
    Home New York Now Platform Capabilities Now Platform capabilities Service Portal Create a portal

    Create a portal

    • Save as PDF Selected topic Topic & subtopics All topics in contents
    • Unsubscribe Log in to subscribe to topics and get notified when content changes.
    • Share this page

    Create a portal

    Create a portal using the Service Portal configuration page.

    Before you begin

    Role required: admin or sp_admin

    About this task

    The Branding Editor affects the look of your portal and essentially changes the CSS for the pages. The changes you make in the Branding Editor are recorded in the portal record in the following fields. If you have experience with CSS and HTML you can configure these fields in the portal form directly as accessed through the portal UI. By theming your portal in the Branding Editor instead, you can take advantage of the real-time theme preview.

    Procedure

    1. Navigate to Service Portal > Portals, then click New.
    2. Complete the portal form using the following fields.
      Table 1. Portal form fields
      Property Description
      Title The name you use to define your portal. In the browser header and for bookmarks, the title appears as <Portal Title> - <Page Title>
      URL Suffix The value that appears appended to an instance URL when you access a portal. For example, if you use sp, the instance URL for that portal would be <instance name>.service-now.com/sp. Make sure this value is unique and is not the same as any other portal.
      Note: Avoid using reserved words in your URL to prevent errors when navigating to your portal page. Word such as portal and cms should not be used. Also avoid any javascript protected terms.
      Homepage The page you want users to see first after they sign in.
      Social QA Knowledge Base Name of the knowledge base where you want to store questions and answers from portal users.
      KB home page The home page you created that you want users to see when they go to a knowledge base.
      Login page The page you created for users to be authenticated.
      Logo Logo that appears in the page header. You can also configure the logo in the Branding Editor.
      Icon The icon that appears in the address bar for your portal. Each portal you create can have a different icon.
      Default The portal you want to use as your main portal
      Quick start config Schema that defines configuration items in the Branding Editor. In JSON format, you can define fields and records used to generate your branding options.
      [{
      	"tagline": {
      		"table" : "sp_instance",
      		"sys_id" : "34fe3d96cb20020000f8d856634c9cf4",
      		"field" : "title"
      	},
      	"hero_background": {
      		"table" : "sp_container",
      		"sys_id" : "be98a8d2cb20020000f8d856634c9c63",
      		"field" : "background_image"
      	}
      }]
      CSS variables Portal-specific Sass variables. You can overwrite existing theme variables here.
      Note: Use the CSS variables field to define CSS variables only. Use CSS Includes to define CSS rules. As of the Madrid release, Sass and LESS can be used within CSS Includes. For more information on CSS Includes, see Create a portal theme.
      Application Application scope. This field is uneditable and Global by default
      404 page The default page your users see whenever a page cannot load properly. You can also define a default 404 page using the system property glide.service_portal.default_404_page.
      Catalog home page Catalog page that you created in the portal to represent the catalog.
      Main menu Reference to the menu in the [sp_instance_menu] table that appears in the header
      Theme Refers to a theme in the [sp_theme] table that defines the style and branding for the portal. The theme is the lowest level of style configuration and any changes made in the Branding Editor or to specific portal components (such as widget or container CSS) override those styles.
      Hide portal name Option to hide the portal name in the page title.
      Figure 1. Example portal
      Example of a new portal for documentation
    3. Click Submit to save the portal page.
    4. In the Knowledge Bases related list, click Edit to select which knowledge bases appear for the knowledge base page. For example, if you select IT and Instance Security Center, only the article categories defined for these knowledge bases appear in the KB categories widget.
    5. In the Catalogs related list, click Edit to select one or more catalogs listed in the sc_catalog table to use in the portal.
    • Configure a catalog in Service Portal

      Associate a portal with multiple catalogs. By default, Service Portal is associated with Service Catalog.

    • Associate a portal with a knowledge base

      You can associate a portal with any knowledge base. Multiple knowledge bases can be associated with a portal.

    • Configure Agent Chat in Service Portal

      Your end users can initiate and maintain an Agent Chat conversation in any portal page. Write a script to pass portal-specific data to Agent Chat. For example, pass the name of your knowledge base to a Virtual Agent conversation.

    • Service Portal styles

      Pages are made up of containers, columns, rows, widgets, and widget instances. You can configure the CSS of each component, or use the CSS defined in theme and branding as global definitions for the portal. If you do not define CSS in theme or branding, Bootstrap defaults are used.

    • Configure a portal header menu

      Service Portal is designed to allow customers to have deep control over the behavior of their portals. One of the main navigation controls for users is the header main menu. The menu options are determined by the assignment of a main menu to the portal, but the look and behavior of the menu is defined within the theme and associated header.

    Tags:

    Feedback
    On this page

    Previous topic

    Next topic

    • Contact Us
    • Careers
    • Terms of Use
    • Privacy Statement
    • Sitemap
    • © ServiceNow. All rights reserved.

    Release version
    Choose your release version

      Create a portal

      • Save as PDF Selected topic Topic & subtopics All topics in contents
      • Unsubscribe Log in to subscribe to topics and get notified when content changes.
      • Share this page

      Create a portal

      Create a portal using the Service Portal configuration page.

      Before you begin

      Role required: admin or sp_admin

      About this task

      The Branding Editor affects the look of your portal and essentially changes the CSS for the pages. The changes you make in the Branding Editor are recorded in the portal record in the following fields. If you have experience with CSS and HTML you can configure these fields in the portal form directly as accessed through the portal UI. By theming your portal in the Branding Editor instead, you can take advantage of the real-time theme preview.

      Procedure

      1. Navigate to Service Portal > Portals, then click New.
      2. Complete the portal form using the following fields.
        Table 1. Portal form fields
        Property Description
        Title The name you use to define your portal. In the browser header and for bookmarks, the title appears as <Portal Title> - <Page Title>
        URL Suffix The value that appears appended to an instance URL when you access a portal. For example, if you use sp, the instance URL for that portal would be <instance name>.service-now.com/sp. Make sure this value is unique and is not the same as any other portal.
        Note: Avoid using reserved words in your URL to prevent errors when navigating to your portal page. Word such as portal and cms should not be used. Also avoid any javascript protected terms.
        Homepage The page you want users to see first after they sign in.
        Social QA Knowledge Base Name of the knowledge base where you want to store questions and answers from portal users.
        KB home page The home page you created that you want users to see when they go to a knowledge base.
        Login page The page you created for users to be authenticated.
        Logo Logo that appears in the page header. You can also configure the logo in the Branding Editor.
        Icon The icon that appears in the address bar for your portal. Each portal you create can have a different icon.
        Default The portal you want to use as your main portal
        Quick start config Schema that defines configuration items in the Branding Editor. In JSON format, you can define fields and records used to generate your branding options.
        [{
        	"tagline": {
        		"table" : "sp_instance",
        		"sys_id" : "34fe3d96cb20020000f8d856634c9cf4",
        		"field" : "title"
        	},
        	"hero_background": {
        		"table" : "sp_container",
        		"sys_id" : "be98a8d2cb20020000f8d856634c9c63",
        		"field" : "background_image"
        	}
        }]
        CSS variables Portal-specific Sass variables. You can overwrite existing theme variables here.
        Note: Use the CSS variables field to define CSS variables only. Use CSS Includes to define CSS rules. As of the Madrid release, Sass and LESS can be used within CSS Includes. For more information on CSS Includes, see Create a portal theme.
        Application Application scope. This field is uneditable and Global by default
        404 page The default page your users see whenever a page cannot load properly. You can also define a default 404 page using the system property glide.service_portal.default_404_page.
        Catalog home page Catalog page that you created in the portal to represent the catalog.
        Main menu Reference to the menu in the [sp_instance_menu] table that appears in the header
        Theme Refers to a theme in the [sp_theme] table that defines the style and branding for the portal. The theme is the lowest level of style configuration and any changes made in the Branding Editor or to specific portal components (such as widget or container CSS) override those styles.
        Hide portal name Option to hide the portal name in the page title.
        Figure 1. Example portal
        Example of a new portal for documentation
      3. Click Submit to save the portal page.
      4. In the Knowledge Bases related list, click Edit to select which knowledge bases appear for the knowledge base page. For example, if you select IT and Instance Security Center, only the article categories defined for these knowledge bases appear in the KB categories widget.
      5. In the Catalogs related list, click Edit to select one or more catalogs listed in the sc_catalog table to use in the portal.
      • Configure a catalog in Service Portal

        Associate a portal with multiple catalogs. By default, Service Portal is associated with Service Catalog.

      • Associate a portal with a knowledge base

        You can associate a portal with any knowledge base. Multiple knowledge bases can be associated with a portal.

      • Configure Agent Chat in Service Portal

        Your end users can initiate and maintain an Agent Chat conversation in any portal page. Write a script to pass portal-specific data to Agent Chat. For example, pass the name of your knowledge base to a Virtual Agent conversation.

      • Service Portal styles

        Pages are made up of containers, columns, rows, widgets, and widget instances. You can configure the CSS of each component, or use the CSS defined in theme and branding as global definitions for the portal. If you do not define CSS in theme or branding, Bootstrap defaults are used.

      • Configure a portal header menu

        Service Portal is designed to allow customers to have deep control over the behavior of their portals. One of the main navigation controls for users is the header main menu. The menu options are determined by the assignment of a main menu to the portal, but the look and behavior of the menu is defined within the theme and associated header.

      Tags:

      Feedback

          Share this page

          Got it! Feel free to add a comment
          To share your product suggestions, visit the Idea Portal.
          Please let us know how to improve this content

          Check any that apply

          To share your product suggestions, visit the Idea Portal.
          Confirm

          We were unable to find "Coaching" in Jakarta. Would you like to search instead?

          No Yes
          • Contact Us
          • Careers
          • Terms of Use
          • Privacy Statement
          • Sitemap
          • © ServiceNow. All rights reserved.

          Subscribe Subscribed Unsubscribe Last updated: Tags: January February March April May June July August September October November December No Results Found Versions Search preferences successfully updated My release version successfully updated My release version successfully deleted An error has occurred. Please try again later. You have been unsubscribed from all topics. You are now subscribed to and will receive notifications if any changes are made to this page. You have been unsubscribed from this content Thank you for your feedback. Form temporarily unavailable. Please try again or contact  docfeedback@servicenow.com  to submit your comments. The topic you requested does not exist in the release. You were redirected to a related topic instead. The available release versions for this topic are listed There is no specific version for this documentation. Explore products Click to go to the page. Release notes and upgrades Click to open the dropdown menu. Delete Remove No selected version Reset This field is required You are already subscribed to this topic Attach screenshot The file you uploaded exceeds the allowed file size of 20MB. Please try again with a smaller file. Please complete the reCAPTCHA step to attach a screenshot
          Log in to personalize your search results and subscribe to topics
          No, thanks Login