9/2/2026, 12:00:55 AM
The API now offers a new mutation, externalPartnerStorefrontDomainVerifyTxt, that checks the TXT record of a partner storefront host name and returns an ExternalPartnerStorefrontDomainVerifyTxtPayload containing the domain and any user errors. Errors are represented by ExternalPartnerStorefrontDomainVerifyTxtUserError with a set of specific error codes. A new input argument, categoryId, can now be supplied to orderEditAddCustomItem, letting apps link custom line items to Shopify’s Standard Product Taxonomy. The CalculatedLineItem type now exposes a taxonomyCategory field to surface that taxonomy association. ReturnShippingFee now includes a finalizedTaxAmountSet that locks case tax amounts once the returnProcess is called. The SubscriptionContract and SubscriptionBillingCycleEditedContract latestCommittedProjectedOrderTotals fields now note that totals may originate from a subscription draft commit. Finally, the webhook topic AGENTIC_DIRECT_CHECKOUT_ELIGIBILITY_UPDATE has been added to WebhookSubscriptionTopic.
Checks TXT verification for an external partner storefront hostname. Activation, when eligible, is handled asynchronously by the verification-completion flow.
Adds a custom line item to an existing Order. Custom line items represent products or services not in your catalog, such as gift wrapping, installation fees, or one-off charges.
Creates a CalculatedLineItem with the specified title, price, and quantity. Changes remain in the edit session until you commit them with the orderEditCommit mutation.
Learn more about adding custom line items.
Return type for externalPartnerStorefrontDomainVerifyTxt mutation.
An error that occurs during the execution of ExternalPartnerStorefrontDomainVerifyTxt.
Possible error codes that can be returned by ExternalPartnerStorefrontDomainVerifyTxtUserError.
taxonomyCategoryThe product category from
Shopify's Standard Product Taxonomy
associated with the calculated line item.
finalizedTaxAmountSetThe finalized tax amount on the return shipping fee, in shop and presentment currencies. This is locked in when returnProcess is called. Returns null if the return hasn't yet been processed.
latestCommittedProjectedOrderTotalslatestCommittedProjectedOrderTotalsAGENTIC_DIRECT_CHECKOUT_ELIGIBILITY_UPDATE