7/15/2026, 12:00:29 AM
Shopify now exposes return policy profiles via returnPolicyProfile and returnPolicyProfiles queries, enabling apps to fetch profile details such as default status, markets, edit and return rules. The new requestedEditDecline mutation lets a merchant decline a buyer‑initiated edit request, returning the updated RequestedEdit object and any validation errors. Orders can retrieve all pending or resolved requested edits through the added requestedEdits field, complete with pagination support. Analytics schema gained multi‑schema support flags and tier availability metadata, and fields like eventConfig, metaobjectMetadata and tiers provide richer context for app event queries. The OnlineStoreTheme.files field now accepts a sessionId argument to overlay staged files, expanding theme file querying capabilities. Several deprecated MetafieldDefinition error codes were removed, and new return policy types such as ReturnPoliciesEditRules and ReturnPoliciesReturnRules were introduced to describe buyer‑initiated edit and return logic.
Returns a return policy profile of a shop.
Returns the return policy profiles of a shop.
Declines a requested edit on an order.
Purchases a shipping label for a fulfillment order.
The shippingLabelPurchase mutation buys one shipping label for one fulfillment order using Shopify Shipping.
The mutation validates the fulfillment order, shipment details, package information, and available rates before it starts an asynchronous label purchase.
Note:
The shop must have accepted the Shopify Shipping terms of service before an app can purchase labels.FedEx label purchases are not supported.
After validation, the mutation builds the shipment details, fetches available rates, selects a rate, and enqueues the label purchase. If you provide preferredRateSelection, the mutation attempts to purchase the matching carrier and service. If you don't provide preferredRateSelection, the mutation uses Shopify Shipping's default rate selection.
Default rate selection first tries to keep the fulfillment order's buyer-selected delivery method when available. If no buyer-selected rate matches, the mutation uses the shop's preferred carrier and service when configured. Otherwise, it uses Shopify's recommended rate for the shipment destination.
For Merchant of Record (MoR) and Markets Pro orders, the mutation first removes rates from carriers that don't support Markets Pro.
A shipping label can be purchased only when the fulfillment order meets the following criteria:
The mutation can return errors in two places:
userErrors field. For example, invalid fulfillment orders, invalid package dimensions, missing customs information, or unavailable rates.ShippingLabelPurchaseResult.errors field after the purchase starts. For example, carrier availability, connection, billing, or other purchase-processing failures.Use the returned ShippingLabelPurchaseResult.id to poll the purchase status with the node query. The result starts with a status of PENDING_PURCHASE and ends with PURCHASED or PURCHASE_FAILED. When the purchase succeeds, shippingLabels contains the purchased label.
Configuration for an analytics schema field in the context of app events queries.
Whether an analytics schema event field is custom or standard.
Valid event scopes for an analytics schema event field.
Metadata associated with a metaobject-backed field.
Availability metadata for a schema tier.
A buyer-initiated request to edit unfulfilled line items on an order.
An auto-generated type for paginating through multiple RequestedEdits.
The input fields for declining a requested edit.
Return type for requestedEditDecline mutation.
Errors related to declining a requested edit.
Possible error codes that can be returned by RequestedEditDeclineUserError.
An auto-generated type which holds one RequestedEdit and a cursor during pagination.
A line item included in a buyer-initiated requested edit.
An auto-generated type for paginating through multiple RequestedEditLineItems.
An auto-generated type which holds one RequestedEditLineItem and a cursor during pagination.
The status of a buyer-initiated requested edit.
Rules that apply to buyer-initiated edit and cancellation requests under a return policy profile.
Return Rules that apply to returns under a return policy profile.
The starting point for calculating a return window.
A return policy profile.
An auto-generated type for paginating through multiple ReturnPolicyProfiles.
An auto-generated type which holds one ReturnPolicyProfile and a cursor during pagination.
supportsMultiFactQueriesWhether this schema can be selected with other schemas in a query.
tierAvailabilityA list of tiers for the schema, controlling access to certain fields based on a date range.
eventConfigConfiguration for this field in the context of app events queries.
metaobjectMetadataMetadata associated with a metaobject-backed field.
tiersThe tiers that this field is valid for, when the schema defines tier availability.
APP_EVENTMETAOBJECTMARKET_METAFIELDS_NOT_COMPATIBLE_WITH_CONDITION_TYPESMARKET_METAFIELDS_NOT_COMPATIBLE_WITH_CONDITION_TYPESMARKET_METAFIELDS_NOT_COMPATIBLE_WITH_CONDITION_TYPESfilesrequestedEditsThe buyer-initiated requested edits on unfulfilled line items for this order.