11/12/2026, 12:00:37 AM
The schema now includes the eventSubscriptionsSet mutation, allowing apps to bulk‑create or replace up to 25 event subscriptions in a single call. Subscriptions are defined with the new EventSubscriptionInput type, and the resulting payload (EventSubscriptionsSetPayload) exposes the configured subscriptions and any EventSubscriptionsSetUserError errors. The productOptionUpdate mutation got a documentation tweak: the optionValuesToAdd argument now explicitly states that values are appended in order and refers to productOptionsReorder for custom ordering. Several new fields enhance inventory visibility: startedAt on InventoryCount, the paginated inventoryCounts list on Location, and the IS_DEFAULT sort key for InventoryBinSortKeys. Metaobject schemas can now declare a thumbnail selector via the added displayThumbnailKey field on MetaobjectDefinition. Additionally, new sort keys (CREATED_AT) were added to CollectionConditionsSourceSortKeys and PriceListSortKeys, and the schemas are only available in the unstable API version.
Creates or replaces event subscriptions of the authenticated app on the shop, matched by handle.
Each input is a subscription's complete configuration. When no subscription has the handle, one is
created. When one does, its whole configuration is replaced: a field left out of the input is removed
from the subscription. Event payloads use the API version of the request.
The subscriptions are set together: when any of them is invalid, none is set. Takes up to
25 subscriptions in one call.
Updates an option
on a product,
such as size, color, or material. Each option includes a name, position, and a list of values. The combination
of a product option and value creates a product variant.
Use the productOptionUpdate mutation for the following use cases:
Note:
TheproductOptionUpdatemutation enforces strict data integrity for product options and variants.
All option positions must be sequential, and every option should be used by at least one variant.
After you update a product option, you can further manage a product's configuration using related mutations:
productOptionsCreateproductOptionsDeleteproductOptionsReorderproductVariantsBulkCreateproductVariantsBulkUpdateproductSetLearn more about the product model
and adding product data.
An event subscription that the app set on the shop.
The actions on a resource that an event subscription delivers.
The input fields for the complete configuration of an event subscription.
Return type for eventSubscriptionsSet mutation.
An error that occurs during the execution of EventSubscriptionsSet.
Possible error codes that can be returned by EventSubscriptionsSetUserError.
CREATED_ATIS_DEFAULTstartedAtThe date and time counting started, which is when the count's earliest recorded observation was made.
Returns null when the count has no observations.
inventoryCountsA paginated list of the inventory counts at this location.
Note:
This field is available only in the unstable API version.
displayThumbnailKeyThe key of the field that each object uses as its thumbnail. When null, a thumbnail is selected automatically from the object's eligible fields. When set, only that field is used, even if its value is empty. A list field uses its first item.
CREATED_AT