SC Order Guide widget

  • Release version: Yokohama
  • Updated January 30, 2025
  • 2 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 SC Order Guide widget

    The SC Order Guide widget (widget-sc-order-guide-v2) enables ServiceNow customers to request an order guide, which is a single service catalog request encompassing multiple catalog items designed for a specific purpose. This base system widget can be used as-is in your Service Portal or cloned and customized to meet your unique business needs. Order guides are configured through the platform UI underService Catalog > Catalog Definitions > Order Guides.

    Show full answer Show less

    Key Features

    • Describe Needs Section: Displays the order guide’s image, description, and variables associated with the request.
    • Choose Options Section: Shows catalog items included in the order guide based on earlier inputs and configured rules. Each catalog item appears in an accordion view with its name, description, and any required options for user input.
      • Include Toggle: Allows users to optionally include or exclude catalog items in the order guide request. This toggle can be enabled or disabled by selecting the Show Include Toggle (Service Portal) checkbox during order guide configuration.
      • Mandatory Items: Items can be made mandatory, removing the toggle and enforcing their inclusion.
      • Excluding Items: When an item is excluded, it becomes non-editable and mandatory field restrictions are ignored.
    • Summary Section: Provides a review of the entire order guide request before submission.
    • Instance Options: Customizable settings accessible by pressing Ctrl and clicking the widget to select Instance Options, including:
      • Presentation Title: Sets the display name of the order guide widget.
      • Bootstrap Color: Defines the widget’s color theme based on Branding Editor choices.
      • Show More/Less on Mobile: Enables toggling full or truncated descriptions for order guides and catalog items in mobile views.
      • Compact Mode: Optimizes widget layout for smaller screen areas (less than 6x6).
      • Hide Delivery Time: Option to hide delivery times for catalog items within accordions (not applicable on summary page).
      • Show Add to Cart: Controls visibility of the Add to Cart button on the order guide summary page.

    Practical Use and Benefits

    This widget streamlines complex ordering processes by grouping related catalog items into a single guided request, improving user experience and order accuracy. The configurable toggle and mandatory settings provide flexibility in controlling which items must be included, ensuring requests meet business requirements without overwhelming users. The summary review offers a final confirmation to reduce errors. Instance options allow branding and display customization to fit your portal’s look and feel and device considerations.

    Next Steps

    • Create and configure order guides in the platform UI under Service Catalog settings.
    • Use the widget as provided or clone it to tailor functionality and appearance.
    • Customize widget instance options to align with your portal branding and user experience goals.
    • Leverage related widgets and concepts like the Catalog Content widget, Request Fields widget, and SC Shopping Cart widget to build a comprehensive catalog experience.

    Use this widget (widget-sc-order-guide-v2) to request an order guide, that is, a single service catalog request for several catalog items with a specific purpose. You can use this base system widget as-is in your portal or clone it to suit your own business needs.

    Configure order guides using the Service Catalog in the platform UI by navigating to Service Catalog > Catalog Definitions > Order Guides.

    The order guide form comprises the following sections:

    Describe Needs

    This section displays the following that are associated with the order guide:

    • Image
    • Description
    • Variables

    Choose Options

    This section displays a list of catalog items included in the order guide based on the information provided in the Describe Needs section and the rule base configured for the order guide. Each catalog item is displayed with its name and description on an accordion.

    Each accordion displays:
    • Options, if a catalog item has fields that need user inputs.
      Note:
      If the fields are mandatory, a red asterisk is displayed beside Options.
    • A toggle to include the catalog item in the order guide request. You can make it mandatory to include all items in the order guide request by not displaying the toggle. You can make it optional to include items in the order guide request by displaying the toggle. To display the toggle for each catalog item of the order guide, select the Show Include Toggle (Service Portal) check box while configuring the order guide. For more information, see Create an order guide .
      Note:
      When an item is excluded from the order guide request, the item is not editable and the corresponding mandatory field restrictions are ignored.

    Summary

    This section provides a summary of the order guide that you can review before requesting the order guide.

    Instance options

    Use the widget instance options to customize the settings for the SC Order Guide widget. To customize the settings for this widget, press the Ctrl key, click on the widget, and select Instance Options.

    Table 1. Instance options for the SC Order Guide widget
    Field Description
    Presentation
    Title Name of the order guide.
    Bootstrap Color Color of the widget based on the selections made in the Branding Editor.
    Enable Show More/Less for Item description on Mobile Enables the Show more or Show less options for the description of the order guide or the associated catalog items in the mobile view. By default, the Show more option is available.
    • Click Show more to display the entire description.
    • Click Show less to display only 150 characters of the description.
    Note:
    This instance option is applicable for the description of the order guide in the Describe Needs section, and the description of the associated catalog items in the Choose Options section.
    Compact Mode Displays the widget in the compact mode when configured for smaller real estates (less than 6*6).
    Hide Delivery Time Hides the delivery time for each catalog item in the accordion. It is not applicable for the order guide summary page and the delivery time is never displayed on the summary page.
    Behavior
    Show Add to Cart Option to display the Add to Cart button on the order guide summary page.