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.
brandingConfiguration
resourceType
ACTIVATION_FAILED
TAG_EXCEEDS_MAX_LENGTH
TAG_EXCEEDS_MAX_LENGTH
TAG_EXCEEDS_MAX_LENGTH
INVALID_COUNTRY_AND_PROVINCE_DRIVERS
PROVINCE_MUST_BELONG_TO_COUNTRY
CANNOT_ADD_ALL_PROVINCES_FOR_A_COUNTRY_TO_A_MARKET
INVALID_RESPONDER_FOR_PROVINCE_DRIVEN_MARKET
PRESERVE_STANDALONE_VARIANT
reference
disputeEvidence
The evidence associated with the dispute.
LENDING_DEBIT
LENDING_DEBIT_REVERSAL
LENDING_CREDIT
LENDING_CREDIT_REVERSAL
LENDING_CAPITAL_REMITTANCE
LENDING_CAPITAL_REMITTANCE_REVERSAL
LENDING_CREDIT_REMITTANCE
LENDING_CREDIT_REMITTANCE_REVERSAL
LENDING_CAPITAL_REFUND
LENDING_CAPITAL_REFUND_REVERSAL
LENDING_CREDIT_REFUND
LENDING_CREDIT_REFUND_REVERSAL
DISPUTE_FILE_UPLOAD