--- title: QueryRoot - GraphQL Admin description: The schema's entry-point for queries. This acts as the public, top-level API from which all queries must start. api_version: 2025-07 api_name: admin type: object api_type: graphql source_url: html: https://shopify.dev/docs/api/admin-graphql/2025-07/objects/QueryRoot md: https://shopify.dev/docs/api/admin-graphql/2025-07/objects/QueryRoot.md --- # Query​Root object The schema's entry-point for queries. This acts as the public, top-level API from which all queries must start. ## Fields * abandoned​Checkouts [Abandoned​Checkout​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/AbandonedCheckoutConnection) non-null List of abandoned checkouts. Includes checkouts that were recovered after being abandoned. * abandoned​Checkouts​Count [Count](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/Count) Returns the count of abandoned checkouts for the given shop. Limited to a maximum of 10000 by default. * abandonment [Abandonment](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/Abandonment) Returns a `Abandonment` resource by ID. * abandonment​By​Abandoned​Checkout​Id [Abandonment](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/Abandonment) Returns an Abandonment by the Abandoned Checkout ID. * app [App](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/App) Lookup an App by ID or return the currently authenticated App. * app​By​Handle [App](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/App) Fetches app by handle. Returns null if the app doesn't exist. * app​By​Key [App](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/App) Fetches an app by its client ID. Returns null if the app doesn't exist. * app​Discount​Type [App​Discount​Type](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/AppDiscountType) An app discount type. * app​Discount​Types [\[App​Discount​Type!\]!](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/AppDiscountType) non-null A list of app discount types installed by apps. * app​Discount​Types​Nodes [App​Discount​Type​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/AppDiscountTypeConnection) non-null A list of app discount types installed by apps. * app​Installation [App​Installation](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/AppInstallation) Look up an app installation by ID or return the app installation for the currently authenticated app. Use the `appInstallation` query to: * Fetch current access scope permissions for your app * Retrieve active subscription details and billing status * Validate installation state during app initialization * Display installation-specific information in your app interface Learn more about [app installation](https://shopify.dev/docs/apps/build/authentication-authorization/app-installation). * app​Installations [App​Installation​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/AppInstallationConnection) non-null A list of app installations. To use this query, your app needs the `read_apps` access scope, which can only be requested after you're granted approval from [Shopify Support](https://partners.shopify.com/current/support/). This scope can be granted to custom and public apps. Returns a paginated connection of `AppInstallation` objects across multiple stores. Learn more about [app installation](https://shopify.dev/docs/apps/build/authentication-authorization/app-installation). * article [Article](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/Article) Returns a `Article` resource by ID. * article​Authors [Article​Author​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/ArticleAuthorConnection) non-null List of article authors for the shop. * articles [Article​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/ArticleConnection) non-null List of the shop's articles. * article​Tags [\[String!\]!](https://shopify.dev/docs/api/admin-graphql/2025-07/scalars/String) non-null List of all article tags. * sort [Article​Tag​Sort](https://shopify.dev/docs/api/admin-graphql/2025-07/enums/ArticleTagSort) Default:ALPHABETICAL ### Arguments Type of sort order. * limit [Int!](https://shopify.dev/docs/api/admin-graphql/2025-07/scalars/Int) required The maximum number of tags to return. *** * assigned​Fulfillment​Orders [Fulfillment​Order​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/FulfillmentOrderConnection) non-null The paginated list of fulfillment orders assigned to the shop locations owned by the app. Assigned fulfillment orders are fulfillment orders that are set to be fulfilled from locations managed by [fulfillment services](https://shopify.dev/api/admin-graphql/latest/objects/FulfillmentService) that are registered by the app. One app (api\_client) can host multiple fulfillment services on a shop. Each fulfillment service manages a dedicated location on a shop. Assigned fulfillment orders can have associated [fulfillment requests](https://shopify.dev/api/admin-graphql/latest/enums/FulfillmentOrderRequestStatus), or might currently not be requested to be fulfilled. The app must have the `read_assigned_fulfillment_orders` [access scope](https://shopify.dev/docs/api/usage/access-scopes) to be able to retrieve the fulfillment orders assigned to its locations. All assigned fulfillment orders (except those with the `CLOSED` status) will be returned by default. Perform filtering with the `assignmentStatus` argument to receive only fulfillment orders that have been requested to be fulfilled. * automatic​Discount​Node [Discount​Automatic​Node](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/DiscountAutomaticNode) Returns a `DiscountAutomaticNode` resource by ID. * automatic​Discount​Nodes [Discount​Automatic​Node​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/DiscountAutomaticNodeConnection) non-null Returns a list of [automatic discounts](https://help.shopify.com/manual/discounts/discount-types#automatic-discounts). * automatic​Discount​Saved​Searches [Saved​Search​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/SavedSearchConnection) non-null List of the shop's automatic discount saved searches. * available​Backup​Regions [\[Market​Region!\]!](https://shopify.dev/docs/api/admin-graphql/2025-07/interfaces/MarketRegion) non-null The regions that can be used as the backup region of the shop. * available​Carrier​Services [\[Delivery​Carrier​Service​And​Locations!\]!](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/DeliveryCarrierServiceAndLocations) non-null Returns a list of activated carrier services and associated shop locations that support them. * available​Locales [\[Locale!\]!](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/Locale) non-null A list of available locales. * backup​Region [Market​Region!](https://shopify.dev/docs/api/admin-graphql/2025-07/interfaces/MarketRegion) non-null The backup region of the shop. * blog [Blog](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/Blog) Returns a `Blog` resource by ID. * blogs [Blog​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/BlogConnection) non-null List of the shop's blogs. * blogs​Count [Count](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/Count) Count of blogs. Limited to a maximum of 10000 by default. * business​Entities [\[Business​Entity!\]!](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/BusinessEntity) non-null Returns a list of Business Entities associated with the shop. * business​Entity [Business​Entity](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/BusinessEntity) Returns a Business Entity by ID. * carrier​Service [Delivery​Carrier​Service](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/DeliveryCarrierService) Returns a `DeliveryCarrierService` resource by ID. * carrier​Services [Delivery​Carrier​Service​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/DeliveryCarrierServiceConnection) non-null Retrieve a list of CarrierServices. * cart​Transforms [Cart​Transform​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/CartTransformConnection) non-null Retrieves all cart transform functions currently deployed by your app within the merchant's store. This query provides comprehensive access to your active cart modification logic, enabling management and monitoring of bundling and merchandising features. The query returns paginated results with full cart transform details, including function IDs, configuration settings, and operational status. Cart Transform ownership is scoped to your API client, ensuring you only see and manage functions deployed by your specific app. This isolation prevents conflicts between different apps while maintaining security boundaries for sensitive merchandising logic. Learn more about [managing cart transforms](https://shopify.dev/docs/api/functions/latest/cart-transform). * cash​Tracking​Session [Cash​Tracking​Session](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/CashTrackingSession) Returns a `CashTrackingSession` resource by ID. * cash​Tracking​Sessions [Cash​Tracking​Session​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/CashTrackingSessionConnection) non-null Returns a shop's cash tracking sessions for locations with a POS Pro subscription. Tip: To query for cash tracking sessions in bulk, you can [perform a bulk operation](https://shopify.dev/docs/api/usage/bulk-operations/queries). * catalog [Catalog](https://shopify.dev/docs/api/admin-graphql/2025-07/interfaces/Catalog) Retrieves a [catalog](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Catalog) by its ID. A catalog represents a list of products with publishing and pricing information, and can be associated with a context, such as a market, company location, or app. Use the `catalog` query to retrieve information associated with the following workflows: * Managing product publications across different contexts * Setting up contextual pricing with price lists * Managing market-specific product availability * Configuring B2B customer catalogs There are several types of catalogs: * [`MarketCatalog`](https://shopify.dev/docs/api/admin-graphql/latest/objects/MarketCatalog) * [`AppCatalog`](https://shopify.dev/docs/api/admin-graphql/latest/objects/AppCatalog) * [`CompanyLocationCatalog`](https://shopify.dev/docs/api/admin-graphql/latest/objects/CompanyLocationCatalog) Learn more about [catalogs for different markets](https://shopify.dev/docs/apps/build/markets/catalogs-different-markets). * catalog​Operations [\[Resource​Operation!\]!](https://shopify.dev/docs/api/admin-graphql/2025-07/interfaces/ResourceOperation) non-null Returns the most recent catalog operations for the shop. * catalogs [Catalog​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/CatalogConnection) non-null The catalogs belonging to the shop. * catalogs​Count [Count](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/Count) The count of catalogs belonging to the shop. Limited to a maximum of 10000 by default. * checkout​Branding [Checkout​Branding](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/CheckoutBranding) Returns the visual customizations for checkout for a given checkout profile. To learn more about updating checkout branding settings, refer to the [checkoutBrandingUpsert](https://shopify.dev/api/admin-graphql/unstable/mutations/checkoutBrandingUpsert) mutation and the checkout branding [tutorial](https://shopify.dev/docs/apps/checkout/styling). * checkout​Profile [Checkout​Profile](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/CheckoutProfile) A checkout profile on a shop. * checkout​Profiles [Checkout​Profile​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/CheckoutProfileConnection) non-null List of checkout profiles on a shop. * code​Discount​Node [Discount​Code​Node](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/DiscountCodeNode) Returns a [code discount](https://help.shopify.com/manual/discounts/discount-types#discount-codes) resource by ID. * code​Discount​Node​By​Code [Discount​Code​Node](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/DiscountCodeNode) Returns a code discount identified by its discount code. * code​Discount​Nodes [Discount​Code​Node​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/DiscountCodeNodeConnection) non-null Returns a list of [code-based discounts](https://help.shopify.com/manual/discounts/discount-types#discount-codes). * code​Discount​Saved​Searches [Saved​Search​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/SavedSearchConnection) non-null List of the shop's code discount saved searches. * collection [Collection](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/Collection) Retrieves a [collection](https://shopify.dev/docs/api/admin-graphql/latest/objects/Collection) by its ID. A collection represents a grouping of [products](https://shopify.dev/docs/api/admin-graphql/latest/objects/Product) that merchants can display and sell as a group in their [online store](https://shopify.dev/docs/apps/build/online-store) and other [sales channels](https://shopify.dev/docs/apps/build/sales-channels). Use the `collection` query when you need to: * Manage collection publishing across sales channels * Access collection metadata and SEO information * Work with collection rules and product relationships A collection can be either a custom ([manual](https://help.shopify.com/manual/products/collections/manual-shopify-collection)) collection where products are manually added, or a smart ([automated](https://help.shopify.com/manual/products/collections/automated-collections)) collection where products are automatically included based on defined rules. Each collection has associated metadata including title, description, handle, image, and [metafields](https://shopify.dev/docs/apps/build/custom-data/metafields). * collection​By​Identifier [Collection](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/Collection) Return a collection by an identifier. * collection​Rules​Conditions [\[Collection​Rule​Conditions!\]!](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/CollectionRuleConditions) non-null Lists all rules that can be used to create smart collections. * collections [Collection​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/CollectionConnection) non-null Retrieves a list of [collections](https://shopify.dev/docs/api/admin-graphql/latest/objects/Collection) in a store. Collections are groups of [products](https://shopify.dev/docs/api/admin-graphql/latest/objects/Product) that merchants can organize for display in their [online store](https://shopify.dev/docs/apps/build/online-store) and other [sales channels](https://shopify.dev/docs/apps/build/sales-channels). For example, an athletics store might create different collections for running attire, shoes, and accessories. Use the `collections` query when you need to: * Build a browsing interface for a store's product groupings. * Create collection searching, sorting, and filtering experiences (for example, by title, type, or published status). * Sync collection data with external systems. * Manage both custom ([manual](https://help.shopify.com/manual/products/collections/manual-shopify-collection)) and smart ([automated](https://help.shopify.com/manual/products/collections/automated-collections)) collections. The `collections` query supports [pagination](https://shopify.dev/docs/api/usage/pagination-graphql) for large catalogs and [saved searches](https://shopify.dev/docs/api/admin-graphql/latest/queries/collections#arguments-savedSearchId) for frequently used collection queries. The `collections` query returns collections with their associated metadata, including: * Basic collection information (title, description, handle, and type) * Collection image and SEO metadata * Product count and product relationships * Collection rules (for smart collections) * Publishing status and publication details * Metafields and custom attributes Learn more about [using metafields with smart collections](https://shopify.dev/docs/apps/build/custom-data/metafields/use-metafield-capabilities). * collection​Saved​Searches [Saved​Search​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/SavedSearchConnection) non-null Returns a list of the shop's collection saved searches. * collections​Count [Count](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/Count) Count of collections. Limited to a maximum of 10000 by default. * comment [Comment](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/Comment) Returns a `Comment` resource by ID. * comments [Comment​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/CommentConnection) non-null List of the shop's comments. * companies [Company​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/CompanyConnection) non-null Returns the list of companies in the shop. * companies​Count [Count](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/Count) The number of companies for a shop. Limited to a maximum of 10000 by default. * company [Company](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/Company) Returns a `Company` resource by ID. * company​Contact [Company​Contact](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/CompanyContact) Returns a `CompanyContact` resource by ID. * company​Contact​Role [Company​Contact​Role](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/CompanyContactRole) Returns a `CompanyContactRole` resource by ID. * company​Location [Company​Location](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/CompanyLocation) Returns a `CompanyLocation` resource by ID. * company​Locations [Company​Location​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/CompanyLocationConnection) non-null Returns the list of company locations in the shop. * consent​Policy [\[Consent​Policy!\]!](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/ConsentPolicy) non-null Returns the customer privacy consent policies of a shop. * consent​Policy​Regions [\[Consent​Policy​Region!\]!](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/ConsentPolicyRegion) non-null List of countries and regions for which consent policies can be created or updated. * current​App​Installation [App​Installation!](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/AppInstallation) non-null Return the AppInstallation for the currently authenticated App. * current​Bulk​Operation [Bulk​Operation](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/BulkOperation) Returns the current app's most recent BulkOperation. Apps can run one bulk query and one bulk mutation operation at a time, by shop. * current​Staff​Member [Staff​Member](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/StaffMember) The staff member making the API request. * customer [Customer](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/Customer) Returns a `Customer` resource by ID. * customer​Account​Page [Customer​Account​Page](https://shopify.dev/docs/api/admin-graphql/2025-07/interfaces/CustomerAccountPage) Returns a `CustomerAccountPage` resource by ID. * customer​Account​Pages [Customer​Account​Page​Connection](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/CustomerAccountPageConnection) List of the shop's customer account pages. * customer​By​Identifier [Customer](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/Customer) Return a customer by an identifier. * customer​Merge​Job​Status [Customer​Merge​Request](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/CustomerMergeRequest) Returns the status of a customer merge request job. * customer​Merge​Preview [Customer​Merge​Preview!](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/CustomerMergePreview) non-null Returns a preview of a customer merge request. * customer​Payment​Method [Customer​Payment​Method](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/CustomerPaymentMethod) Returns a CustomerPaymentMethod resource by its ID. * customers [Customer​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/CustomerConnection) non-null Returns a list of [customers](https://shopify.dev/api/admin-graphql/latest/objects/Customer) in your Shopify store, including key information such as name, email, location, and purchase history. Use this query to segment your audience, personalize marketing campaigns, or analyze customer behavior by applying filters based on location, order history, marketing preferences and tags. The `customers` query supports [pagination](https://shopify.dev/api/usage/pagination-graphql) and [sorting](https://shopify.dev/api/admin-graphql/latest/enums/CustomerSortKeys). * customer​Saved​Searches [Saved​Search​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/SavedSearchConnection) non-null List of the shop's customer saved searches. * customers​Count [Count](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/Count) The number of customers. Limited to a maximum of 10000 by default. * customer​Segment​Members [Customer​Segment​Member​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/CustomerSegmentMemberConnection) non-null The list of members, such as customers, that's associated with an individual segment. The maximum page size is 1000. * customer​Segment​Membership [Segment​Membership​Response!](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/SegmentMembershipResponse) non-null Whether a member, which is a customer, belongs to a segment. * customer​Segment​Members​Query [Customer​Segment​Members​Query](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/CustomerSegmentMembersQuery) Returns a `CustomerSegmentMembersQuery` resource by ID. * delivery​Customization [Delivery​Customization](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/DeliveryCustomization) The delivery customization. * delivery​Customizations [Delivery​Customization​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/DeliveryCustomizationConnection) non-null The delivery customizations. * delivery​Profile [Delivery​Profile](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/DeliveryProfile) Returns a Delivery Profile resource by ID. * delivery​Profiles [Delivery​Profile​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/DeliveryProfileConnection) non-null Returns a list of saved delivery profiles. * delivery​Promise​Participants [Delivery​Promise​Participant​Connection](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/DeliveryPromiseParticipantConnection) Returns delivery promise participants. * delivery​Promise​Provider [Delivery​Promise​Provider](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/DeliveryPromiseProvider) Lookup a delivery promise provider. * delivery​Promise​Settings [Delivery​Promise​Setting!](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/DeliveryPromiseSetting) non-null Represents the delivery promise settings for a shop. * delivery​Settings [Delivery​Setting](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/DeliverySetting) Returns the shop-wide shipping settings. * discount​Codes​Count [Count](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/Count) The total number of discount codes for the shop. Limited to a maximum of 10000 by default. * discount​Node [Discount​Node](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/DiscountNode) Returns a `DiscountNode` resource by ID. * discount​Nodes [Discount​Node​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/DiscountNodeConnection) non-null Returns a list of discounts. * discount​Nodes​Count [Count](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/Count) The total number of discounts for the shop. Limited to a maximum of 10000 by default. * discount​Redeem​Code​Bulk​Creation [Discount​Redeem​Code​Bulk​Creation](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/DiscountRedeemCodeBulkCreation) Returns a `DiscountRedeemCodeBulkCreation` resource by ID. * discount​Redeem​Code​Saved​Searches [Saved​Search​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/SavedSearchConnection) non-null List of the shop's redeemed discount code saved searches. * dispute [Shopify​Payments​Dispute](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/ShopifyPaymentsDispute) Returns a `ShopifyPaymentsDispute` resource by ID. * dispute​Evidence [Shopify​Payments​Dispute​Evidence](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/ShopifyPaymentsDisputeEvidence) Returns a `ShopifyPaymentsDisputeEvidence` resource by ID. * disputes [Shopify​Payments​Dispute​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/ShopifyPaymentsDisputeConnection) non-null All disputes related to the Shop. * domain [Domain](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/Domain) Returns a `Domain` resource by ID. * draft​Order [Draft​Order](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/DraftOrder) Retrieves a [draft order](https://shopify.dev/docs/api/admin-graphql/latest/objects/DraftOrder) by its ID. A draft order is an order created by a merchant on behalf of their customers. Draft orders contain all necessary order details (products, pricing, customer information) but require payment to be accepted before they can be converted into [completed orders](https://shopify.dev/docs/api/admin-graphql/latest/mutations/draftOrderComplete). Use the `draftOrder` query to retrieve information associated with the following workflows: * Creating orders for phone, in-person, or chat sales * Sending invoices to customers with secure checkout links * Managing custom items and additional costs * Selling products at discount or wholesale rates * Processing pre-orders and saving drafts for later completion A draft order is associated with a [customer](https://shopify.dev/docs/api/admin-graphql/latest/objects/Customer) and contains multiple [line items](https://shopify.dev/docs/api/admin-graphql/latest/objects/DraftOrderLineItem). Each draft order has a [status](https://shopify.dev/docs/api/admin-graphql/latest/objects/DraftOrder#field-DraftOrder.fields.status), which indicates its progress through the sales workflow. * draft​Order​Available​Delivery​Options [Draft​Order​Available​Delivery​Options!](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/DraftOrderAvailableDeliveryOptions) non-null Returns a list of available delivery options for a draft order. * draft​Orders [Draft​Order​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/DraftOrderConnection) non-null List of saved draft orders. * draft​Order​Saved​Searches [Saved​Search​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/SavedSearchConnection) non-null List of the shop's draft order saved searches. * draft​Orders​Count [Count](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/Count) Returns the number of draft orders that match the query. Limited to a maximum of 10000 by default. * draft​Order​Tag [Draft​Order​Tag](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/DraftOrderTag) Returns a `DraftOrderTag` resource by ID. * event [Event](https://shopify.dev/docs/api/admin-graphql/2025-07/interfaces/Event) Get a single event by its id. * events [Event​Connection](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/EventConnection) The paginated list of events associated with the store. * events​Count [Count](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/Count) Count of events. Limited to a maximum of 10000. * files [File​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/FileConnection) non-null Retrieves a paginated list of files that have been uploaded to a Shopify store. Files represent digital assets that merchants can upload to their store for various purposes including product images, marketing materials, documents, and brand assets. Use the `files` query to retrieve information associated with the following workflows: * [Managing product media and images](https://shopify.dev/docs/apps/build/online-store/product-media) * [Theme development and asset management](https://shopify.dev/docs/storefronts/themes/store/success/brand-assets) * Brand asset management and [checkout branding](https://shopify.dev/docs/apps/build/checkout/styling/add-favicon) Files can include multiple [content types](https://shopify.dev/docs/api/admin-graphql/latest/enums/FileContentType), such as images, videos, 3D models, and generic files. Each file has properties like dimensions, file size, alt text for accessibility, and upload status. Files can be filtered by [media type](https://shopify.dev/docs/api/admin-graphql/latest/enums/MediaContentType) and can be associated with [products](https://shopify.dev/docs/api/admin-graphql/latest/objects/Product), [themes](https://shopify.dev/docs/api/admin-graphql/latest/objects/OnlineStoreTheme), and other store resources. * file​Saved​Searches [Saved​Search​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/SavedSearchConnection) non-null A list of the shop's file saved searches. * finance​App​Access​Policy [Finance​App​Access​Policy!](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/FinanceAppAccessPolicy) non-null Returns the access policy for a finance app . * finance​Kyc​Information [Finance​Kyc​Information](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/FinanceKycInformation) Returns the KYC information for the shop's Shopify Payments account, used in embedded finance apps. * fulfillment [Fulfillment](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/Fulfillment) Returns a Fulfillment resource by ID. * fulfillment​Constraint​Rules [\[Fulfillment​Constraint​Rule!\]!](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/FulfillmentConstraintRule) non-null The fulfillment constraint rules that belong to a shop. * fulfillment​Order [Fulfillment​Order](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/FulfillmentOrder) Returns a `FulfillmentOrder` resource by ID. * fulfillment​Orders [Fulfillment​Order​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/FulfillmentOrderConnection) non-null The paginated list of all fulfillment orders. The returned fulfillment orders are filtered according to the [fulfillment order access scopes](https://shopify.dev/api/admin-graphql/latest/objects/fulfillmentorder#api-access-scopes) granted to the app. Use this query to retrieve fulfillment orders assigned to merchant-managed locations, third-party fulfillment service locations, or all kinds of locations together. For fetching only the fulfillment orders assigned to the app's locations, use the [assignedFulfillmentOrders](https://shopify.dev/api/admin-graphql/2024-07/objects/queryroot#connection-assignedfulfillmentorders) connection. * fulfillment​Service [Fulfillment​Service](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/FulfillmentService) Returns a FulfillmentService resource by ID. * gift​Card [Gift​Card](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/GiftCard) Returns a gift card resource by ID. * gift​Card​Configuration [Gift​Card​Configuration!](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/GiftCardConfiguration) non-null The configuration for the shop's gift cards. * gift​Cards [Gift​Card​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/GiftCardConnection) non-null Returns a list of gift cards. * gift​Cards​Count [Count](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/Count) The total number of gift cards issued for the shop. Limited to a maximum of 10000 by default. * inventory​Item [Inventory​Item](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/InventoryItem) Returns an [InventoryItem](https://shopify.dev/docs/api/admin-graphql/latest/objects/InventoryItem) object by ID. * inventory​Items [Inventory​Item​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/InventoryItemConnection) non-null Returns a list of inventory items. * inventory​Level [Inventory​Level](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/InventoryLevel) Returns an [InventoryLevel](https://shopify.dev/docs/api/admin-graphql/latest/objects/InventoryLevel) object by ID. * inventory​Properties [Inventory​Properties!](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/InventoryProperties) non-null General inventory properties for the shop. * inventory​Shipment [Inventory​Shipment](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/InventoryShipment) Returns an inventory shipment by ID. * inventory​Transfer [Inventory​Transfer](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/InventoryTransfer) Returns an inventory transfer by ID. * inventory​Transfers [Inventory​Transfer​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/InventoryTransferConnection) non-null Returns a paginated list of transfers. * job [Job](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/Job) Returns a Job resource by ID. Used to check the status of internal jobs and any applicable changes. * location [Location](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/Location) Returns an inventory Location resource by ID. * location​By​Identifier [Location](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/Location) Return a location by an identifier. * locations [Location​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/LocationConnection) non-null Returns a list of active inventory locations. * locations​Available​For​Delivery​Profiles​Connection [Location​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/LocationConnection) non-null Returns a list of all origin locations available for a delivery profile. * locations​Count [Count](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/Count) Returns the count of locations for the given shop. Limited to a maximum of 10000 by default. * manual​Holds​Fulfillment​Orders [Fulfillment​Order​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/FulfillmentOrderConnection) non-null Returns a list of fulfillment orders that are on hold. * market [Market](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/Market) Returns a `Market` resource by ID. * marketing​Activities [Marketing​Activity​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/MarketingActivityConnection) non-null A list of marketing activities associated with the marketing app. * marketing​Activity [Marketing​Activity](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/MarketingActivity) Returns a `MarketingActivity` resource by ID. * marketing​Event [Marketing​Event](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/MarketingEvent) Returns a `MarketingEvent` resource by ID. * marketing​Events [Marketing​Event​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/MarketingEventConnection) non-null A list of marketing events associated with the marketing app. * market​Localizable​Resource [Market​Localizable​Resource](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/MarketLocalizableResource) A resource that can have localized values for different markets. * market​Localizable​Resources [Market​Localizable​Resource​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/MarketLocalizableResourceConnection) non-null Resources that can have localized values for different markets. * market​Localizable​Resources​By​Ids [Market​Localizable​Resource​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/MarketLocalizableResourceConnection) non-null Resources that can have localized values for different markets. * markets [Market​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/MarketConnection) non-null The markets configured for the shop. * markets​Resolved​Values [Markets​Resolved​Values!](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/MarketsResolvedValues) non-null The resolved values for a buyer signal. * menu [Menu](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/Menu) Returns a `Menu` resource by ID. * menus [Menu​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/MenuConnection) non-null The shop's menus. * metafield​Definition [Metafield​Definition](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/MetafieldDefinition) Returns a metafield definition by identifier. * metafield​Definitions [Metafield​Definition​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/MetafieldDefinitionConnection) non-null Returns a list of metafield definitions. * metafield​Definition​Types [\[Metafield​Definition​Type!\]!](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/MetafieldDefinitionType) non-null Each metafield definition has a type, which defines the type of information that it can store. This type is enforced across every instance of the resource that owns the metafield definition. Refer to the [list of supported metafield types](https://shopify.dev/apps/metafields/types). * metaobject [Metaobject](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/Metaobject) Retrieves a metaobject by ID. * metaobject​By​Handle [Metaobject](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/Metaobject) Retrieves a metaobject by handle. * metaobject​Definition [Metaobject​Definition](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/MetaobjectDefinition) Retrieves a metaobject definition by ID. * metaobject​Definition​By​Type [Metaobject​Definition](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/MetaobjectDefinition) Finds a metaobject definition by type. * metaobject​Definitions [Metaobject​Definition​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/MetaobjectDefinitionConnection) non-null All metaobject definitions. * metaobjects [Metaobject​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/MetaobjectConnection) non-null All metaobjects for the shop. * mobile​Platform​Application [Mobile​Platform​Application](https://shopify.dev/docs/api/admin-graphql/2025-07/unions/MobilePlatformApplication) Return a mobile platform application by its ID. * mobile​Platform​Applications [Mobile​Platform​Application​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/MobilePlatformApplicationConnection) non-null List the mobile platform applications. * node [Node](https://shopify.dev/docs/api/admin-graphql/2025-07/interfaces/Node) Returns a specific node (any object that implements the [Node](https://shopify.dev/api/admin-graphql/latest/interfaces/Node) interface) by ID, in accordance with the [Relay specification](https://relay.dev/docs/guides/graphql-server-specification/#object-identification). This field is commonly used for refetching an object. * nodes [\[Node\]!](https://shopify.dev/docs/api/admin-graphql/2025-07/interfaces/Node) non-null Returns the list of nodes (any objects that implement the [Node](https://shopify.dev/api/admin-graphql/latest/interfaces/Node) interface) with the given IDs, in accordance with the [Relay specification](https://relay.dev/docs/guides/graphql-server-specification/#object-identification). * online​Store [Online​Store!](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/OnlineStore) non-null The shop's online store channel. * order [Order](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/Order) The `order` query retrieves an [order](https://shopify.dev/docs/api/admin-graphql/latest/objects/order) by its ID. This query provides access to comprehensive order information such as customer details, line items, financial data, and fulfillment status. Use the `order` query to retrieve information associated with the following processes: * [Order management and fulfillment](https://shopify.dev/docs/apps/build/orders-fulfillment/order-management-apps) * [Financial reporting](https://help.shopify.com/manual/finance) * [Customer purchase history](https://help.shopify.com/manual/reports-and-analytics/shopify-reports/report-types/default-reports/customers-reports) and [transaction analysis](https://shopify.dev/docs/apps/launch/billing/view-charges-earnings#transaction-data-through-the-graphql-admin-api) * [Shipping](https://shopify.dev/docs/apps/build/checkout/delivery-shipping) and [inventory management](https://shopify.dev/docs/apps/build/orders-fulfillment/inventory-management-apps) You can only retrieve the last 60 days worth of orders from a store by default. If you want to access older orders, then you need to [request access to all orders](https://shopify.dev/docs/api/usage/access-scopes#orders-permissions). For large order datasets, consider using [bulk operations](https://shopify.dev/docs/api/usage/bulk-operations/queries). Bulk operations handle pagination automatically and allow you to retrieve data asynchronously without being constrained by API rate limits. Learn more about [creating orders](https://shopify.dev/docs/api/admin-graphql/latest/mutations/ordercreate) and [building order management apps](https://shopify.dev/docs/apps/build/orders-fulfillment). * order​By​Identifier [Order](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/Order) Return an order by an identifier. * order​Payment​Status [Order​Payment​Status](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/OrderPaymentStatus) Returns a payment status by payment reference ID. Used to check the status of a deferred payment. * orders [Order​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/OrderConnection) non-null Returns a list of [orders](https://shopify.dev/api/admin-graphql/latest/objects/Order) placed in the store, including data such as order status, customer, and line item details. Use the `orders` query to build reports, analyze sales performance, or automate fulfillment workflows. The `orders` query supports [pagination](https://shopify.dev/docs/api/usage/pagination-graphql), [sorting](https://shopify.dev/docs/api/admin-graphql/latest/queries/orders#arguments-sortKey), and [filtering](https://shopify.dev/docs/api/admin-graphql/latest/queries/orders#arguments-query). * order​Saved​Searches [Saved​Search​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/SavedSearchConnection) non-null List of the shop's order saved searches. * orders​Count [Count](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/Count) Returns the count of orders for the given shop. Limited to a maximum of 10000 by default. * page [Page](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/Page) Returns a `Page` resource by ID. * pages [Page​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/PageConnection) non-null List of the shop's pages. * pages​Count [Count](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/Count) Count of pages. Limited to a maximum of 10000 by default. * payment​Customization [Payment​Customization](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/PaymentCustomization) The payment customization. * payment​Customizations [Payment​Customization​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/PaymentCustomizationConnection) non-null The payment customizations. * payment​Terms​Templates [\[Payment​Terms​Template!\]!](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/PaymentTermsTemplate) non-null The list of payment terms templates eligible for all shops and users. * pending​Orders​Count [Count](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/Count) The number of pendings orders. Limited to a maximum of 10000. * point​Of​Sale​Device [Point​Of​Sale​Device](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/PointOfSaleDevice) Returns a `PointOfSaleDevice` resource by ID. * price​List [Price​List](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/PriceList) Returns a price list resource by ID. * price​Lists [Price​List​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/PriceListConnection) non-null All price lists for a shop. * privacy​Settings [Privacy​Settings!](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/PrivacySettings) non-null Privacy related settings for a shop. * product [Product](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/Product) Retrieves a [product](https://shopify.dev/docs/api/admin-graphql/latest/objects/Product) by its ID. A product is an item that a merchant can sell in their store. Use the `product` query when you need to: * Access essential product data (for example, title, description, price, images, SEO metadata, and metafields). * Build product detail pages and manage inventory. * Handle international sales with localized pricing and content. * Manage product variants and product options. Learn more about working with [Shopify's product model](https://shopify.dev/docs/apps/build/graphql/migrate/new-product-model/product-model-components). * product​By​Identifier [Product](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/Product) Return a product by an identifier. * product​Duplicate​Job [Product​Duplicate​Job!](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/ProductDuplicateJob) non-null Returns the product duplicate job. * product​Feed [Product​Feed](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/ProductFeed) Returns a ProductFeed resource by ID. * product​Feeds [Product​Feed​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/ProductFeedConnection) non-null The product feeds for the shop. * product​Operation [Product​Operation](https://shopify.dev/docs/api/admin-graphql/2025-07/interfaces/ProductOperation) Returns a ProductOperation resource by ID. This can be used to query the [ProductSetOperation](https://shopify.dev/api/admin-graphql/current/objects/ProductSetOperation), using the ID that was returned [when the product was created or updated](https://shopify.dev/api/admin/migrate/new-product-model/sync-data#create-a-product-with-variants-and-options-asynchronously) by the [ProductSet](https://shopify.dev/api/admin-graphql/current/mutations/productSet) mutation. The `status` field indicates whether the operation is `CREATED`, `ACTIVE`, or `COMPLETE`. The `product` field provides the details of the created or updated product. For the [ProductSetOperation](https://shopify.dev/api/admin-graphql/current/objects/ProductSetOperation), the `userErrors` field provides mutation errors that occurred during the operation. * product​Resource​Feedback [Product​Resource​Feedback](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/ProductResourceFeedback) Retrieves product resource feedback for the currently authenticated app, providing insights into product data quality, completeness, and optimization opportunities. This feedback helps apps guide merchants toward better product listings and improved store performance. For example, an SEO app might receive feedback indicating that certain products lack meta descriptions or have suboptimal titles, enabling the app to provide specific recommendations for improving search visibility and conversion rates. Use `ProductResourceFeedback` to: * Display product optimization recommendations to merchants * Identify data quality issues across product catalogs * Build product improvement workflows and guided experiences * Track progress on product listing completeness and quality * Implement automated product auditing and scoring systems * Generate reports on catalog health and optimization opportunities * Provide contextual suggestions within product editing interfaces The feedback system evaluates products against various criteria including SEO best practices, required fields, media quality, and sales channel requirements. Each feedback item includes specific details about the issue, suggested improvements, and priority levels. Feedback is app-specific and reflects the particular focus of your application - marketing apps receive different insights than inventory management apps. The system continuously updates as merchants make changes, providing real-time guidance for product optimization. This resource is particularly valuable for apps that help merchants improve their product listings, optimize for search engines, or enhance their overall catalog quality. The feedback enables proactive suggestions rather than reactive problem-solving. Learn more about [product optimization](https://shopify.dev/docs/api/admin-graphql/latest/objects/Product). * products [Product​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/ProductConnection) non-null Retrieves a list of [products](https://shopify.dev/docs/api/admin-graphql/latest/objects/Product) in a store. Products are the items that merchants can sell in their store. Use the `products` query when you need to: * Build a browsing interface for a product catalog. * Create product [searching](https://shopify.dev/docs/api/usage/search-syntax), [sorting](https://shopify.dev/docs/api/admin-graphql/latest/queries/products#arguments-sortKey), and [filtering](https://shopify.dev/docs/api/admin-graphql/latest/queries/products#arguments-query) experiences. * Implement product recommendations. * Sync product data with external systems. The `products` query supports [pagination](https://shopify.dev/docs/api/usage/pagination-graphql) to handle large product catalogs and [saved searches](https://shopify.dev/docs/api/admin-graphql/latest/queries/products#arguments-savedSearchId) for frequently used product queries. The `products` query returns products with their associated metadata, including: * Basic product information (for example, title, description, vendor, and type) * Product options and product variants, with their prices and inventory * Media attachments (for example, images and videos) * SEO metadata * Product categories and tags * Product availability and publishing statuses Learn more about working with [Shopify's product model](https://shopify.dev/docs/apps/build/graphql/migrate/new-product-model/product-model-components). * product​Saved​Searches [Saved​Search​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/SavedSearchConnection) non-null Returns a list of the shop's product saved searches. * products​Count [Count](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/Count) Count of products. Limited to a maximum of 10000 by default. * product​Tags [String​Connection](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/StringConnection) A list of tags that have been added to products. The maximum page size is 5000. * product​Types [String​Connection](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/StringConnection) The list of types added to products. The maximum page size is 1000. * product​Variant [Product​Variant](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/ProductVariant) Retrieves a [product variant](https://shopify.dev/docs/api/admin-graphql/latest/objects/ProductVariant) by its ID. A product variant is a specific version of a [product](https://shopify.dev/docs/api/admin-graphql/latest/objects/Product) that comes in more than one [option](https://shopify.dev/docs/api/admin-graphql/latest/objects/ProductOption), such as size or color. For example, if a merchant sells t-shirts with options for size and color, then a small, blue t-shirt would be one product variant and a large, blue t-shirt would be another. Use the `productVariant` query when you need to: * Access essential product variant data (for example, title, price, image, and metafields). * Build product detail pages and manage inventory. * Handle international sales with localized pricing and content. * Manage product variants that are part of a bundle or selling plan. Learn more about working with [Shopify's product model](https://shopify.dev/docs/apps/build/graphql/migrate/new-product-model/product-model-components). * product​Variant​By​Identifier [Product​Variant](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/ProductVariant) Return a product variant by an identifier. * product​Variants [Product​Variant​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/ProductVariantConnection) non-null Retrieves a list of [product variants](https://shopify.dev/docs/api/admin-graphql/latest/objects/ProductVariant) associated with a [product](https://shopify.dev/docs/api/admin-graphql/latest/objects/Product). A product variant is a specific version of a product that comes in more than one [option](https://shopify.dev/docs/api/admin-graphql/latest/objects/ProductOption), such as size or color. For example, if a merchant sells t-shirts with options for size and color, then a small, blue t-shirt would be one product variant and a large, blue t-shirt would be another. Use the `productVariants` query when you need to: * Search for product variants by attributes such as SKU, barcode, or inventory quantity. * Filter product variants by attributes, such as whether they're gift cards or have custom metafields. * Fetch product variants for bulk operations, such as updating prices or inventory. * Preload data for product variants, such as inventory items, selected options, or associated products. The `productVariants` query supports [pagination](https://shopify.dev/docs/api/usage/pagination-graphql) to handle large product catalogs and [saved searches](https://shopify.dev/docs/api/admin-graphql/latest/queries/productVariants#arguments-savedSearchId) for frequently used product variant queries. The `productVariants` query returns product variants with their associated metadata, including: * Basic product variant information (for example, title, SKU, barcode, price, and inventory) * Media attachments (for example, images and videos) * Associated products, selling plans, bundles, and metafields Learn more about working with [Shopify's product model](https://shopify.dev/docs/apps/build/graphql/migrate/new-product-model/product-model-components). * product​Variants​Count [Count](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/Count) Count of product variants. Limited to a maximum of 10000 by default. * product​Vendors [String​Connection](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/StringConnection) The list of vendors added to products. The maximum page size is 1000. * public​Api​Versions [\[Api​Version!\]!](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/ApiVersion) non-null The list of publicly-accessible Admin API versions, including supported versions, the release candidate, and unstable versions. * publication [Publication](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/Publication) Lookup a publication by ID. * publications [Publication​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/PublicationConnection) non-null List of publications. * publications​Count [Count](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/Count) Count of publications. Limited to a maximum of 10000 by default. * published​Products​Count [Count](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/Count) Returns a count of published products by publication ID. Limited to a maximum of 10000 by default. * refund [Refund](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/Refund) Retrieves a [refund](https://shopify.dev/docs/api/admin-graphql/latest/objects/Refund) by its ID. A refund represents a financial record of money returned to a customer from an order. It provides a comprehensive view of all refunded amounts, transactions, and restocking instructions associated with returning products or correcting order issues. Use the `refund` query to retrieve information associated with the following workflows: * Displaying refund details in order management interfaces * Building customer service tools for reviewing refund history * Creating reports on refunded amounts and reasons * Auditing refund transactions and payment gateway records * Tracking inventory impacts from refunded items A refund is associated with an [order](https://shopify.dev/docs/api/admin-graphql/latest/objects/Order) and includes [refund line items](https://shopify.dev/docs/api/admin-graphql/latest/objects/RefundLineItem) that specify which items were refunded. Each refund processes through [order transactions](https://shopify.dev/docs/api/admin-graphql/latest/objects/OrderTransaction) that handle the actual money transfer back to the customer. * return [Return](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/Return) Retrieves a return by its ID. A return represents the intent of a buyer to ship one or more items from an order back to a merchant or a third-party fulfillment location. Use the `return` query to retrieve information associated with the following workflows: * [Managing returns](https://shopify.dev/docs/apps/build/orders-fulfillment/returns-apps/build-return-management) * [Processing exchanges](https://shopify.dev/docs/apps/build/orders-fulfillment/returns-apps/manage-exchanges) * [Tracking reverse fulfillment orders](https://shopify.dev/docs/apps/build/orders-fulfillment/returns-apps/manage-reverse-fulfillment-orders) A return is associated with an [order](https://shopify.dev/docs/api/admin-graphql/latest/objects/Order) and can include multiple return [line items](https://shopify.dev/docs/api/admin-graphql/latest/objects/LineItem). Each return has a [status](https://shopify.dev/docs/apps/build/orders-fulfillment/returns-apps#return-statuses), which indicates the state of the return. * returnable​Fulfillment [Returnable​Fulfillment](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/ReturnableFulfillment) Returns a `ReturnableFulfillment` resource by ID. * returnable​Fulfillments [Returnable​Fulfillment​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/ReturnableFulfillmentConnection) non-null List of returnable fulfillments. * return​Calculate [Calculated​Return](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/CalculatedReturn) The calculated monetary value to be exchanged due to the return. * reverse​Delivery [Reverse​Delivery](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/ReverseDelivery) Lookup a reverse delivery by ID. * reverse​Fulfillment​Order [Reverse​Fulfillment​Order](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/ReverseFulfillmentOrder) Lookup a reverse fulfillment order by ID. * script​Tag [Script​Tag](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/ScriptTag) Theme app extensions If your app integrates with a Shopify theme and you plan to submit it to the Shopify App Store, you must use theme app extensions instead of Script tags. Script tags can only be used with vintage themes. [Learn more](https://shopify.dev/apps/online-store#what-integration-method-should-i-use). Script tag deprecation Script tags will be sunset for the **Order status** page on August 28, 2025. [Upgrade to Checkout Extensibility](https://www.shopify.com/plus/upgrading-to-checkout-extensibility) before this date. [Shopify Scripts](https://shopify.dev/docs/api/liquid/objects#script) will continue to work alongside Checkout Extensibility until August 28, 2025. Returns a `ScriptTag` resource by ID. * script​Tags [Script​Tag​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/ScriptTagConnection) non-null Theme app extensions If your app integrates with a Shopify theme and you plan to submit it to the Shopify App Store, you must use theme app extensions instead of Script tags. Script tags can only be used with vintage themes. [Learn more](https://shopify.dev/apps/online-store#what-integration-method-should-i-use). Script tag deprecation Script tags will be sunset for the **Order status** page on August 28, 2025. [Upgrade to Checkout Extensibility](https://www.shopify.com/plus/upgrading-to-checkout-extensibility) before this date. [Shopify Scripts](https://shopify.dev/docs/api/liquid/objects#script) will continue to work alongside Checkout Extensibility until August 28, 2025. A list of script tags. * segment [Segment](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/Segment) The Customer Segment. * segment​Filters [Segment​Filter​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/SegmentFilterConnection) non-null A list of filters. * segment​Filter​Suggestions [Segment​Filter​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/SegmentFilterConnection) non-null A list of filter suggestions associated with a segment. A segment is a group of members (commonly customers) that meet specific criteria. * segment​Migrations [Segment​Migration​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/SegmentMigrationConnection) non-null A list of a shop's segment migrations. * segments [Segment​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/SegmentConnection) non-null A list of a shop's segments. * segments​Count [Count](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/Count) The number of segments for a shop. Limited to a maximum of 10000 by default. * segment​Value​Suggestions [Segment​Value​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/SegmentValueConnection) non-null The list of suggested values corresponding to a particular filter for a segment. A segment is a group of members, such as customers, that meet specific criteria. * selling​Plan​Group [Selling​Plan​Group](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/SellingPlanGroup) Returns a `SellingPlanGroup` resource by ID. * selling​Plan​Groups [Selling​Plan​Group​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/SellingPlanGroupConnection) non-null List Selling Plan Groups. * server​Pixel [Server​Pixel](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/ServerPixel) The server pixel configured by the app. * shop [Shop!](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/Shop) non-null Returns the Shop resource corresponding to the access token used in the request. The Shop resource contains business and store management settings for the shop. * shop​Billing​Preferences [Shop​Billing​Preferences!](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/ShopBillingPreferences) non-null The shop's billing preferences. * shopify​Function [Shopify​Function](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/ShopifyFunction) Returns a Shopify Function by its ID. [Functions](https://shopify.dev/apps/build/functions) enable you to customize Shopify's backend logic at defined parts of the commerce loop. * shopify​Functions [Shopify​Function​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/ShopifyFunctionConnection) non-null Returns the Shopify Functions owned by the querying API client installed on the shop. * shopify​Payments​Account [Shopify​Payments​Account](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/ShopifyPaymentsAccount) Shopify Payments account information, including balances and payouts. * shop​Locales [\[Shop​Locale!\]!](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/ShopLocale) non-null A list of locales available on a shop. * shop​Pay​Payment​Request​Receipt [Shop​Pay​Payment​Request​Receipt](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/ShopPayPaymentRequestReceipt) Returns a Shop Pay payment request receipt. * shop​Pay​Payment​Request​Receipts [Shop​Pay​Payment​Request​Receipt​Connection](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/ShopPayPaymentRequestReceiptConnection) Returns a list of Shop Pay payment request receipts. * staff​Member [Staff​Member](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/StaffMember) The StaffMember resource, by ID. * staff​Members [Staff​Member​Connection](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/StaffMemberConnection) The shop staff members. * standard​Metafield​Definition​Templates [Standard​Metafield​Definition​Template​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/StandardMetafieldDefinitionTemplateConnection) non-null Standard metafield definitions are intended for specific, common use cases. Their namespace and keys reflect these use cases and are reserved. Refer to all available [`Standard Metafield Definition Templates`](https://shopify.dev/api/admin-graphql/latest/objects/StandardMetafieldDefinitionTemplate). * store​Credit​Account [Store​Credit​Account](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/StoreCreditAccount) Returns a store credit account resource by ID. * subscription​Billing​Attempt [Subscription​Billing​Attempt](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/SubscriptionBillingAttempt) Returns a `SubscriptionBillingAttempt` resource by ID. * subscription​Billing​Attempts [Subscription​Billing​Attempt​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/SubscriptionBillingAttemptConnection) non-null Returns subscription billing attempts on a store. * subscription​Billing​Cycle [Subscription​Billing​Cycle](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/SubscriptionBillingCycle) Returns a subscription billing cycle found either by cycle index or date. * subscription​Billing​Cycle​Bulk​Results [Subscription​Billing​Cycle​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/SubscriptionBillingCycleConnection) non-null Retrieves the results of the asynchronous job for the subscription billing cycle bulk action based on the specified job ID. This query can be used to obtain the billing cycles that match the criteria defined in the subscriptionBillingCycleBulkSearch and subscriptionBillingCycleBulkCharge mutations. * subscription​Billing​Cycles [Subscription​Billing​Cycle​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/SubscriptionBillingCycleConnection) non-null Returns subscription billing cycles for a contract ID. * subscription​Contract [Subscription​Contract](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/SubscriptionContract) Returns a Subscription Contract resource by ID. * subscription​Contracts [Subscription​Contract​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/SubscriptionContractConnection) non-null List Subscription Contracts. * subscription​Draft [Subscription​Draft](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/SubscriptionDraft) Returns a Subscription Draft resource by ID. * taxonomy [Taxonomy](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/Taxonomy) The Taxonomy resource lets you access the categories, attributes and values of the loaded taxonomy tree. * tender​Transactions [Tender​Transaction​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/TenderTransactionConnection) non-null Returns a list of TenderTransactions associated with the shop. * theme [Online​Store​Theme](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/OnlineStoreTheme) Returns a particular theme for the shop. * themes [Online​Store​Theme​Connection](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/OnlineStoreThemeConnection) Returns a paginated list of themes for the shop. * translatable​Resource [Translatable​Resource](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/TranslatableResource) A resource that can have localized values for different languages. * translatable​Resources [Translatable​Resource​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/TranslatableResourceConnection) non-null Resources that can have localized values for different languages. * translatable​Resources​By​Ids [Translatable​Resource​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/TranslatableResourceConnection) non-null Resources that can have localized values for different languages. * url​Redirect [Url​Redirect](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/UrlRedirect) Returns a `UrlRedirect` resource by ID. * url​Redirect​Import [Url​Redirect​Import](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/UrlRedirectImport) Returns a `UrlRedirectImport` resource by ID. * url​Redirects [Url​Redirect​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/UrlRedirectConnection) non-null A list of redirects for a shop. * url​Redirect​Saved​Searches [Saved​Search​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/SavedSearchConnection) non-null A list of the shop's URL redirect saved searches. * url​Redirects​Count [Count](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/Count) Count of redirects. Limited to a maximum of 10000 by default. * validation [Validation](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/Validation) Validation available on the shop. * validations [Validation​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/ValidationConnection) non-null Validations available on the shop. * webhook​Subscription [Webhook​Subscription](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/WebhookSubscription) Returns a webhook subscription by ID. Building an app? If you only use app-specific webhooks, you won't need this. App-specific webhook subscriptions specified in your `shopify.app.toml` may be easier. They are automatically kept up to date by Shopify & require less maintenance. Please read [About managing webhook subscriptions](https://shopify.dev/docs/apps/build/webhooks/subscribe). * webhook​Subscriptions [Webhook​Subscription​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/WebhookSubscriptionConnection) non-null Retrieves a paginated list of shop-scoped webhook subscriptions configured for the current app. This query returns webhook subscriptions created via the API for this shop, not including app-scoped subscriptions configured via TOML files. For example, an app dashboard might use this query to display all configured webhooks, showing which events trigger notifications and their delivery endpoints for troubleshooting integration issues. Use the `webhookSubscriptions` query to: * Audit all active shop-scoped webhook configurations * View and manage webhook subscription configurations * Display subscription details in app dashboards * Retrieve existing webhook configurations for dynamic integration setups * Check which subscriptions already exist before creating new ones The query returns comprehensive subscription data including event topics, endpoint configurations, filtering rules, API versions, and metafield namespace permissions. Each subscription includes creation and modification timestamps for tracking configuration changes. Results support standard GraphQL pagination patterns with cursor-based navigation, allowing efficient retrieval of large webhook subscription lists. The response includes detailed endpoint information varying by type - HTTP callback URLs, EventBridge ARNs, or Pub/Sub project and topic specifications. Advanced subscription features like event filtering using Shopify search syntax, field inclusion rules, and metafield namespace access are fully exposed, providing complete visibility into webhook configuration. Learn more about [webhook subscription queries](https://shopify.dev/docs/apps/build/webhooks/subscribe). Building an app? If you only use app-specific webhooks, you won't need this. App-specific webhook subscriptions specified in your `shopify.app.toml` may be easier. They are automatically kept up to date by Shopify & require less maintenance. Please read [About managing webhook subscriptions](https://shopify.dev/docs/apps/build/webhooks/subscribe). * webhook​Subscriptions​Count [Count](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/Count) The count of webhook subscriptions. Building an app? If you only use app-specific webhooks, you won't need this. App-specific webhook subscriptions specified in your `shopify.app.toml` may be easier. They are automatically kept up to date by Shopify & require less maintenance. Please read [About managing webhook subscriptions](https://shopify.dev/docs/apps/build/webhooks/subscribe). Limited to a maximum of 10000 by default. * web​Pixel [Web​Pixel](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/WebPixel) Returns a [web pixel](https://shopify.dev/docs/apps/build/marketing-analytics/build-web-pixels) by ID. * web​Presences [Market​Web​Presence​Connection](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/MarketWebPresenceConnection) The web presences for the shop. ### Deprecated fields * automatic​Discount [Discount​Automatic](https://shopify.dev/docs/api/admin-graphql/2025-07/unions/DiscountAutomatic) Deprecated * automatic​Discounts [Discount​Automatic​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/DiscountAutomaticConnection) non-nullDeprecated * channel [Channel](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/Channel) Deprecated * channels [Channel​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/ChannelConnection) non-nullDeprecated * collection​By​Handle [Collection](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/Collection) Deprecated * deletion​Events [Deletion​Event​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/DeletionEventConnection) non-nullDeprecated * locations​Available​For​Delivery​Profiles [\[Location!\]](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/Location) Deprecated * market​By​Geography [Market](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/Market) Deprecated * primary​Market [Market!](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/Market) non-nullDeprecated * product​By​Handle [Product](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/Product) Deprecated *** ## Map ### Fields with this object * {}[Job.query](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/Job#field-Job.fields.query)