--- title: SavedSearch - GraphQL Admin description: >- A representation of a search query in the Shopify admin used on resource index views. Preserves complex queries with search terms and filters, enabling merchants to quickly access frequently used data views. For example, a saved search can be applied to the product index table to filter products. The query string combines free-text search terms with structured filters to narrow results based on resource attributes. The search applies to a specific resource type such as [`Customer`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Customer), [`Product`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Product), [`Order`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Order), or [`Collection`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Collection) objects. api_version: 2025-10 api_name: admin type: object api_type: graphql source_url: html: 'https://shopify.dev/docs/api/admin-graphql/latest/objects/SavedSearch' md: 'https://shopify.dev/docs/api/admin-graphql/latest/objects/SavedSearch.md' --- # Saved​Search object A representation of a search query in the Shopify admin used on resource index views. Preserves complex queries with search terms and filters, enabling merchants to quickly access frequently used data views. For example, a saved search can be applied to the product index table to filter products. The query string combines free-text search terms with structured filters to narrow results based on resource attributes. The search applies to a specific resource type such as [`Customer`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Customer), [`Product`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Product), [`Order`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Order), or [`Collection`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Collection) objects. ## Fields * filters [\[Search​Filter!\]!](https://shopify.dev/docs/api/admin-graphql/latest/objects/SearchFilter) non-null The filters of a saved search. * id [ID!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/ID) non-null A globally-unique ID. * legacy​Resource​Id [Unsigned​Int64!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/UnsignedInt64) non-null The ID of the corresponding resource in the REST Admin API. * name [String!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String) non-null The name of a saved search. * query [String!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String) non-null The query string of a saved search. This includes search terms and filters. * resource​Type [Search​Result​Type!](https://shopify.dev/docs/api/admin-graphql/latest/enums/SearchResultType) non-null The type of resource this saved search is searching in. * search​Terms [String!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String) non-null The search terms of a saved search. *** ## Map ### Fields and connections with this object * <->[SavedSearchConnection.nodes](https://shopify.dev/docs/api/admin-graphql/latest/connections/SavedSearchConnection#returns-nodes) * {}[SavedSearchEdge.node](https://shopify.dev/docs/api/admin-graphql/latest/objects/SavedSearchEdge#field-SavedSearchEdge.fields.node) *** ## Queries * [automatic​Discount​Saved​Searches](https://shopify.dev/docs/api/admin-graphql/latest/queries/automaticDiscountSavedSearches) query List of the shop's automatic discount saved searches. * [code​Discount​Saved​Searches](https://shopify.dev/docs/api/admin-graphql/latest/queries/codeDiscountSavedSearches) query List of the shop's code discount saved searches. * [collection​Saved​Searches](https://shopify.dev/docs/api/admin-graphql/latest/queries/collectionSavedSearches) query Returns a list of the shop's collection saved searches. * [customer​Saved​Searches](https://shopify.dev/docs/api/admin-graphql/latest/queries/customerSavedSearches) query List of the shop's customer saved searches. * [discount​Redeem​Code​Saved​Searches](https://shopify.dev/docs/api/admin-graphql/latest/queries/discountRedeemCodeSavedSearches) query List of the shop's redeemed discount code saved searches. * [draft​Order​Saved​Searches](https://shopify.dev/docs/api/admin-graphql/latest/queries/draftOrderSavedSearches) query List of the shop's draft order saved searches. * [file​Saved​Searches](https://shopify.dev/docs/api/admin-graphql/latest/queries/fileSavedSearches) query A list of the shop's file saved searches. * [order​Saved​Searches](https://shopify.dev/docs/api/admin-graphql/latest/queries/orderSavedSearches) query Returns [saved searches](https://shopify.dev/docs/api/admin-graphql/latest/objects/SavedSearch) for orders in the shop. Saved searches store search queries with their filters and search terms. * [product​Saved​Searches](https://shopify.dev/docs/api/admin-graphql/latest/queries/productSavedSearches) query Returns a list of the shop's product saved searches. * [url​Redirect​Saved​Searches](https://shopify.dev/docs/api/admin-graphql/latest/queries/urlRedirectSavedSearches) query A list of the shop's URL redirect saved searches. *** ## \SavedSearch Queries ### Queried by * \[automatic​Discount​Saved​Searches](https://shopify.dev/docs/api/admin-graphql/latest/queries/automaticDiscountSavedSearches) * \[code​Discount​Saved​Searches](https://shopify.dev/docs/api/admin-graphql/latest/queries/codeDiscountSavedSearches) * \[collection​Saved​Searches](https://shopify.dev/docs/api/admin-graphql/latest/queries/collectionSavedSearches) * \[customer​Saved​Searches](https://shopify.dev/docs/api/admin-graphql/latest/queries/customerSavedSearches) * \[discount​Redeem​Code​Saved​Searches](https://shopify.dev/docs/api/admin-graphql/latest/queries/discountRedeemCodeSavedSearches) * \[draft​Order​Saved​Searches](https://shopify.dev/docs/api/admin-graphql/latest/queries/draftOrderSavedSearches) * \[file​Saved​Searches](https://shopify.dev/docs/api/admin-graphql/latest/queries/fileSavedSearches) * \[order​Saved​Searches](https://shopify.dev/docs/api/admin-graphql/latest/queries/orderSavedSearches) * \[product​Saved​Searches](https://shopify.dev/docs/api/admin-graphql/latest/queries/productSavedSearches) * \[url​Redirect​Saved​Searches](https://shopify.dev/docs/api/admin-graphql/latest/queries/urlRedirectSavedSearches) *** ## Mutations * [saved​Search​Create](https://shopify.dev/docs/api/admin-graphql/latest/mutations/savedSearchCreate) mutation Creates a saved search. * [saved​Search​Update](https://shopify.dev/docs/api/admin-graphql/latest/mutations/savedSearchUpdate) mutation Updates a saved search. *** ## <\~> SavedSearch Mutations ### Mutated by * <\~>[saved​Search​Create](https://shopify.dev/docs/api/admin-graphql/latest/mutations/savedSearchCreate) * <\~>[saved​Search​Update](https://shopify.dev/docs/api/admin-graphql/latest/mutations/savedSearchUpdate) *** ## Interfaces * * [Legacy​Interoperability](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/LegacyInteroperability) interface * [Node](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Node) interface *** ## ||-SavedSearch Implements ### Implements * ||-[Legacy​Interoperability](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/LegacyInteroperability) * ||-[Node](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Node)