CatalogSearch - Scoped

  • Release version: Australia
  • Updated March 12, 2026
  • 1 minute to read
  • The CatalogSearch API provides methods that enable you to search catalog items.

    To use this class in a scoped application, use the sn_sc namespace identifier. The Service Catalog Scoped API plugin (ID: com.glideapp.servicecatalog.scoped.api) that is enabled by default is required to access the CatalogSearch API.

    CatalogSearch - CatalogSearch()

    Creates an instance of the CatalogSearch class.

    Table 1. Parameters
    Name Type Description
    None
    var catSearchGR = new sn_sc.CatalogSearch().search('', '', 'Apple', false, true);
    catSearchGR.query();
    while(catSearchGR.next()) {
      gs.info(catSearchGR.getValue('name'));
    }

    CatalogSearch - search (String catalogID, String categoryID, String term, Boolean mobile, Boolean noDepthSearch)

    Searches a catalog item based on a search term. The search can be narrowed down to a catalog category level.

    Table 2. Parameters
    Name Type Description
    catalogID String Identifier of the catalog to search.
    categoryID String Identifier of the catalog category to search.
    term String Search term.
    mobile Boolean Flag that indicates whether catalog items exposed for mobile are searched.
    Valid values:
    • true: Search for mobile catalog items.
    • false: Do not search for mobile catalog items.
    noDepthSearch Boolean Flag that indicates whether to search subcategories.
    Valid values:
    • true: Do not search subcategories.
    • false: Search subcategories.
    Table 3. Returns
    Type Description
    GlideRecord Returns the GlideRecord on sc_cat_item matching the search result.

    This example shows how to search all catalogs and all categories for term: ServiceNow.

    var now_GR = new sn_sc.CatalogSearch().search('', '', 'ServiceNow', false, false);
    now_GR.query();
    while(now_GR.next()) {
      gs.log(now_GR.name);
    }

    Output:

    ServiceNow T-shirt