1 new queries, 1 new mutations

8/29/2026, 12:00:48 AM

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

Query Changes

βž• Added Queries (1)

feeDetails

The fees charged to the shop.

πŸ”„ Modified Queries (2)

inventoryPurchaseOrders

Returns a paginated list of purchase orders.

Note:
This query is available only in the unstable API version and to development stores
that have enabled the Physical inventory feature preview.

~ Modified argument: query
metaobjects

Returns a paginated list of 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.

Results are ordered by metaobject ID in ascending order by default. The sortKey parameter accepts id, type, updated_at, or display_name to control result ordering. Pass reverse: true to invert the order.

Learn more about querying metaobjects by field value.

Mutation Changes

βž• Added Mutations (1)

externalPartnerStorefrontDomainPublish

Publishes an external partner storefront hostname for the shop by creating or returning the domain ownership verification for the host. Never activates the domain.

πŸ”„ Modified Mutations (1)

inventoryActivate

Activates an inventory item at a Location by creating an InventoryLevel that tracks stock quantities. This enables you to manage inventory for a ProductVariant at the specified location.

When you activate an inventory item, you can set its initial quantities. The available argument sets the quantity that's available for sale. onHand argument sets the total physical quantity at the location. If you don't specify quantities, then available and onHand default to zero.

Caution:
As of version 2026-01, this mutation supports an optional idempotency key using the @idempotent directive.
As of version 2026-04, the idempotency key is required and must be provided using the @idempotent directive.
For more information, see the idempotency documentation.

Learn more about managing inventory quantities and states.

~ Modified argument: stockAtLegacyLocation

Type Changes

βž• Added Types (13)

πŸ—οΈExternalPartnerStorefrontDomainβž• AddedOBJECT

A storefront domain published to a shop by an external partner.

Fields: host, verificationRecords, verificationStatus
πŸ—οΈExternalPartnerStorefrontDomainPublishPayloadβž• AddedOBJECT

Return type for externalPartnerStorefrontDomainPublish mutation.

Fields: domain, resourceCreated, userErrors
πŸ—οΈExternalPartnerStorefrontDomainPublishUserErrorβž• AddedOBJECT

An error that occurs during the execution of ExternalPartnerStorefrontDomainPublish.

Fields: code, field, message
πŸ“‹ExternalPartnerStorefrontDomainPublishUserErrorCodeβž• AddedENUM

Possible error codes that can be returned by ExternalPartnerStorefrontDomainPublishUserError.

Values: EXTERNAL_PARTNER_STOREFRONT_DOMAIN_PUBLISH_ERROR, BLANK, INVALID, TAKEN, FEATURE_NOT_ENABLED, APP_NOT_INSTALLED, PUBLISHED_BY_ANOTHER_API_CLIENT, INVALID_DOMAIN_HOST_ERROR ... +8 more
πŸ—οΈExternalPartnerStorefrontDomainVerificationRecordβž• AddedOBJECT

A DNS record used to verify an external partner storefront domain.

Fields: name, status, type, value
πŸ“‹ExternalPartnerStorefrontDomainVerificationRecordStatusβž• AddedENUM

The status of a DNS record used to verify an external partner storefront domain.

Values: ADD, FAILURE, OK
πŸ“‹ExternalPartnerStorefrontDomainVerificationRecordTypeβž• AddedENUM

The type of DNS record used to verify an external partner storefront domain.

Values: TXT
πŸ“‹ExternalPartnerStorefrontDomainVerificationStatusβž• AddedENUM

The verification status of an external partner storefront domain.

Values: ACTION_REQUIRED, FAILED, VERIFIED
πŸ—οΈFeeDetailsβž• AddedOBJECT

A fee charged to the shop.

Fields: amount, createdAt, feeName, flatRate, id ... +7 more
πŸ—οΈFeeDetailsConnectionβž• AddedOBJECT

An auto-generated type for paginating through multiple FeeDetails.

Fields: edges, nodes, pageInfo
πŸ—οΈFeeDetailsEdgeβž• AddedOBJECT

An auto-generated type which holds one FeeDetails and a cursor during pagination.

Fields: cursor, node
πŸ—οΈFeeDetailsMetadataβž• AddedOBJECT

Additional metadata associated with a fee.

Fields: attributionEndTime, attributionStartTime, planName
πŸ“‹FeeDetailsSortKeysβž• AddedENUM

The set of valid sort keys for the FeeDetails query.

Values: CREATED_AT, ID

πŸ”„ Modified Types (10)

πŸ—οΈCalculatedReturnShippingFeeπŸ”„ Modified
βž• Field added: taxAmountSet

The total tax amount on the return shipping fee, in shop and presentment currencies. Returns zero while tax calculation is being rolled out.

πŸ—οΈCollectionDuplicateUserErrorCodeπŸ”„ Modified
βž• Enum value added: BLANK
βž• Enum value added: TOO_LONG
βž• Enum value added: TAKEN
βž• Enum value added: INVALID
βž• Enum value added: TOO_MANY_SUB_COLLECTION_INCLUSION_COLLECTIONS
βž• Enum value added: TOO_MANY_SUB_COLLECTION_EXCLUSION_COLLECTIONS
βž• Enum value added: TOO_MANY_CONDITION_BACKED_SOURCES
πŸ—οΈInventoryCountCreateUserErrorCodeπŸ”„ Modified
βž– Enum value removed: COMPARE_QUANTITY_STALE
βž• Enum value added: CHANGE_FROM_QUANTITY_STALE
πŸ—οΈInventoryTransferDuplicateUserErrorCodeπŸ”„ Modified
βž• Enum value added: INVALID_QUANTITY
πŸ—οΈMarketUserErrorCodeπŸ”„ Modified
βž• Enum value added: MIXED_COUNTRY_SUBDIVISIONS_NOT_ALLOWED
πŸ—οΈMetaobjectFieldDefinitionπŸ”„ Modified
βž– Field removed: visibleToStorefrontApi
πŸ—οΈOnlineStoreThemeFilesUserErrorsCodeπŸ”„ Modified
βž• Enum value added: OPERATION_IN_PROGRESS
πŸ—οΈShopifyPaymentsTransactionTypeπŸ”„ Modified
βž• Enum value added: MANAGED_MARKETS_ADAPTIVE_SHIPPING_REFUND_CREDIT
βž• Enum value added: MANAGED_MARKETS_ADAPTIVE_SHIPPING_REFUND_CREDIT_REVERSAL
πŸ—οΈStandardMetaobjectDefinitionFieldTemplateπŸ”„ Modified
βž– Field removed: visibleToStorefrontApi
πŸ—οΈSubscriptionLineπŸ”„ Modified
βž• Field added: weight

The weight of one unit of the item associated with the subscription line.