Schema Update

5/3/2026, 12:00:59 AM

API changes: 0 queries added, 0 removed. 0 mutations added, 0 removed. 2 types affected.

Query Changes

πŸ”„ Modified Queries (1)

productVariants

Retrieves a list of product variants
associated with a product.

A product variant is a specific version of a product that comes in more than
one option,
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
to handle large product catalogs and saved searches
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.

~ Modified argument: query

Mutation Changes

πŸ”„ Modified Mutations (2)

subscriptionBillingCycleBulkCharge

Asynchronously queries and charges all subscription billing cycles whose billingAttemptExpectedDate values fall within a specified date range and meet additional filtering criteria. The results of this action can be retrieved using the subscriptionBillingCycleBulkResults query.

+ New argument: actor
subscriptionBillingCycleCharge

Creates a new subscription billing attempt for a specified billing cycle. This is the alternative mutation for subscriptionBillingAttemptCreate. For more information, refer to Create a subscription contract.

+ New argument: actor

Type Changes

βž• Added Types (1)

πŸ“‹SubscriptionActorβž• AddedENUM

The actor who initiated a subscription action.

Values: CUSTOMER, MERCHANT, PARTNER

πŸ”„ Modified Types (1)

πŸ—οΈShopπŸ”„ Modified
πŸ”„ Field modified: productVariants