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 London Platform Capabilities Now Platform capabilities Service Portal Service Portal search Add facets to a simple search source

    Add facets to a simple search source

    • 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

    Add facets to a simple search source

    Enable end users to refine search results for a simple search source. You can create facets for a table search source that return results based on field values or query conditions.

    Before you begin

    Role required: admin or sp_admin

    In new instances, search facets are enabled by default. If upgrading from a previous release, enable search facets by activating a record in the Page Route Maps [sp_page_route_map] table. See Enable search facets. Create facet items and mapped queries with no more than 30 filter items. To verify, test each search source with a variety of keywords as a user with low permissions.

    Note: Only set search facets for indexed fields. Fields that are not indexed may take longer to return results and are not optimized for a fast search experience. Learn more: Enable text indexing for a table.

    Procedure

    1. Navigate to Service Portal > Search Sources.
    2. Open or create a simple search source.
      Simple search sources do not use a data fetch script. Rather, they define a table as the source of searchable data. To learn more about search sources, see Service Portal search.
    3. Select the Facets related list.
    4. Click New.
      The Facet form displays.
    5. Complete the fields.
      Field Description
      Name Display name of the facet header.
      Application Application scope of the search source. This value is read-only.
      Selection type Type of user selection allowed:
      • Single: Only one filter value can be selected at a time. For example, if a facet is created for the Assigned to field, the end user can select Fred Luddy or Beth Anglin, but not both at the same time. Before filtering for a new value, the user must first clear the current value.
      • Multiple: Multiple filter values can be selected at the same time. For example, if a facet is created for the Assigned to field, the end user can select both Fred Luddy and Beth Anglin. Because multi choice results in an OR query, records assigned to either Fred Luddy or Beth Anglin display.
      Active Whether the filter option displays in search results.
      Use mapped facet filters Maps a facet to a query condition, such as [Updated][After][Last week].

      When selected, the Fields and Sort fields are removed from the form. After saving, define filters in the Facet Filters related list.

      Order Defines the display order when multiple facets are defined.

      If some facets do not have an order value defined, facets with an order defined display first. Facets without an order defined are displayed alphabetically.

      Table Table that the query is created for. This value is read-only and defined by the table used in the search source.
      Field

      Field that end users can filter search results by. For example, if Active is selected, the user can filter search results by true or false.

      Only fields of the following types are supported: True/False, Choice, Decimal, Floating Point Number, Integer, IP Address, Long, Reference, String, String (Full UTF-8), and URL.

      Sort Determines the order in which filter options display.
      • Ascending: Sorts filter options from A to Z when alphabetical, and from lowest to highest when numerical. This is the default option.
      • Descending: Sorts filter options from Z to A when alphabetical, and from highest to lowest when numerical.
    6. Save the record.
      If Use mapped facet filters is selected, the Facet Filters related list appears in the facet form.
    7. (Optional) If Use mapped facet filters is selected, define facet filters. Map facet filters map a query condition to a facet label. When the end user selects the label from the facet list, the defined query executes.
      1. In the Facet Filters related list, click New.
        The Mapped Facet Form appears.
      2. Define the facet filter fields.
        Field Description
        Name Display name of the facet filter option.
        Order Defines the display order when multiple facet filters are defined.

        If some facet filters do not have an order value defined, facets filters with an order defined display first. Facet filters without an order defined are displayed alphabetically.

        Application The application scope of the search source. This value is read-only.
        Facet The search facet that uses the mapped query. This value is read-only.
        Table The table defined in the search facet. This value is read-only.
        Mapped query A query condition that users can set to filter search results. For example, [Updated][On][Today].
      3. Click Submit.
        Users can filter search results based on the query defined.

    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

      Add facets to a simple search source

      • 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

      Add facets to a simple search source

      Enable end users to refine search results for a simple search source. You can create facets for a table search source that return results based on field values or query conditions.

      Before you begin

      Role required: admin or sp_admin

      In new instances, search facets are enabled by default. If upgrading from a previous release, enable search facets by activating a record in the Page Route Maps [sp_page_route_map] table. See Enable search facets. Create facet items and mapped queries with no more than 30 filter items. To verify, test each search source with a variety of keywords as a user with low permissions.

      Note: Only set search facets for indexed fields. Fields that are not indexed may take longer to return results and are not optimized for a fast search experience. Learn more: Enable text indexing for a table.

      Procedure

      1. Navigate to Service Portal > Search Sources.
      2. Open or create a simple search source.
        Simple search sources do not use a data fetch script. Rather, they define a table as the source of searchable data. To learn more about search sources, see Service Portal search.
      3. Select the Facets related list.
      4. Click New.
        The Facet form displays.
      5. Complete the fields.
        Field Description
        Name Display name of the facet header.
        Application Application scope of the search source. This value is read-only.
        Selection type Type of user selection allowed:
        • Single: Only one filter value can be selected at a time. For example, if a facet is created for the Assigned to field, the end user can select Fred Luddy or Beth Anglin, but not both at the same time. Before filtering for a new value, the user must first clear the current value.
        • Multiple: Multiple filter values can be selected at the same time. For example, if a facet is created for the Assigned to field, the end user can select both Fred Luddy and Beth Anglin. Because multi choice results in an OR query, records assigned to either Fred Luddy or Beth Anglin display.
        Active Whether the filter option displays in search results.
        Use mapped facet filters Maps a facet to a query condition, such as [Updated][After][Last week].

        When selected, the Fields and Sort fields are removed from the form. After saving, define filters in the Facet Filters related list.

        Order Defines the display order when multiple facets are defined.

        If some facets do not have an order value defined, facets with an order defined display first. Facets without an order defined are displayed alphabetically.

        Table Table that the query is created for. This value is read-only and defined by the table used in the search source.
        Field

        Field that end users can filter search results by. For example, if Active is selected, the user can filter search results by true or false.

        Only fields of the following types are supported: True/False, Choice, Decimal, Floating Point Number, Integer, IP Address, Long, Reference, String, String (Full UTF-8), and URL.

        Sort Determines the order in which filter options display.
        • Ascending: Sorts filter options from A to Z when alphabetical, and from lowest to highest when numerical. This is the default option.
        • Descending: Sorts filter options from Z to A when alphabetical, and from highest to lowest when numerical.
      6. Save the record.
        If Use mapped facet filters is selected, the Facet Filters related list appears in the facet form.
      7. (Optional) If Use mapped facet filters is selected, define facet filters. Map facet filters map a query condition to a facet label. When the end user selects the label from the facet list, the defined query executes.
        1. In the Facet Filters related list, click New.
          The Mapped Facet Form appears.
        2. Define the facet filter fields.
          Field Description
          Name Display name of the facet filter option.
          Order Defines the display order when multiple facet filters are defined.

          If some facet filters do not have an order value defined, facets filters with an order defined display first. Facet filters without an order defined are displayed alphabetically.

          Application The application scope of the search source. This value is read-only.
          Facet The search facet that uses the mapped query. This value is read-only.
          Table The table defined in the search facet. This value is read-only.
          Mapped query A query condition that users can set to filter search results. For example, [Updated][On][Today].
        3. Click Submit.
          Users can filter search results based on the query defined.

      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