--- 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-10 api_name: admin type: object api_type: graphql source_url: html: 'https://shopify.dev/docs/api/admin-graphql/latest/objects/QueryRoot' md: 'https://shopify.dev/docs/api/admin-graphql/latest/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/latest/connections/AbandonedCheckoutConnection) non-null Returns a list of abandoned checkouts. A checkout is considered abandoned when a customer adds contact information but doesn't complete their purchase. Includes both abandoned and recovered checkouts. Each checkout provides [`Customer`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Customer) details, [`AbandonedCheckoutLineItem`](https://shopify.dev/docs/api/admin-graphql/latest/objects/AbandonedCheckoutLineItem) objects, pricing information, and a recovery URL for re-engaging customers who didn't complete their purchase. * abandoned​Checkouts​Count [Count](https://shopify.dev/docs/api/admin-graphql/latest/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/latest/objects/Abandonment) Returns a `Abandonment` resource by ID. * abandonment​By​Abandoned​Checkout​Id [Abandonment](https://shopify.dev/docs/api/admin-graphql/latest/objects/Abandonment) Returns an Abandonment by the Abandoned Checkout ID. * app [App](https://shopify.dev/docs/api/admin-graphql/latest/objects/App) Retrieves an [`App`](https://shopify.dev/docs/api/admin-graphql/latest/objects/App) by its ID. If no ID is provided, returns details about the currently authenticated app. The query provides access to app details including title, icon, and pricing information. If the app isn't installed on the current shop, then the [`installation`](https://shopify.dev/docs/api/admin-graphql/latest/queries/app#returns-App.fields.installation) field will be `null`. * app​By​Handle [App](https://shopify.dev/docs/api/admin-graphql/latest/objects/App) Retrieves an app by its unique handle. The handle is a URL-friendly identifier for the app. Returns the [`App`](https://shopify.dev/docs/api/admin-graphql/latest/objects/App) if found, or `null` if no app exists with the specified handle. * app​By​Key [App](https://shopify.dev/docs/api/admin-graphql/latest/objects/App) Retrieves an [`App`](https://shopify.dev/docs/api/admin-graphql/latest/objects/App) by its client ID (API key). Returns the app's configuration, installation status, [`AccessScope`](https://shopify.dev/docs/api/admin-graphql/latest/objects/AccessScope) objects, and developer information. Returns `null` if no app exists with the specified client ID. * app​Discount​Type [App​Discount​Type](https://shopify.dev/docs/api/admin-graphql/latest/objects/AppDiscountType) An app discount type. * app​Discount​Types [\[App​Discount​Type!\]!](https://shopify.dev/docs/api/admin-graphql/latest/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/latest/connections/AppDiscountTypeConnection) non-null A list of app discount types installed by apps. * app​Installation [App​Installation](https://shopify.dev/docs/api/admin-graphql/latest/objects/AppInstallation) Retrieves an [`AppInstallation`](https://shopify.dev/docs/api/admin-graphql/latest/objects/AppInstallation) by ID. If no ID is provided, returns the installation for the currently authenticated [`App`](https://shopify.dev/docs/api/admin-graphql/latest/objects/App). The query provides essential data for validating installation state and managing app functionality within a store. Use this query to access installation details including granted [`AccessScope`](https://shopify.dev/docs/api/admin-graphql/latest/objects/AccessScope) objects, active [`AppSubscription`](https://shopify.dev/docs/api/admin-graphql/latest/objects/AppSubscription) objects, [`AppCredit`](https://shopify.dev/docs/api/admin-graphql/latest/objects/AppCredit) objects, [`AppPurchaseOneTime`](https://shopify.dev/docs/api/admin-graphql/latest/objects/AppPurchaseOneTime) objects, and app-specific metadata. 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/latest/connections/AppInstallationConnection) non-null A paginated list of [`AppInstallation`](https://shopify.dev/docs/api/admin-graphql/latest/objects/AppInstallation) objects across multiple stores where your app is installed. Use this query to monitor installation status, track billing and subscriptions through [`AppSubscription`](https://shopify.dev/docs/api/admin-graphql/latest/objects/AppSubscription) objects, and review granted [`AccessScope`](https://shopify.dev/docs/api/admin-graphql/latest/objects/AccessScope) objects. Filter by [`AppInstallationCategory`](https://shopify.dev/docs/api/admin-graphql/latest/enums/AppInstallationCategory) to find specific types of installations (such as POS or channel apps) and by [`AppInstallationPrivacy`](https://shopify.dev/docs/api/admin-graphql/latest/enums/AppInstallationPrivacy) to scope to public or private installations. * article [Article](https://shopify.dev/docs/api/admin-graphql/latest/objects/Article) Returns a `Article` resource by ID. * article​Authors [Article​Author​Connection!](https://shopify.dev/docs/api/admin-graphql/latest/connections/ArticleAuthorConnection) non-null List of article authors for the shop. * articles [Article​Connection!](https://shopify.dev/docs/api/admin-graphql/latest/connections/ArticleConnection) non-null Returns a paginated list of articles from the shop's blogs. [`Article`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Article) objects are blog posts that contain content like text, images, and tags. Supports [cursor-based pagination](https://shopify.dev/docs/api/usage/pagination-graphql) to control the number of articles returned and their order. Use the [`query`](https://shopify.dev/docs/api/admin-graphql/latest/queries/articles#arguments-query) argument to filter results by specific criteria. * article​Tags [\[String!\]!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String) non-null List of all article tags. * sort [Article​Tag​Sort](https://shopify.dev/docs/api/admin-graphql/latest/enums/ArticleTagSort) Default:ALPHABETICAL ### Arguments Type of sort order. * limit [Int!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/Int) required The maximum number of tags to return. *** * assigned​Fulfillment​Orders [Fulfillment​Order​Connection!](https://shopify.dev/docs/api/admin-graphql/latest/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/latest/objects/DiscountAutomaticNode) Returns a `DiscountAutomaticNode` resource by ID. * automatic​Discount​Nodes [Discount​Automatic​Node​Connection!](https://shopify.dev/docs/api/admin-graphql/latest/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/latest/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/latest/interfaces/MarketRegion) non-null The geographic regions that you can set as the [`Shop`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Shop)'s backup region. The backup region serves as a fallback when the system can't determine a buyer's actual location. * available​Carrier​Services [\[Delivery​Carrier​Service​And​Locations!\]!](https://shopify.dev/docs/api/admin-graphql/latest/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/latest/objects/Locale) non-null Returns all locales that Shopify supports. Each [`Locale`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Locale) includes an ISO code and human-readable name. Use this query to discover which locales you can enable on a shop with the [`shopLocaleEnable`](https://shopify.dev/docs/api/admin-graphql/latest/mutations/shopLocaleEnable) mutation. * backup​Region [Market​Region!](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/MarketRegion) non-null The backup region of the shop. * blog [Blog](https://shopify.dev/docs/api/admin-graphql/latest/objects/Blog) Returns a `Blog` resource by ID. * blogs [Blog​Connection!](https://shopify.dev/docs/api/admin-graphql/latest/connections/BlogConnection) non-null Returns a paginated list of the shop's [`Blog`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Blog) objects. Blogs serve as containers for [`Article`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Article) objects and provide content management capabilities for the store's editorial content. Supports [cursor-based pagination](https://shopify.dev/docs/api/usage/pagination-graphql) to control the number of blogs returned and their order. Use the [`query`](https://shopify.dev/docs/api/admin-graphql/latest/queries/blogs#arguments-query) argument to filter results by specific criteria. * blogs​Count [Count](https://shopify.dev/docs/api/admin-graphql/latest/objects/Count) Count of blogs. Limited to a maximum of 10000 by default. * business​Entities [\[Business​Entity!\]!](https://shopify.dev/docs/api/admin-graphql/latest/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/latest/objects/BusinessEntity) Returns a Business Entity by ID. * carrier​Service [Delivery​Carrier​Service](https://shopify.dev/docs/api/admin-graphql/latest/objects/DeliveryCarrierService) Returns a `DeliveryCarrierService` resource by ID. * carrier​Services [Delivery​Carrier​Service​Connection!](https://shopify.dev/docs/api/admin-graphql/latest/connections/DeliveryCarrierServiceConnection) non-null A paginated list of carrier services configured for the shop. Carrier services provide real-time shipping rates from external providers like FedEx, UPS, or custom shipping solutions. Use the `query` parameter to filter results by attributes such as active status. * cart​Transforms [Cart​Transform​Connection!](https://shopify.dev/docs/api/admin-graphql/latest/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/latest/objects/CashTrackingSession) Returns a `CashTrackingSession` resource by ID. * cash​Tracking​Sessions [Cash​Tracking​Session​Connection!](https://shopify.dev/docs/api/admin-graphql/latest/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/latest/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/latest/interfaces/ResourceOperation) non-null Returns the most recent catalog operations for the shop. * catalogs [Catalog​Connection!](https://shopify.dev/docs/api/admin-graphql/latest/connections/CatalogConnection) non-null The catalogs belonging to the shop. * catalogs​Count [Count](https://shopify.dev/docs/api/admin-graphql/latest/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/latest/objects/CheckoutBranding) Returns the visual customizations for checkout for a given [checkout profile](https://shopify.dev/docs/api/admin-graphql/latest/objects/CheckoutProfile). To update checkout branding settings, use the [`checkoutBrandingUpsert`](https://shopify.dev/docs/api/admin-graphql/latest/mutations/checkoutBrandingUpsert) mutation. Learn more about [customizing checkout's appearance](https://shopify.dev/docs/apps/build/checkout/styling). * checkout​Profile [Checkout​Profile](https://shopify.dev/docs/api/admin-graphql/latest/objects/CheckoutProfile) Returns a [`CheckoutProfile`](https://shopify.dev/docs/api/admin-graphql/latest/objects/CheckoutProfile). Checkout profiles define the branding settings and UI extensions for a store's checkout experience. Stores can have one published profile that renders on their live checkout and multiple draft profiles for testing customizations in the checkout editor. * checkout​Profiles [Checkout​Profile​Connection!](https://shopify.dev/docs/api/admin-graphql/latest/connections/CheckoutProfileConnection) non-null List of checkout profiles on a shop. * code​Discount​Node [Discount​Code​Node](https://shopify.dev/docs/api/admin-graphql/latest/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/latest/objects/DiscountCodeNode) Retrieves a [code discount](https://help.shopify.com/manual/discounts/discount-types#discount-codes) by its discount code. The search is case-insensitive, enabling you to find discounts regardless of how customers enter the code. Returns a [`DiscountCodeNode`](https://shopify.dev/docs/api/admin-graphql/latest/objects/DiscountCodeNode) that contains the underlying discount details, which could be a basic [amount off discount](https://help.shopify.com/manual/discounts/discount-types/percentage-fixed-amount), a ["Buy X Get Y" (BXGY) discount](https://help.shopify.com/manual/discounts/discount-types/buy-x-get-y), a [free shipping discount](https://help.shopify.com/manual/discounts/discount-types/free-shipping), or an [app-provided discount](https://help.shopify.com/manual/discounts/discount-types/discounts-with-apps). Learn more about working with [Shopify's discount model](https://shopify.dev/docs/apps/build/discounts). * code​Discount​Nodes [Discount​Code​Node​Connection!](https://shopify.dev/docs/api/admin-graphql/latest/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/latest/connections/SavedSearchConnection) non-null List of the shop's code discount saved searches. * collection [Collection](https://shopify.dev/docs/api/admin-graphql/latest/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/latest/objects/Collection) Return a collection by an identifier. * collection​Rules​Conditions [\[Collection​Rule​Conditions!\]!](https://shopify.dev/docs/api/admin-graphql/latest/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/latest/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/latest/connections/SavedSearchConnection) non-null Returns a list of the shop's collection saved searches. * collections​Count [Count](https://shopify.dev/docs/api/admin-graphql/latest/objects/Count) Count of collections. Limited to a maximum of 10000 by default. * comment [Comment](https://shopify.dev/docs/api/admin-graphql/latest/objects/Comment) Returns a `Comment` resource by ID. * comments [Comment​Connection!](https://shopify.dev/docs/api/admin-graphql/latest/connections/CommentConnection) non-null List of the shop's comments. * companies [Company​Connection!](https://shopify.dev/docs/api/admin-graphql/latest/connections/CompanyConnection) non-null A paginated list of companies in the shop. [`Company`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Company) objects are business entities that purchase from the merchant. Use the [`query`](https://shopify.dev/docs/api/admin-graphql/latest/queries/companies#arguments-query) argument to filter companies by attributes like name or externalId. Sort and paginate results to handle large datasets efficiently. Learn more about [Shopify API search syntax](https://shopify.dev/docs/api/usage/search-syntax). * companies​Count [Count](https://shopify.dev/docs/api/admin-graphql/latest/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/latest/objects/Company) Returns a `Company` resource by ID. * company​Contact [Company​Contact](https://shopify.dev/docs/api/admin-graphql/latest/objects/CompanyContact) Returns a `CompanyContact` resource by ID. * company​Contact​Role [Company​Contact​Role](https://shopify.dev/docs/api/admin-graphql/latest/objects/CompanyContactRole) Returns a `CompanyContactRole` resource by ID. * company​Location [Company​Location](https://shopify.dev/docs/api/admin-graphql/latest/objects/CompanyLocation) Returns a `CompanyLocation` resource by ID. * company​Locations [Company​Location​Connection!](https://shopify.dev/docs/api/admin-graphql/latest/connections/CompanyLocationConnection) non-null A paginated list of [`CompanyLocation`](https://shopify.dev/docs/api/admin-graphql/latest/objects/CompanyLocation) objects for B2B customers. Company locations represent individual branches or offices of a [`Company`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Company) where B2B orders can be placed. Each location can have its own billing and shipping addresses, tax settings, [`PaymentTerms`](https://shopify.dev/docs/api/admin-graphql/latest/objects/PaymentTerms), and [`Catalog`](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Catalog) assignments with custom pricing. Use the query parameter to search locations by name or other attributes. Learn more about [managing company locations](https://shopify.dev/docs/apps/build/b2b/manage-client-company-locations). * consent​Policy [\[Consent​Policy!\]!](https://shopify.dev/docs/api/admin-graphql/latest/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/latest/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/latest/objects/AppInstallation) non-null Returns the [`AppInstallation`](https://shopify.dev/docs/api/admin-graphql/latest/objects/AppInstallation) for the currently authenticated app. Provides access to granted access scopes, active [`AppSubscription`](https://shopify.dev/docs/api/admin-graphql/latest/objects/AppSubscription) objects, and billing information for your app. Use this query to check which permissions your app has, monitor subscription status, or retrieve [`AppCredit`](https://shopify.dev/docs/api/admin-graphql/latest/objects/AppCredit) objects. Learn more about [managing access scopes](https://shopify.dev/docs/api/usage/access-scopes#checking-granted-access-scopes), [subscription billing](https://shopify.dev/docs/apps/launch/billing/subscription-billing), and [app credits](https://shopify.dev/docs/apps/launch/billing/award-app-credits). * current​Staff​Member [Staff​Member](https://shopify.dev/docs/api/admin-graphql/latest/objects/StaffMember) The staff member making the API request. * customer [Customer](https://shopify.dev/docs/api/admin-graphql/latest/objects/Customer) Returns a `Customer` resource by ID. * customer​Account​Page [Customer​Account​Page](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/CustomerAccountPage) Returns a `CustomerAccountPage` resource by ID. * customer​Account​Pages [Customer​Account​Page​Connection](https://shopify.dev/docs/api/admin-graphql/latest/connections/CustomerAccountPageConnection) List of the shop's customer account pages. * customer​By​Identifier [Customer](https://shopify.dev/docs/api/admin-graphql/latest/objects/Customer) Return a customer by an identifier. * customer​Merge​Job​Status [Customer​Merge​Request](https://shopify.dev/docs/api/admin-graphql/latest/objects/CustomerMergeRequest) Returns the status of a customer merge request job. * customer​Merge​Preview [Customer​Merge​Preview!](https://shopify.dev/docs/api/admin-graphql/latest/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/latest/objects/CustomerPaymentMethod) Returns a CustomerPaymentMethod resource by its ID. * customers [Customer​Connection!](https://shopify.dev/docs/api/admin-graphql/latest/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/latest/connections/SavedSearchConnection) non-null List of the shop's customer saved searches. * customers​Count [Count](https://shopify.dev/docs/api/admin-graphql/latest/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/latest/connections/CustomerSegmentMemberConnection) non-null A paginated list of customers that belong to an individual [`Segment`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Segment). Segments group customers based on criteria defined through [ShopifyQL queries](https://shopify.dev/docs/api/shopifyql/segment-query-language-reference). Access segment members with their profile information and purchase summary data. The connection includes statistics for analyzing segment attributes (such as average and sum calculations) and a total count of all members. The maximum page size is 1000. * customer​Segment​Membership [Segment​Membership​Response!](https://shopify.dev/docs/api/admin-graphql/latest/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/latest/objects/CustomerSegmentMembersQuery) Returns a `CustomerSegmentMembersQuery` resource by ID. * delivery​Customization [Delivery​Customization](https://shopify.dev/docs/api/admin-graphql/latest/objects/DeliveryCustomization) The delivery customization. * delivery​Customizations [Delivery​Customization​Connection!](https://shopify.dev/docs/api/admin-graphql/latest/connections/DeliveryCustomizationConnection) non-null The delivery customizations. * delivery​Profile [Delivery​Profile](https://shopify.dev/docs/api/admin-graphql/latest/objects/DeliveryProfile) Retrieves a [`DeliveryProfile`](https://shopify.dev/docs/api/admin-graphql/latest/objects/DeliveryProfile) by ID. Delivery profiles group shipping settings for specific [`Product`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Product) objects that ship from selected [`Location`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Location) objects to \[delivery zones]\( with defined rates. Learn more about [delivery profiles](https://shopify.dev/docs/apps/build/purchase-options/deferred/delivery-and-deferment#whats-a-delivery-profile). * delivery​Profiles [Delivery​Profile​Connection!](https://shopify.dev/docs/api/admin-graphql/latest/connections/DeliveryProfileConnection) non-null Returns a paginated list of [`DeliveryProfile`](https://shopify.dev/docs/api/admin-graphql/latest/objects/DeliveryProfile) objects for the shop. Delivery profiles group [`Product`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Product) and [`ProductVariant`](https://shopify.dev/docs/api/admin-graphql/latest/objects/ProductVariant) objects that share shipping rates and zones. Each profile contains [`DeliveryLocationGroup`](https://shopify.dev/docs/api/admin-graphql/latest/objects/DeliveryLocationGroup) objects that organize fulfillment [`Location`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Location) objects and their associated delivery zones. [`DeliveryZone`](https://shopify.dev/docs/api/admin-graphql/latest/objects/DeliveryZone) objects define geographic regions with specific shipping methods and rates. Use the [`merchantOwnedOnly`](https://shopify.dev/docs/api/admin-graphql/latest/queries/deliveryProfiles#arguments-merchantOwnedOnly) filter to exclude profiles that third-party apps manage. Learn more about [delivery profiles](https://shopify.dev/docs/apps/build/purchase-options/deferred/delivery-and-deferment#whats-a-delivery-profile). * delivery​Promise​Participants [Delivery​Promise​Participant​Connection](https://shopify.dev/docs/api/admin-graphql/latest/connections/DeliveryPromiseParticipantConnection) Returns delivery promise participants. * delivery​Promise​Provider [Delivery​Promise​Provider](https://shopify.dev/docs/api/admin-graphql/latest/objects/DeliveryPromiseProvider) Lookup a delivery promise provider. * delivery​Promise​Settings [Delivery​Promise​Setting!](https://shopify.dev/docs/api/admin-graphql/latest/objects/DeliveryPromiseSetting) non-null Represents the delivery promise settings for a shop. * delivery​Settings [Delivery​Setting](https://shopify.dev/docs/api/admin-graphql/latest/objects/DeliverySetting) Returns the shop-wide shipping settings. * discount​Codes​Count [Count](https://shopify.dev/docs/api/admin-graphql/latest/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/latest/objects/DiscountNode) Returns a `DiscountNode` resource by ID. * discount​Nodes [Discount​Node​Connection!](https://shopify.dev/docs/api/admin-graphql/latest/connections/DiscountNodeConnection) non-null Returns a list of discounts. * discount​Nodes​Count [Count](https://shopify.dev/docs/api/admin-graphql/latest/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/latest/objects/DiscountRedeemCodeBulkCreation) Returns a `DiscountRedeemCodeBulkCreation` resource by ID. * discount​Redeem​Code​Saved​Searches [Saved​Search​Connection!](https://shopify.dev/docs/api/admin-graphql/latest/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/latest/objects/ShopifyPaymentsDispute) Returns a `ShopifyPaymentsDispute` resource by ID. * dispute​Evidence [Shopify​Payments​Dispute​Evidence](https://shopify.dev/docs/api/admin-graphql/latest/objects/ShopifyPaymentsDisputeEvidence) Returns a `ShopifyPaymentsDisputeEvidence` resource by ID. * disputes [Shopify​Payments​Dispute​Connection!](https://shopify.dev/docs/api/admin-graphql/latest/connections/ShopifyPaymentsDisputeConnection) non-null All disputes related to the Shop. * domain [Domain](https://shopify.dev/docs/api/admin-graphql/latest/objects/Domain) Returns a `Domain` resource by ID. * draft​Order [Draft​Order](https://shopify.dev/docs/api/admin-graphql/latest/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/latest/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/latest/connections/DraftOrderConnection) non-null List of saved draft orders. * draft​Order​Saved​Searches [Saved​Search​Connection!](https://shopify.dev/docs/api/admin-graphql/latest/connections/SavedSearchConnection) non-null List of the shop's draft order saved searches. * draft​Orders​Count [Count](https://shopify.dev/docs/api/admin-graphql/latest/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/latest/objects/DraftOrderTag) Returns a `DraftOrderTag` resource by ID. * event [Event](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Event) Retrieves a single event by ID. Events chronicle activities in your store such as resource creation, updates, or staff comments. The query returns an [`Event`](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Event) interface of type [`BasicEvent`](https://shopify.dev/docs/api/admin-graphql/latest/objects/BasicEvent) or [`CommentEvent`](https://shopify.dev/docs/api/admin-graphql/latest/objects/CommentEvent). * events [Event​Connection](https://shopify.dev/docs/api/admin-graphql/latest/connections/EventConnection) A paginated list of events that chronicle activities in the store. [`Event`](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Event) is an interface implemented by types such as [`BasicEvent`](https://shopify.dev/docs/api/admin-graphql/latest/objects/BasicEvent) and [`CommentEvent`](https://shopify.dev/docs/api/admin-graphql/latest/objects/CommentEvent) that track actions such as creating [`Article`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Article) objects, fulfilling [`Order`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Order) objects, adding [`Product`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Product) objects, or staff comments on timelines. The query supports filtering and sorting to help you find specific events or audit store activity over time. * events​Count [Count](https://shopify.dev/docs/api/admin-graphql/latest/objects/Count) Count of events. Limited to a maximum of 10000. * files [File​Connection!](https://shopify.dev/docs/api/admin-graphql/latest/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/latest/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/latest/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/latest/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/latest/objects/Fulfillment) Returns a Fulfillment resource by ID. * fulfillment​Constraint​Rules [\[Fulfillment​Constraint​Rule!\]!](https://shopify.dev/docs/api/admin-graphql/latest/objects/FulfillmentConstraintRule) non-null The fulfillment constraint rules that belong to a shop. * fulfillment​Order [Fulfillment​Order](https://shopify.dev/docs/api/admin-graphql/latest/objects/FulfillmentOrder) Returns a `FulfillmentOrder` resource by ID. * fulfillment​Orders [Fulfillment​Order​Connection!](https://shopify.dev/docs/api/admin-graphql/latest/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/latest/objects/FulfillmentService) Returns a FulfillmentService resource by ID. * gift​Card [Gift​Card](https://shopify.dev/docs/api/admin-graphql/latest/objects/GiftCard) Retrieves a [`GiftCard`](https://shopify.dev/docs/api/admin-graphql/latest/objects/GiftCard) by its ID. Returns the gift card's balance, transaction history, [`Customer`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Customer) information, and whether it's enabled. Additional fields include the initial value, expiration date, deactivation timestamp (if applicable), and the associated [`Order`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Order) if the gift card was purchased by a customer through checkout. Gift cards that merchants create manually won't have an associated order. * gift​Card​Configuration [Gift​Card​Configuration!](https://shopify.dev/docs/api/admin-graphql/latest/objects/GiftCardConfiguration) non-null The configuration for the shop's gift cards. * gift​Cards [Gift​Card​Connection!](https://shopify.dev/docs/api/admin-graphql/latest/connections/GiftCardConnection) non-null Returns a paginated list of [`GiftCard`](https://shopify.dev/docs/api/admin-graphql/latest/objects/GiftCard) objects issued for the shop. You can filter gift cards by attributes such as status, last characters of the code, balance status, and other values using the [`query`](https://shopify.dev/docs/api/admin-graphql/latest/queries/giftCards#arguments-query) parameter. You can also apply [`SavedSearch`](https://shopify.dev/docs/api/admin-graphql/latest/objects/SavedSearch) objects to filter results. * gift​Cards​Count [Count](https://shopify.dev/docs/api/admin-graphql/latest/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/latest/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/latest/connections/InventoryItemConnection) non-null Returns a list of inventory items. * inventory​Level [Inventory​Level](https://shopify.dev/docs/api/admin-graphql/latest/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/latest/objects/InventoryProperties) non-null General inventory properties for the shop. * inventory​Shipment [Inventory​Shipment](https://shopify.dev/docs/api/admin-graphql/latest/objects/InventoryShipment) Returns an inventory shipment by ID. * inventory​Transfer [Inventory​Transfer](https://shopify.dev/docs/api/admin-graphql/latest/objects/InventoryTransfer) Returns an inventory transfer by ID. * inventory​Transfers [Inventory​Transfer​Connection!](https://shopify.dev/docs/api/admin-graphql/latest/connections/InventoryTransferConnection) non-null Returns a paginated list of transfers. * job [Job](https://shopify.dev/docs/api/admin-graphql/latest/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/latest/objects/Location) Returns an inventory Location resource by ID. * location​By​Identifier [Location](https://shopify.dev/docs/api/admin-graphql/latest/objects/Location) Return a location by an identifier. * locations [Location​Connection!](https://shopify.dev/docs/api/admin-graphql/latest/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/latest/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/latest/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/latest/connections/FulfillmentOrderConnection) non-null Returns a list of fulfillment orders that are on hold. * market [Market](https://shopify.dev/docs/api/admin-graphql/latest/objects/Market) Returns a `Market` resource by ID. * marketing​Activities [Marketing​Activity​Connection!](https://shopify.dev/docs/api/admin-graphql/latest/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/latest/objects/MarketingActivity) Returns a `MarketingActivity` resource by ID. * marketing​Event [Marketing​Event](https://shopify.dev/docs/api/admin-graphql/latest/objects/MarketingEvent) Returns a `MarketingEvent` resource by ID. * marketing​Events [Marketing​Event​Connection!](https://shopify.dev/docs/api/admin-graphql/latest/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/latest/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/latest/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/latest/connections/MarketLocalizableResourceConnection) non-null Resources that can have localized values for different markets. * markets [Market​Connection!](https://shopify.dev/docs/api/admin-graphql/latest/connections/MarketConnection) non-null Returns a paginated list of [`Market`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Market) objects configured for the shop. Markets match buyers based on defined conditions to deliver customized shopping experiences. Filter markets by [`MarketType`](https://shopify.dev/docs/api/admin-graphql/latest/enums/MarketType) and [`MarketStatus`](https://shopify.dev/docs/api/admin-graphql/latest/enums/MarketStatus), search by name, and control sort order. Retrieve market configurations including [`MarketCurrencySettings`](https://shopify.dev/docs/api/admin-graphql/latest/objects/MarketCurrencySettings), [`MarketWebPresence`](https://shopify.dev/docs/api/admin-graphql/latest/objects/MarketWebPresence) objects, and [`MarketConditions`](https://shopify.dev/docs/api/admin-graphql/latest/objects/MarketConditions). Learn more about [Shopify Markets](https://shopify.dev/docs/apps/build/markets). * markets​Resolved​Values [Markets​Resolved​Values!](https://shopify.dev/docs/api/admin-graphql/latest/objects/MarketsResolvedValues) non-null The resolved values for a buyer signal. * menu [Menu](https://shopify.dev/docs/api/admin-graphql/latest/objects/Menu) Returns a `Menu` resource by ID. * menus [Menu​Connection!](https://shopify.dev/docs/api/admin-graphql/latest/connections/MenuConnection) non-null The shop's menus. * metafield​Definition [Metafield​Definition](https://shopify.dev/docs/api/admin-graphql/latest/objects/MetafieldDefinition) Retrieves a [`MetafieldDefinition`](https://shopify.dev/docs/api/admin-graphql/current/objects/MetafieldDefinition) by its identifier. You can identify a definition using either its owner type, namespace, and key, or its global ID. Use this query to inspect a definition's configuration, including its data type, validations, access settings, and the count of [metafields](https://shopify.dev/docs/api/admin-graphql/current/objects/Metafield) using it. * metafield​Definitions [Metafield​Definition​Connection!](https://shopify.dev/docs/api/admin-graphql/latest/connections/MetafieldDefinitionConnection) non-null Returns a list of metafield definitions. * metafield​Definition​Types [\[Metafield​Definition​Type!\]!](https://shopify.dev/docs/api/admin-graphql/latest/objects/MetafieldDefinitionType) non-null The available metafield types that you can use when creating [`MetafieldDefinition`](https://shopify.dev/docs/api/admin-graphql/current/objects/MetafieldDefinition) objects. Each type specifies what kind of data it stores (such as boolean, color, date, or references), its category, and which validations it supports. For a list of supported types and their capabilities, refer to the [metafield types documentation](https://shopify.dev/docs/apps/metafields/types). * metaobject [Metaobject](https://shopify.dev/docs/api/admin-graphql/latest/objects/Metaobject) Retrieves a single [`Metaobject`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Metaobject) by its global ID. [Metaobjects](https://shopify.dev/docs/apps/build/custom-data#what-are-metaobjects) store custom structured data based on defined schemas. The returned metaobject includes its fields with values, display name, handle, and associated metadata like update timestamps and capabilities. * metaobject​By​Handle [Metaobject](https://shopify.dev/docs/api/admin-graphql/latest/objects/Metaobject) Retrieves a [`Metaobject`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Metaobject) by its handle and type. Handles are unique identifiers within a metaobject type. * metaobject​Definition [Metaobject​Definition](https://shopify.dev/docs/api/admin-graphql/latest/objects/MetaobjectDefinition) Retrieves a [`MetaobjectDefinition`](https://shopify.dev/docs/api/admin-graphql/latest/objects/MetaobjectDefinition) by its global ID. Metaobject definitions provide the structure and fields for metaobjects. The definition includes field configurations, access settings, display preferences, and capabilities that determine how [metaobjects](https://shopify.dev/docs/api/admin-graphql/latest/objects/Metaobject) of this type behave across the Shopify platform. * metaobject​Definition​By​Type [Metaobject​Definition](https://shopify.dev/docs/api/admin-graphql/latest/objects/MetaobjectDefinition) Retrieves a [`MetaobjectDefinition`](https://shopify.dev/docs/api/admin-graphql/latest/objects/MetaobjectDefinition) by its type. The type serves as a unique identifier that distinguishes one metaobject definition from another. * metaobject​Definitions [Metaobject​Definition​Connection!](https://shopify.dev/docs/api/admin-graphql/latest/connections/MetaobjectDefinitionConnection) non-null Returns a paginated list of all [`MetaobjectDefinition`](https://shopify.dev/docs/api/admin-graphql/latest/objects/MetaobjectDefinition) objects configured for the store. Metaobject definitions provide the schema for creating custom data structures composed of individual fields. Each definition specifies the field types, access permissions, and capabilities for [`Metaobject`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Metaobject) entries of that type. Use this query to discover available metaobject types before creating or querying metaobject entries. Learn more about [managing metaobjects](https://shopify.dev/docs/apps/build/custom-data/metaobjects/manage-metaobjects). * metaobjects [Metaobject​Connection!](https://shopify.dev/docs/api/admin-graphql/latest/connections/MetaobjectConnection) non-null Returns a paginated list of [`Metaobject`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Metaobject) entries for a specific type. Metaobjects are custom data structures that extend Shopify's data model with merchant or app-specific data types. Filter results using the query parameter with a search syntax for metaobject fields. Use `fields.{key}:{value}` to filter by field values, supporting any field previously marked as filterable. The `sortKey` parameter accepts `id`, `type`, `updated_at`, or `display_name` to control result ordering. Learn more about [querying metaobjects by field value](https://shopify.dev/docs/apps/build/custom-data/metafields/query-by-metafield-value). * mobile​Platform​Application [Mobile​Platform​Application](https://shopify.dev/docs/api/admin-graphql/latest/unions/MobilePlatformApplication) Return a mobile platform application by its ID. * mobile​Platform​Applications [Mobile​Platform​Application​Connection!](https://shopify.dev/docs/api/admin-graphql/latest/connections/MobilePlatformApplicationConnection) non-null List the mobile platform applications. * node [Node](https://shopify.dev/docs/api/admin-graphql/latest/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/latest/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/latest/objects/OnlineStore) non-null The shop's online store channel. * order [Order](https://shopify.dev/docs/api/admin-graphql/latest/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/latest/objects/Order) Return an order by an identifier. * order​Edit​Session [Order​Edit​Session](https://shopify.dev/docs/api/admin-graphql/latest/objects/OrderEditSession) Returns a `OrderEditSession` resource by ID. * order​Payment​Status [Order​Payment​Status](https://shopify.dev/docs/api/admin-graphql/latest/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/latest/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/latest/connections/SavedSearchConnection) non-null 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. * orders​Count [Count](https://shopify.dev/docs/api/admin-graphql/latest/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/latest/objects/Page) Returns a `Page` resource by ID. * pages [Page​Connection!](https://shopify.dev/docs/api/admin-graphql/latest/connections/PageConnection) non-null A paginated list of pages from the online store. [`Page`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Page) objects are content pages that merchants create to provide information to customers, such as "About Us", "Contact", or policy pages. The query supports filtering with a [search query](https://shopify.dev/docs/api/usage/search-syntax) and sorting by various criteria. Advanced filtering is available through saved searches using the [`savedSearchId`](https://shopify.dev/docs/api/admin-graphql/latest/queries/pages#arguments-savedSearchId) argument. * pages​Count [Count](https://shopify.dev/docs/api/admin-graphql/latest/objects/Count) Count of pages. Limited to a maximum of 10000 by default. * payment​Customization [Payment​Customization](https://shopify.dev/docs/api/admin-graphql/latest/objects/PaymentCustomization) The payment customization. * payment​Customizations [Payment​Customization​Connection!](https://shopify.dev/docs/api/admin-graphql/latest/connections/PaymentCustomizationConnection) non-null The payment customizations. * payment​Terms​Templates [\[Payment​Terms​Template!\]!](https://shopify.dev/docs/api/admin-graphql/latest/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/latest/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/latest/objects/PointOfSaleDevice) Returns a `PointOfSaleDevice` resource by ID. * price​List [Price​List](https://shopify.dev/docs/api/admin-graphql/latest/objects/PriceList) Returns a price list resource by ID. * price​Lists [Price​List​Connection!](https://shopify.dev/docs/api/admin-graphql/latest/connections/PriceListConnection) non-null All price lists for a shop. * privacy​Settings [Privacy​Settings!](https://shopify.dev/docs/api/admin-graphql/latest/objects/PrivacySettings) non-null Privacy related settings for a shop. * product [Product](https://shopify.dev/docs/api/admin-graphql/latest/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/latest/objects/Product) Return a product by an identifier. * product​Duplicate​Job [Product​Duplicate​Job!](https://shopify.dev/docs/api/admin-graphql/latest/objects/ProductDuplicateJob) non-null Returns the product duplicate job. * product​Feed [Product​Feed](https://shopify.dev/docs/api/admin-graphql/latest/objects/ProductFeed) Returns a ProductFeed resource by ID. * product​Feeds [Product​Feed​Connection!](https://shopify.dev/docs/api/admin-graphql/latest/connections/ProductFeedConnection) non-null The product feeds for the shop. * product​Operation [Product​Operation](https://shopify.dev/docs/api/admin-graphql/latest/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/latest/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/latest/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/latest/connections/SavedSearchConnection) non-null Returns a list of the shop's product saved searches. * products​Count [Count](https://shopify.dev/docs/api/admin-graphql/latest/objects/Count) Count of products. Limited to a maximum of 10000 by default. * product​Tags [String​Connection](https://shopify.dev/docs/api/admin-graphql/latest/connections/StringConnection) Returns tags added to [`Product`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Product) objects in the shop. Provides a paginated list of tag strings. The maximum page size is 5000 tags per request. Tags are returned as simple strings through a [`StringConnection`](https://shopify.dev/docs/api/admin-graphql/latest/objects/StringConnection). The maximum page size is 5000. * product​Types [String​Connection](https://shopify.dev/docs/api/admin-graphql/latest/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/latest/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/latest/objects/ProductVariant) Return a product variant by an identifier. * product​Variants [Product​Variant​Connection!](https://shopify.dev/docs/api/admin-graphql/latest/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/latest/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/latest/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/latest/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/latest/objects/Publication) Lookup a publication by ID. * publications [Publication​Connection!](https://shopify.dev/docs/api/admin-graphql/latest/connections/PublicationConnection) non-null List of publications. * publications​Count [Count](https://shopify.dev/docs/api/admin-graphql/latest/objects/Count) Count of publications. Limited to a maximum of 10000 by default. * published​Products​Count [Count](https://shopify.dev/docs/api/admin-graphql/latest/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/latest/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/latest/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/latest/objects/ReturnableFulfillment) Returns a `ReturnableFulfillment` resource by ID. * returnable​Fulfillments [Returnable​Fulfillment​Connection!](https://shopify.dev/docs/api/admin-graphql/latest/connections/ReturnableFulfillmentConnection) non-null List of returnable fulfillments. * return​Calculate [Calculated​Return](https://shopify.dev/docs/api/admin-graphql/latest/objects/CalculatedReturn) The calculated monetary value to be exchanged due to the return. * reverse​Delivery [Reverse​Delivery](https://shopify.dev/docs/api/admin-graphql/latest/objects/ReverseDelivery) Lookup a reverse delivery by ID. * reverse​Fulfillment​Order [Reverse​Fulfillment​Order](https://shopify.dev/docs/api/admin-graphql/latest/objects/ReverseFulfillmentOrder) Lookup a reverse fulfillment order by ID. * script​Tag [Script​Tag](https://shopify.dev/docs/api/admin-graphql/latest/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/latest/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/latest/objects/Segment) Retrieves a customer [`Segment`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Segment) by ID. Segments are dynamic groups of customers that meet specific criteria defined through [ShopifyQL queries](https://shopify.dev/docs/api/shopifyql/segment-query-language-reference). Use segments for targeted marketing campaigns, analyzing customer behavior, or creating personalized experiences. Each segment includes its name, creation date, and the query that defines which [`Customer`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Customer) objects belong to it. * segment​Filters [Segment​Filter​Connection!](https://shopify.dev/docs/api/admin-graphql/latest/connections/SegmentFilterConnection) non-null A list of filters. * segment​Filter​Suggestions [Segment​Filter​Connection!](https://shopify.dev/docs/api/admin-graphql/latest/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/latest/connections/SegmentMigrationConnection) non-null A list of a shop's segment migrations. * segments [Segment​Connection!](https://shopify.dev/docs/api/admin-graphql/latest/connections/SegmentConnection) non-null Returns a paginated list of [`Segment`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Segment) objects for the shop. Segments are dynamic groups of customers that meet specific criteria defined through [ShopifyQL queries](https://shopify.dev/docs/api/shopifyql/segment-query-language-reference). You can filter segments by search query and sort them by creation date or other criteria. The query supports standard [pagination](https://shopify.dev/docs/api/usage/pagination-graphql) arguments and returns a [`SegmentConnection`](https://shopify.dev/docs/api/admin-graphql/latest/objects/SegmentConnection) containing segment details including names, creation dates, and the query definitions that determine segment membership. * segments​Count [Count](https://shopify.dev/docs/api/admin-graphql/latest/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/latest/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/latest/objects/SellingPlanGroup) Returns a `SellingPlanGroup` resource by ID. * selling​Plan​Groups [Selling​Plan​Group​Connection!](https://shopify.dev/docs/api/admin-graphql/latest/connections/SellingPlanGroupConnection) non-null List Selling Plan Groups. * server​Pixel [Server​Pixel](https://shopify.dev/docs/api/admin-graphql/latest/objects/ServerPixel) The server pixel configured by the app. * shop [Shop!](https://shopify.dev/docs/api/admin-graphql/latest/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/latest/objects/ShopBillingPreferences) non-null The shop's billing preferences, including the currency for paying for apps and services. Use this to create [app charges in the merchant's local billing currency](https://shopify.dev/docs/apps/launch/billing#supported-currencies), helping them budget their app spend without exposure to exchange rate fluctuations. * shopify​Function [Shopify​Function](https://shopify.dev/docs/api/admin-graphql/latest/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/latest/connections/ShopifyFunctionConnection) non-null Returns Shopify Functions owned by the querying API client installed on the shop. [Functions](https://shopify.dev/docs/apps/build/functions) enable you to customize Shopify's backend logic at specific points in the commerce loop, such as discounts, checkout validation, and fulfillment. You can filter the results by API type to find specific function implementations, or by whether they provide a merchant configuration interface in the Shopify Admin. The response includes details about each function's configuration, including its title, description, API version, and the input query used to provide data to the function logic. Learn more about [building functions](https://shopify.dev/docs/api/functions). * shopify​Payments​Account [Shopify​Payments​Account](https://shopify.dev/docs/api/admin-graphql/latest/objects/ShopifyPaymentsAccount) Shopify Payments account information, including balances and payouts. * shopifyql​Query [Shopifyql​Query​Response](https://shopify.dev/docs/api/admin-graphql/latest/objects/ShopifyqlQueryResponse) Executes a [ShopifyQL query](https://shopify.dev/docs/api/shopifyql/segment-query-language-reference) to analyze store data and returns results in a tabular format. The response includes column metadata with names, data types, and display names, along with the actual data rows. If the query contains syntax errors, then the response provides parse error messages instead of table data. * shop​Locales [\[Shop​Locale!\]!](https://shopify.dev/docs/api/admin-graphql/latest/objects/ShopLocale) non-null Returns the locales enabled on a shop. Each locale represents a language for translations and determines how content displays to customers in different markets. Use the optional `published` argument to filter for only the locales that are visible to customers. The response includes the ISO locale code, whether it's the shop's primary locale, and which [`MarketWebPresence`](https://shopify.dev/docs/api/admin-graphql/latest/objects/MarketWebPresence) objects use each locale. * shop​Pay​Payment​Request​Receipt [Shop​Pay​Payment​Request​Receipt](https://shopify.dev/docs/api/admin-graphql/latest/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/latest/connections/ShopPayPaymentRequestReceiptConnection) Returns a list of Shop Pay payment request receipts. * staff​Member [Staff​Member](https://shopify.dev/docs/api/admin-graphql/latest/objects/StaffMember) Retrieves a [staff member](https://shopify.dev/docs/api/admin-graphql/latest/objects/StaffMember) by ID. If no ID is provided, the query returns the staff member that's making the request. A staff member is a user who can access the Shopify admin to manage store operations. Provides staff member details such as email, name, and shop owner status. When querying the current user (with or without an ID), additional [private data](https://shopify.dev/docs/api/admin-graphql/latest/queries/staffMember#returns-StaffMember.fields.privateData) becomes available. * staff​Members [Staff​Member​Connection](https://shopify.dev/docs/api/admin-graphql/latest/connections/StaffMemberConnection) Returns a paginated list of [`StaffMember`](https://shopify.dev/docs/api/admin-graphql/latest/objects/StaffMember) objects for the shop. Staff members are users who can access the Shopify admin to manage store operations. Supports filtering by account type, email, and name, with an option to sort results. The query returns a [`StaffMemberConnection`](https://shopify.dev/docs/api/admin-graphql/latest/connections/StaffMemberConnection) for [cursor-based pagination](https://shopify.dev/docs/api/usage/pagination-graphql). * standard​Metafield​Definition​Templates [Standard​Metafield​Definition​Template​Connection!](https://shopify.dev/docs/api/admin-graphql/latest/connections/StandardMetafieldDefinitionTemplateConnection) non-null Retrieves preset metafield definition templates for common use cases. Each template provides a reserved namespace and key combination for specific purposes like product subtitles, care guides, or ISBN numbers. Use these templates to create standardized metafields across your store. Filter templates by constraint status or exclude those you've already activated. See the [list of standard metafield definitions](https://shopify.dev/docs/apps/build/custom-data/metafields/list-of-standard-definitions) for available templates. * store​Credit​Account [Store​Credit​Account](https://shopify.dev/docs/api/admin-graphql/latest/objects/StoreCreditAccount) Retrieves a [`StoreCreditAccount`](https://shopify.dev/docs/api/admin-graphql/latest/objects/StoreCreditAccount) by ID. Store credit accounts hold monetary balances that account owners can use at checkout. The owner is either a [`Customer`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Customer) or a [`CompanyLocation`](https://shopify.dev/docs/api/admin-graphql/latest/objects/CompanyLocation). * subscription​Billing​Attempt [Subscription​Billing​Attempt](https://shopify.dev/docs/api/admin-graphql/latest/objects/SubscriptionBillingAttempt) Returns a `SubscriptionBillingAttempt` resource by ID. * subscription​Billing​Attempts [Subscription​Billing​Attempt​Connection!](https://shopify.dev/docs/api/admin-graphql/latest/connections/SubscriptionBillingAttemptConnection) non-null Returns subscription billing attempts on a store. * subscription​Billing​Cycle [Subscription​Billing​Cycle](https://shopify.dev/docs/api/admin-graphql/latest/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/latest/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/latest/connections/SubscriptionBillingCycleConnection) non-null Returns subscription billing cycles for a contract ID. * subscription​Contract [Subscription​Contract](https://shopify.dev/docs/api/admin-graphql/latest/objects/SubscriptionContract) Returns a Subscription Contract resource by ID. * subscription​Contracts [Subscription​Contract​Connection!](https://shopify.dev/docs/api/admin-graphql/latest/connections/SubscriptionContractConnection) non-null List Subscription Contracts. * subscription​Draft [Subscription​Draft](https://shopify.dev/docs/api/admin-graphql/latest/objects/SubscriptionDraft) Returns a Subscription Draft resource by ID. * taxonomy [Taxonomy](https://shopify.dev/docs/api/admin-graphql/latest/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/latest/connections/TenderTransactionConnection) non-null Transactions representing a movement of money between customers and the shop. Each transaction records the amount, payment method, processing details, and the associated [`Order`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Order). Positive amounts indicate customer payments to the merchant. Negative amounts represent refunds from the merchant to the customer. Use the [`query`](https://shopify.dev/docs/api/admin-graphql/latest/queries/tenderTransactions#arguments-query) parameter to filter transactions by attributes such as transaction ID, processing date, and point-of-sale device ID. * theme [Online​Store​Theme](https://shopify.dev/docs/api/admin-graphql/latest/objects/OnlineStoreTheme) Returns an [`OnlineStoreTheme`](https://shopify.dev/docs/api/admin-graphql/latest/objects/OnlineStoreTheme) by its ID. Use this query to retrieve theme metadata and access the theme's [`files`](https://shopify.dev/docs/api/admin-graphql/latest/queries/theme#returns-OnlineStoreTheme.fields.files), which include templates, assets, [translations](https://shopify.dev/docs/api/admin-graphql/latest/objects/OnlineStoreTheme#field-published_translations), and configuration files. * themes [Online​Store​Theme​Connection](https://shopify.dev/docs/api/admin-graphql/latest/connections/OnlineStoreThemeConnection) Returns a paginated list of [`OnlineStoreTheme`](https://shopify.dev/docs/api/admin-graphql/latest/objects/OnlineStoreTheme) objects for the online store. Themes control the appearance and layout of the storefront. You can filter themes by [`role`](https://shopify.dev/docs/api/admin-graphql/latest/queries/themes#arguments-roles) to find specific theme types, such as `MAIN` for the published theme and `UNPUBLISHED` for draft themes. * translatable​Resource [Translatable​Resource](https://shopify.dev/docs/api/admin-graphql/latest/objects/TranslatableResource) Retrieves a resource that has translatable fields. Returns the resource's [`Translation`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Translation) objects for different locales and markets, along with the original [`TranslatableContent`](https://shopify.dev/docs/api/admin-graphql/latest/objects/TranslatableContent) and digest values needed to register new translations. Provides access to existing translations, translatable content with digest hashes for translation registration, and nested translatable resources like [`ProductVariant`](https://shopify.dev/docs/api/admin-graphql/latest/objects/ProductVariant) objects or [`Metafield`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Metafield) objects. Learn more about [managing translated content](https://shopify.dev/docs/apps/build/markets/manage-translated-content). * translatable​Resources [Translatable​Resource​Connection!](https://shopify.dev/docs/api/admin-graphql/latest/connections/TranslatableResourceConnection) non-null Returns a paginated list of [`TranslatableResource`](https://shopify.dev/docs/api/admin-graphql/latest/objects/TranslatableResource) objects for a specific resource type. Each resource provides translatable content and digest values needed for the [`translationsRegister`](https://shopify.dev/docs/api/admin-graphql/latest/mutations/translationsRegister) mutation. Learn more about [managing translated content](https://shopify.dev/docs/apps/build/markets/manage-translated-content). Learn more about [managing translated content](https://shopify.dev/docs/apps/build/markets/manage-translated-content). * translatable​Resources​By​Ids [Translatable​Resource​Connection!](https://shopify.dev/docs/api/admin-graphql/latest/connections/TranslatableResourceConnection) non-null Returns a paginated list of [`TranslatableResource`](https://shopify.dev/docs/api/admin-graphql/latest/objects/TranslatableResource) objects for the specified resource IDs. Each resource provides translatable content and digest values needed for the [`translationsRegister`](https://shopify.dev/docs/api/admin-graphql/latest/mutations/translationsRegister) mutation. Learn more about [managing translated content](https://shopify.dev/docs/apps/build/markets/manage-translated-content). * url​Redirect [Url​Redirect](https://shopify.dev/docs/api/admin-graphql/latest/objects/UrlRedirect) Returns a `UrlRedirect` resource by ID. * url​Redirect​Import [Url​Redirect​Import](https://shopify.dev/docs/api/admin-graphql/latest/objects/UrlRedirectImport) Returns a `UrlRedirectImport` resource by ID. * url​Redirects [Url​Redirect​Connection!](https://shopify.dev/docs/api/admin-graphql/latest/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/latest/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/latest/objects/Count) Count of redirects. Limited to a maximum of 10000 by default. * validation [Validation](https://shopify.dev/docs/api/admin-graphql/latest/objects/Validation) Validation available on the shop. * validations [Validation​Connection!](https://shopify.dev/docs/api/admin-graphql/latest/connections/ValidationConnection) non-null Validations available on the shop. * webhook​Subscription [Webhook​Subscription](https://shopify.dev/docs/api/admin-graphql/latest/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/latest/connections/WebhookSubscriptionConnection) non-null Retrieves a paginated list of webhook subscriptions created using the API for the current app and shop. *** Note Returns only shop-scoped subscriptions, not app-scoped subscriptions configured in TOML files. *** Subscription details include event topics, endpoint URIs, filtering rules, field inclusion settings, and metafield namespace permissions. Results support cursor-based pagination that you can filter by topic, format, or custom search criteria. 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/latest/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/latest/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/latest/connections/MarketWebPresenceConnection) The web presences for the shop. ### Deprecated fields * automatic​Discount [Discount​Automatic](https://shopify.dev/docs/api/admin-graphql/latest/unions/DiscountAutomatic) Deprecated * automatic​Discounts [Discount​Automatic​Connection!](https://shopify.dev/docs/api/admin-graphql/latest/connections/DiscountAutomaticConnection) non-nullDeprecated * channel [Channel](https://shopify.dev/docs/api/admin-graphql/latest/objects/Channel) Deprecated * channels [Channel​Connection!](https://shopify.dev/docs/api/admin-graphql/latest/connections/ChannelConnection) non-nullDeprecated * collection​By​Handle [Collection](https://shopify.dev/docs/api/admin-graphql/latest/objects/Collection) Deprecated * current​Bulk​Operation [Bulk​Operation](https://shopify.dev/docs/api/admin-graphql/latest/objects/BulkOperation) Deprecated * deletion​Events [Deletion​Event​Connection!](https://shopify.dev/docs/api/admin-graphql/latest/connections/DeletionEventConnection) non-nullDeprecated * locations​Available​For​Delivery​Profiles [\[Location!\]](https://shopify.dev/docs/api/admin-graphql/latest/objects/Location) Deprecated * market​By​Geography [Market](https://shopify.dev/docs/api/admin-graphql/latest/objects/Market) Deprecated * primary​Market [Market!](https://shopify.dev/docs/api/admin-graphql/latest/objects/Market) non-nullDeprecated * product​By​Handle [Product](https://shopify.dev/docs/api/admin-graphql/latest/objects/Product) Deprecated *** ## Map ### Fields with this object * {}[Job.query](https://shopify.dev/docs/api/admin-graphql/latest/objects/Job#field-Job.fields.query)