8/19/2025, 3:25:48 PM
The collectionReorderProducts mutation’s description and arguments were rewritten to clarify that only moved products should be sent, that moves are applied sequentially, and that newPosition is a zero‑based index evaluated after each prior move; the mutation now returns a job object. The moves list’s documentation was updated to emphasize sending only changed products, allowing non‑unique newPosition values and moving items to the end if the value exceeds the list length. The mutation’s return type remains CollectionReorderProductsPayload. Additional schema changes include converting CheckoutAndAccountsAppConfiguration.brandingConfiguration from a raw JSON scalar to a typed CheckoutBranding object, removing the resourceType field from CustomerPaymentMethod, and adding several new enum values for various error codes (TAG_EXCEEDS_MAX_LENGTH, ACTIVATION_FAILED, etc.). A new field disputeEvidence was added to ShopifyPaymentsDispute to expose dispute evidence details, and a set of LENDING‑related transaction types was added to ShopifyPaymentsTransactionType. The enum StagedUploadTargetGenerateUploadResource now includes DISPUTE_FILE_UPLOAD. Finally, the entire MandateResourceType enum was removed from the schema. Developers must adjust mutation payloads for collection reordering, update type handling for the new branding object, and account for the removed field and added enums in error handling and transaction logic.
Asynchronously reorders products within a specified collection. Instead of returning an updated collection, this mutation returns a job, which should be polled. The Collection.sortOrder must be MANUAL.
How to use this mutation:
moves list; do not send the entire product list. For example: to move the product at index 1 to index N, send a single move for that product with newPosition: N.newPosition is a zero-based index within the collection at the moment the move is applied (after any prior moves in the list).moves keep their relative order, aside from any displacement caused by the moves.newPosition is greater than or equal to the number of products, the product is placed at the end.Example:
Displaced products will have their position altered in a consistent manner with no gaps.
The type of resource a payment mandate can be used for.
brandingConfigurationresourceTypeACTIVATION_FAILEDTAG_EXCEEDS_MAX_LENGTHTAG_EXCEEDS_MAX_LENGTHTAG_EXCEEDS_MAX_LENGTHINVALID_COUNTRY_AND_PROVINCE_DRIVERSPROVINCE_MUST_BELONG_TO_COUNTRYCANNOT_ADD_ALL_PROVINCES_FOR_A_COUNTRY_TO_A_MARKETINVALID_RESPONDER_FOR_PROVINCE_DRIVEN_MARKETPRESERVE_STANDALONE_VARIANTreferencedisputeEvidenceThe evidence associated with the dispute.
LENDING_DEBITLENDING_DEBIT_REVERSALLENDING_CREDITLENDING_CREDIT_REVERSALLENDING_CAPITAL_REMITTANCELENDING_CAPITAL_REMITTANCE_REVERSALLENDING_CREDIT_REMITTANCELENDING_CREDIT_REMITTANCE_REVERSALLENDING_CAPITAL_REFUNDLENDING_CAPITAL_REFUND_REVERSALLENDING_CREDIT_REFUNDLENDING_CREDIT_REFUND_REVERSALDISPUTE_FILE_UPLOAD