CMS to Service Portal transition

  • Release version: Australia
  • Updated March 12, 2026
  • 5 minutes to read
    • Summarize
    Summarized using AI
    This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete.

    Summary of CMS to Service Portal transition

    This guide assists ServiceNow customers transitioning from CMS to Service Portal, addressing potential issues with complex forms and customizations. Understanding the implications for users and the mobile environment is crucial for a successful migration.

    Show full answer Show less

    Key Features

    • Data Lookups: Client-side data lookups are unsupported in Service Portal, but record updates will still process as expected when submitted.
    • Content Blocks: Replaced by customizable widgets in Service Portal for querying and displaying data.
    • UI Macros: Not supported; use widgets instead, with the option to create new widgets using AngularJS.
    • UI Actions: Server-side actions are supported, but redirection must be refactored as Service Portal handles this differently.
    • Catalog Client Scripts: Only support UI Type options for Mobile / Service Portal. Synchronous API calls must be replaced with asynchronous alternatives.
    • Service Catalog Variables: Supported with some exceptions, including the lack of support for UI Macros and validation scripts.
    • Order Guides: Use the Order Guide widget, but be cautious of performance issues with large guides. Consider breaking them down or simplifying variables.
    • Record Producers: Certain behaviors differ, such as sort order not being honored and date values not respecting time zones.
    • Login Scenarios: Transition from CMSEntryPage to SPEntryPage for defining login behaviors; redirects are not supported.
    • Service Catalog Forms: Rendered in a two-column layout; complex forms may require simplification.
    • Shopping Cart: Utilize the base system Shopping Cart widget for managing requests.

    Key Outcomes

    By following this guide, ServiceNow customers will effectively prepare for the transition to Service Portal, ensuring that their Service Catalog functions optimally. Testing is essential for all features, especially complex forms and record producers, to confirm expected behavior in the new environment.

    Your CMS may include complex forms and customizations that do not render as expected in Service Portal. Use this guide to understand how best to modify your CMS and Service Catalog implementation for Service Portal adoption, and to understand how a conversion may affect your users.

    If you are considering transitioning from CMS to Service Portal, make sure that you understand the impact of moving to a mobile environment. Review the Mobile client GlideForm (g form) scripting and migration.

    Note:
    For information about redirecting CMS users to Service Portal, see the How to automatically redirect users who navigate to any CMS pages to Service Portal [KB0722455] article in the Now Support Knowledge Base.

    Support level and transition actions

    CMS component

    Service Portal support

    		 Possible transition actions
    Data lookups

    The client-side component of a data lookup is not supported in Service Portal. However, the data lookup is applied in the platform when a record is submitted or updated in Service Portal.

    While data lookups are not applied in the Service Portal, the record updates as expected in the platform UI when submitted or updated in the Service Portal. If your CMS is used by requesters only, this limitation may not affect your implementation.
    Content blocks

    Because Content blocks use Jelly, they are not supported in Service Portal

    .

    In the Service Portal, content blocks are replaced by widgets. Widgets are highly customizable components that can query record data, display and update records, and gather user input.

    Base system widgets generally cover most use cases. Just as you add content blocks to a page in your CMS, you can add widgets to a page using the Service Portal Designer.
    UI Macros

    Because UI Macros use Jelly, they are not supported in Service Portal.
    • In Service Portal, you can use widgets instead of UI Macros. Base system widgets generally cover most use cases, but for custom solutions, you can develop new widgets using AngularJS.
    • If your implementation includes UI Macros in Service Catalog forms that reference other fields or variables in the form, you can embed the widget inside a Service Catalog variable. Learn more: Replace a Service Catalog form script with a widget.
    UI actions

    All server-side UI actions are supported in Service Portal, although setRedirectURL() operations are ignored because Service Portal forms handle redirection in a different way than the platform.

    The form widget ignores all UI actions marked as Client.
    • Refactor any UI actions to remove setRedirectURL() operations.
    • Check that UI actions are not marked as client.
    Catalog client scripts

    Only UI Type options Mobile / Service Portal and All are supported. UI type Desktop is not supported in Service Portal. For a list of supported APIs, see Service Portal and client scripts.

    Note:
    Synchronous JavaScript calls are not supported in Service Portal and must be replaced by asynchronous calls. For example, the getXMLWait() method of the GlideAjax class is not supported in Service Portal. Instead, use one of the following supported asynchronous methods:
    • getXML(Function callback)
    • getXMLAnswer(Function callback)

    For additional information on GlideAjax, refer to GlideAjax.

    To understand the impact of updating your CMS to work in a mobile environment, review Mobile client GlideForm (g form) scripting and migration.
    • Update your scripts to remove any unsupported client APIs.
    • Check that the script UI Type is set to Mobile / Service Portal or All.
    UI policies

    Scripted UI policies can only use APIs supported in Service Portal. For a list of supported APIs, see Service Portal and client scripts.

    		 Update your scripts to remove any unsupported client APIs.

    Service Catalog variables

    Service Catalog variables are supported in Service Portal with the following exceptions:

    • UI Macros and UI pages variable types are not supported.
    • Validation Scripts for variables are not supported. Supported validation types include:
      • The Mandatory field on the variable form.
      • Read-only variables.
      • All fields in the Availability tab of the variable form.
    • Default variable size is not supported.
    • Expanding and collapsing help text is not supported. Rather, the Help text and Instructions fields defined in the Annotations tab on the variable form are always expanded. The Help tag does not display.
    • The List Collector variable displays as a choice list instead of a slushbucket in the Service Portal.
    • If embedding a widget in a catalog item form, you can use the UI Macro variable type. Learn more: Replace a Service Catalog form script with a widget.
    • If using variable with annotations, make sure to test your catalog items in Service Portal to ensure that help text displays as expected.
    Order guides

    Order Guides in Service Portal use the Order Guide widget.

    Large order guides can cause performance issues in the Service Portal. If you have large order guides, you can:

    • Break them into multiple order guides.
    • Simplify variables used in the order guides.
    • As a temporary solution, you can render the Service Catalog item using an iFrame. See Service Catalog forms in Service Portal.
    Record producers

    Record producers are used in Service Portal with the following differences:

    • The sort order for catalog items in record producers is not honored.
    • Date values do not honor time zone when the record producer submits a record.

    Make sure to test all record producers used in Service Portal to make sure that they behave as expected.
    Login scenarios and redirects

    In CMS, you used the CMSEntryPage script include to define login scenarios. Instead, Service Portal uses the SPEntryPage script include and related system properties to define login scenarios. Redirects are not supported in Service Portal.

    In Service Portal, define login behavior by modifying the SPEntryPage script include and setting system properties.

    For more information, see Single sign-on, logins, and URL redirects.

    Service Catalog forms

    Service Catalog forms such as catalog items and record producers are rendered within widgets in a two-column layout. Complex forms may not display as expected.

    • Only the top-level container settings are honored. If there are other containers within the top-level container, they are rendered as a single column. If there are container splits or nested containers within these additional containers, they are rendered as a single column. A top-level container is not a child of any other container.
    • There can be a maximum of two columns in Service Portal. If your implementation includes forms with more than two columns, the fields are reorganized into two-columns in Service Portal.
    • Variable sets are treated as containers. All previously listed rules apply to variable sets as well as any containers within them.
    • Default variable size is not supported in Service Portal.
    Shopping cart

    The Service Portal includes a base system Shopping Cart widget.

    		 Use the Shopping Cart widget.