[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"$fctz7szD-fKymEADz06EJqPp31Xaq9OEBOvtPsF3PcJE":3,"$fGcc2Ef1n7S_X2-qMt0ql-WWslnaB2uYM-I-uPWbJlyI":21},{"status":4,"source":5,"previous":12,"current":16,"newerSnapshotId":20,"olderSnapshotId":13},"has-previous",{"id":6,"displayName":7,"vendor":8,"kind":9,"apiType":10,"url":11},"shopify-changelog","Shopify Admin API","shopify","graphql-sdl","graphql","https:\u002F\u002Fshopify.dev\u002Fadmin-graphql-direct-proxy\u002F2026-04",{"id":13,"contentHash":14,"fetchedAt":15},"01KX10F6XP8RMGBDGA2TDVZVY1","b90bf4de5c40f9735384ac327f902b301740ea5573db32d3646068f098d26d87","2026-07-08T14:00:21.829Z",{"id":17,"contentHash":18,"fetchedAt":19},"01KX52XYZVGWP8XF37YNQ8179W","e743c8ade4cc78dcbadb86ed75f61eea1129584710267488535c2210a5d06aa9","2026-07-10T04:00:20.178Z",null,{"alerts":22},[23,30,37,44,51,58,65,72,79,87,94,101,108,115,122,129,136,143,150,157,164,171,178,185,192,199,206,213,220,227],{"id":24,"severity":25,"title":26,"summary":27,"contentHash":18,"detectedAt":28,"slug":29},"01KX52Y36682N8NVZ2J7432P8J","Additive","Add IDEMPOTENCY_PREVIOUS_ATTEMPT_FAILED error code","The Shopify Admin API adds a new `IDEMPOTENCY_PREVIOUS_ATTEMPT_FAILED` error code across multiple mutation error enums. This is a new error value that clients may encounter when retrying requests with a previously-failed idempotency key, enabling better error handling and diagnostics without breaking existing code.","2026-07-10T04:00:25.286Z","2026-07-10-add-idempotency-previous-attempt-failed-error-code",{"id":31,"severity":32,"title":33,"summary":34,"contentHash":14,"detectedAt":35,"slug":36},"01KX10FB1DGKMWQJ3MCYWK3KT4","Informational","Documentation clarification on Buy X Get Y discount stacking","Added documentation notes clarifying that Buy X Get Y discounts stack only on customer-gets products (GY), not customer-buys products (BX), with a link to detailed limitations guidance. This is a documentation-only change that provides clarification to developers integrating discount features.","2026-07-08T14:00:26.925Z","2026-07-08-documentation-clarification-on-buy-x-get-y-discount-stacking",{"id":38,"severity":25,"title":39,"summary":40,"contentHash":41,"detectedAt":42,"slug":43},"01KWYAMT86BYEBQ6FSSCPSYGBV","Add new error codes to Shopify Admin API","Two new error codes have been added to the GraphQL schema: `GLOBAL_E_PRICING_STRATEGY_NOT_PERMITTED` (indicating Global-e pricing configurations can only be edited by Global-e) and `INVALID_STANDARD_METAOBJECT` (indicating an invalid standard metaobject definition template). These are purely additive changes to the error enumeration that expand available error responses without breaking existing integrations.","de5112ffa27c018a57838580404c7901d0db8c791fc5fb64e5c0805bd5af30d4","2026-07-07T13:00:28.806Z","2026-07-07-add-new-error-codes-to-shopify-admin-api",{"id":45,"severity":32,"title":46,"summary":47,"contentHash":48,"detectedAt":49,"slug":50},"01KWVMTK81882RM35JMCJZMCY3","Documentation example formatting fixes in filter descriptions","Documentation strings in MetafieldDefinition and Product search filter descriptions were updated to add proper quoting around ISO timestamp examples (e.g., `created_at:>'2020-10-21T23:39:20Z'` and `updated_at:>'2020-10-21T23:39:20Z'`). This is a documentation\u002Fexample correction that does not affect API behavior or schema.","508ce7898e37178c865f5c2fc8bd0c760beb61da0a38b8f5ec7536e3e6f2ae60","2026-07-06T12:00:40.705Z","2026-07-06-documentation-example-formatting-fixes-in-filter",{"id":52,"severity":32,"title":53,"summary":54,"contentHash":55,"detectedAt":56,"slug":57},"01KWGXFVNNHSD2EESQRGF9KG1H","Documentation rewording in search filter descriptions","The `return_status` filter description was updated from `\"retur...` (truncated) to a complete list of acceptable values, and URL references in several filter descriptions were adjusted (e.g., `fulfillment_status` field link changed from `https:\u002F\u002Fshopify.dev\u002Fdocs\u002F` to a consistent format). These are pure documentation clarifications that do not change the API's behavior or accepted input values.","23efc163713fd659a22ec7df09414c3b27bcc1132e24e90743fb8d010fccc27c","2026-07-02T08:00:27.317Z","2026-07-02-documentation-rewording-in-search-filter-descriptions",{"id":59,"severity":25,"title":60,"summary":61,"contentHash":62,"detectedAt":63,"slug":64},"01KWCV15VEQ4AW5HQD5V840JRA","Add product_id and product_variant_id filters to subscriptionContracts search","Two new filter options `product_id` and `product_variant_id` have been added to the `subscriptionContracts` search query's filter parameter. These are documented additions that enable filtering subscription contracts by product or product variant ID, without breaking existing integrations.","cd578f1dfa5da3738b62d4c02474b0d54204d099c475dbde590017a7a43b0a18","2026-06-30T18:00:31.342Z","2026-06-30-add-product-id-and-product-variant-id-filters-to",{"id":66,"severity":25,"title":67,"summary":68,"contentHash":69,"detectedAt":70,"slug":71},"01KW9M13DP1M1983HJ4GPXHNGG","Updated sourceName documentation and added new error codes","Updated documentation for the `sourceName` field in draft orders and order creation inputs to simplify instructions and reference the order attribution guide. Added two new error codes: `MANAGED_MARKETS_RESOURCE_NOT_ALLOWED` and `INCOMPATIBLE_WITH_STANDARD_POLICY`, plus deprecated the `savedSearches` and `segmentMigrations` fields in favor of alternatives. The documentation changes clarify how to set up order attribution without breaking existing field functionality, and the new error codes extend error handling without removing existing ones.","379b10f461be2f051d8a8b316f346e3d199f34b6cbe6ab137953f3444666014c","2026-06-29T12:00:25.526Z","2026-06-29-updated-sourcename-documentation-and-added-new-error-codes",{"id":73,"severity":32,"title":74,"summary":75,"contentHash":76,"detectedAt":77,"slug":78},"01KW2Z5H9WPSGQKH7V1DYFF63P","Enhanced documentation for cart and checkout validation mutations","The Shopify Admin API documentation for the `validationCreate`, `validationDelete`, and `validationUpdate` GraphQL mutations has been expanded with detailed descriptions clarifying their purpose, behavior, and use cases. These are pure documentation improvements with no changes to the actual API contract or behavior.","c9b73a58ce7cee054d497acd5ac41da2a5b9677c1e387bf4d2b30f55183d8a2c","2026-06-26T22:00:24.124Z","2026-06-26-enhanced-documentation-for-cart-and-checkout-validation",{"id":80,"severity":81,"title":82,"summary":83,"contentHash":84,"detectedAt":85,"slug":86},"01KW05X5QX5DK4DXSXYR2MYHSQ","Deprecation","Clarified deprecation message for priceRule field","The `priceRule` field in `DraftOrderDuplicateLineItemsPayload` now has a more detailed deprecation message indicating what to use instead (`discountCode` and `discountTitle`) and when it will be removed (2026-10). This is still a deprecation warning rather than a breaking change, but clients should begin migrating now.","53fab28c1f5a1f823181ba928f7f3d27b9d133e3013f7c8d14fbd7aee56e81ce","2026-06-25T20:00:26.877Z","2026-06-25-clarified-deprecation-message-for-pricerule-field",{"id":88,"severity":25,"title":89,"summary":90,"contentHash":91,"detectedAt":92,"slug":93},"01KVXG2QZQ11GYSZAWT9BTX8T0","Add new MetafieldType enum values to Admin API","Five new enum values added to the `MetafieldType` enum: `CUMULATIVE`, `GEO_COORDINATE`, `ENTITY`, `UNITLESS_SCALAR`, and `MULTIPLIER`. These are new optional metafield type options available for use in the Shopify Admin GraphQL API, with no breaking changes to existing integrations.","74ca624cf4a1dac06f87e4247fc11b658665554f178e2d91778cbcc6c2ed8fd4","2026-06-24T19:00:31.863Z","2026-06-24-add-new-metafieldtype-enum-values-to-admin-api",{"id":95,"severity":81,"title":96,"summary":97,"contentHash":98,"detectedAt":99,"slug":100},"01KVW6W38PY479V2VHW4H3Q3XS","Deprecate codeDiscountNode query field","The `codeDiscountNode` query field is now marked deprecated in favor of `discountNode`. This is a standard deprecation that allows clients time to migrate before the field is removed. Additionally, the `DepositInput` description was clarified from \"for a B2B buyer\" to \"requirement\" for broader applicability.","0c54b3e4f4a44ddae7725863f63a4429b2afd488402163c9a2f90070f24a0d76","2026-06-24T07:00:22.422Z","2026-06-24-deprecate-codediscountnode-query-field",{"id":102,"severity":25,"title":103,"summary":104,"contentHash":105,"detectedAt":106,"slug":107},"01KVTXNTA5R0Z2GP6SA99SA31S","Add INVALID_TAG error code and deprecate automaticDiscountNode","The diff adds a new `INVALID_TAG` error enum value to three error types in the Shopify GraphQL API to indicate when one or more tags are not valid. Additionally, the `automaticDiscountNode` query field is now marked as deprecated in favor of `discountNode`. These changes are additive: the new error code provides richer error reporting, and the deprecation preserves backward compatibility while guiding clients to the preferred field.","d397a9f8a0b954ef703c359cd1165f7e62b065e17d331368dfdfa4586e4bdaa9","2026-06-23T19:00:25.029Z","2026-06-23-add-invalid-tag-error-code-and-deprecate",{"id":109,"severity":25,"title":110,"summary":111,"contentHash":112,"detectedAt":113,"slug":114},"01KVR7VB33R8G6JXXA59NKBNDZ","Documentation updates and new error codes for customer merge","The diff adds comprehensive documentation to the customer merge APIs explaining the deterministic rules for selecting which customer is kept, adds two new error codes (`MAXIMUM_CART_TRANSFORMS` and `MAXIMUM_PAYMENT_CUSTOMIZATIONS`), and deprecates five marketing-related fields on `CustomerPhoneNumber` in favor of `smsMarketingConsent`. These are additive changes that clarify behavior and provide new optional fields; deprecated fields remain functional.","4865fee54fd8c1bcc3a165c7aa6d9fc6f8aab3af7424f5a758e587a2d5252150","2026-06-22T18:00:28.515Z","2026-06-22-documentation-updates-and-new-error-codes-for-customer-merge",{"id":116,"severity":81,"title":117,"summary":118,"contentHash":119,"detectedAt":120,"slug":121},"01KVCN1WCG8R0KC2MCBS9BN753","marketingActivityCreateExternal mutation deprecated","The `marketingActivityCreateExternal` mutation is now marked deprecated in favor of `marketingActivityUpsertExternal`. Existing integrations will continue to work but should migrate to the replacement mutation.","80456080fc326536a8bd4ce4627442cf8d5e3f57364346d05b5a7b3534d09879","2026-06-18T06:00:21.136Z","2026-06-18-marketingactivitycreateexternal-mutation-deprecated",{"id":123,"severity":81,"title":124,"summary":125,"contentHash":126,"detectedAt":127,"slug":128},"01KV9Z7C9BCFFRYTMYV73Q4YFS","Deprecate collectionAddProducts and collectionRemoveProducts mutations","The `collectionAddProducts` and `collectionRemoveProducts` mutations are now deprecated in favor of `collectionUpdate`. Documentation is being refactored to use \"collection\" terminology instead of distinguishing between \"manual\" and \"smart\" collection types, emphasizing that all collections can now include products manually and automatically through rules, sources, or conditions.","bac2fcc65d678d26e81a997fc4e570078c38e510ad44e76c358d54a14df6d2dc","2026-06-17T05:00:23.722Z","2026-06-17-deprecate-collectionaddproducts-and",{"id":130,"severity":25,"title":131,"summary":132,"contentHash":133,"detectedAt":134,"slug":135},"01KV7TJ3AQABRB8NQTTPBK9928","Add CUSTOM_APP_FUNCTION_NOT_ELIGIBLE error code","A new GraphQL error code `CUSTOM_APP_FUNCTION_NOT_ELIGIBLE` has been added to indicate when a Shopify Plus plan is required to activate functions from a custom app. This is an additive change that provides more granular error information without breaking existing integrations.","f519441c32821279d9015e3e1bb2f8b40b2fed64fe0937acfb1dc8b857745104","2026-06-16T09:00:23.255Z","2026-06-16-add-custom-app-function-not-eligible-error-code",{"id":137,"severity":81,"title":138,"summary":139,"contentHash":140,"detectedAt":141,"slug":142},"01KV6728QD0C0PQ3FMECN06M36","Deprecate Order.channelInformation field","The `channelInformation` field on the Order object is marked deprecated in favor of the `attribution` field. Existing integrations will continue to work, but clients should migrate to use `attribution` instead.","833124bd6093ffd81b7b6e22aa4048539772979dde1696a5b9caa86e6c9aa720","2026-06-15T18:00:27.117Z","2026-06-15-deprecate-order-channelinformation-field",{"id":144,"severity":25,"title":145,"summary":146,"contentHash":147,"detectedAt":148,"slug":149},"01KTY90ASDRMX55FB49BEB4058","Add CA_SK_VPT_RESELLER_EXEMPTION and CA_NL_VPT_RESELLER_EXEMPTION tax exemption types","Two new tax exemption enum values were added to support VPT (Vapour Products Tax) reseller exemptions in Saskatchewan and Newfoundland and Labrador. These are new enum cases that existing integrations can opt into using without any breaking changes.","b99ec93d924eee8cca3b8ea8c49585afd5c5f4862f87eb2faf028a81ba490109","2026-06-12T16:00:25.389Z","2026-06-12-add-ca-sk-vpt-reseller-exemption-and-ca-nl-vpt-reseller",{"id":151,"severity":25,"title":152,"summary":153,"contentHash":154,"detectedAt":155,"slug":156},"01KTC87NR6AK5K4PVXQ8RK5HJW","Add customer_id filter to subscriptionContracts search and MACHINE_TRANSLATION_BATCH_COMPLETED webhook","Added `customer_id` filter field to the `subscriptionContracts` search query documentation, enabling clients to filter subscription contracts by customer ID. Also added a new webhook topic `MACHINE_TRANSLATION_BATCH_COMPLETED` for machine translation batch completion events. Both are purely additive and do not affect existing integrations.","0aa247e61ce6395a667656afb87a6169a90f598c8677904e219c943172d4af79","2026-06-05T16:00:37.638Z","2026-06-05-add-customer-id-filter-to-subscriptioncontracts-search-and",{"id":158,"severity":25,"title":159,"summary":160,"contentHash":161,"detectedAt":162,"slug":163},"01KTB2EVTQR10HPY2FEWN03QS3","Add MARKET_UPDATE_CONCURRENT_MODIFICATION error code","A new error code **MARKET_UPDATE_CONCURRENT_MODIFICATION** has been added to the Market mutations error response. This indicates that another modification to a market is in progress. The addition is backwards compatible and only affects error handling paths.","d0dd21f84b3b77b95524a8a5ca0ceae65466b20652e8ed3e7bca6a16524b6def","2026-06-05T05:00:27.351Z","2026-06-05-add-market-update-concurrent-modification-error-code",{"id":165,"severity":32,"title":166,"summary":167,"contentHash":168,"detectedAt":169,"slug":170},"01KT700278TJG0ZNZ6FWC5KS9N","Enhanced documentation for resourcePublicationsV2 catalogType argument","Documentation for the `catalogType` argument in the `resourcePublicationsV2` field has been expanded across multiple object types to clarify default behavior and limitations. The changes explain that `APP` catalog types are returned by default, that `Product` and `ProductVariant` support other catalog types like `COMPANY_LOCATION` and `MARKET`, and that `Collection` only supports `APP` catalog types. No API behavior or schema has changed.","18d92f577a38c1d3e6af2c546bd985f332e011366f6bf66159b35501c88199e9","2026-06-03T15:00:27.496Z","2026-06-03-enhanced-documentation-for-resourcepublicationsv2",{"id":172,"severity":32,"title":173,"summary":174,"contentHash":175,"detectedAt":176,"slug":177},"01KSTRKQTF2ZG7A2D9F1FEJNTN","PriceRule field un-deprecated on DraftOrderApplyGiftCardWarning","The `priceRule` field on what appears to be a `DraftOrderApplyGiftCardWarning` (or similar warning type) has had its `@deprecated` directive **removed**, meaning it is no longer marked as deprecated. This is a reversal of a prior deprecation — existing clients using the field are unaffected, but tooling that warned on deprecated field usage will no longer flag it.","0420441cc3782584390710d866a48bff4b26e1326ed24d85a0fbb041aa14da69","2026-05-29T21:00:30.415Z","2026-05-29-pricerule-field-un-deprecated-on",{"id":179,"severity":81,"title":180,"summary":181,"contentHash":182,"detectedAt":183,"slug":184},"01KSSC05XF538YKZQJNFZ3RSCH","Deprecate priceRule field in PriceRulePreviewError","The `priceRule` field in the `PriceRulePreviewError` type is now marked as deprecated. Existing code using this field will continue to work, but clients should plan to migrate away from it.","e0fb979fc5caa4f31d68581b45e74bd1716b6750e214730165c6a1d88427a92f","2026-05-29T08:00:52.143Z","2026-05-29-deprecate-pricerule-field-in-pricerulepreviewerror",{"id":186,"severity":25,"title":187,"summary":188,"contentHash":189,"detectedAt":190,"slug":191},"01KSHR72NGB48936WRJ4ZDRKYD","Add OTHER enum value to CashManagementDefaultReasonCodeEnum","The `CashManagementDefaultReasonCodeEnum` enum gains a new `OTHER` variant; simultaneously, an existing `OTHER` variant in a related enum is deprecated in favor of this new location. Additionally, the `Market` type description is reworded for clarity but retains the same API semantics. The new enum value is purely additive for clients using `CashManagementDefaultReasonCodeEnum`.","e2d83aed1076ef0eaf3f4a05171786039cf901304c37ac8c752db832b057b184","2026-05-26T09:00:25.648Z","2026-05-26-add-other-enum-value-to-cashmanagementdefaultreasoncodeenum",{"id":193,"severity":32,"title":194,"summary":195,"contentHash":196,"detectedAt":197,"slug":198},"01KS27SZ33DRB8QNH54ZHC9978","Documentation clarifications for product discount tags","Updated documentation for product discount tag handling to clarify the distinction between a discount's own `tags` field and the `productDiscountsWithTagsOnSameCartLine` field which controls which other discounts it can combine with. The changes emphasize that modifying combination tags does not affect the discount's identity tags, and provide clearer examples and cross-references to relevant mutations.","44c9d43943dce8fd1464ce1fed6ba3cfb58dee2edcda982a47606f7cd8dda07b","2026-05-20T08:25:02.307Z","2026-05-20-documentation-clarifications-for-product-discount-tags",{"id":200,"severity":81,"title":201,"summary":202,"contentHash":203,"detectedAt":204,"slug":205},"01KRMZ87VSN36DHSY6N8DSF2YM","Deprecate isCumulative field on engagement metrics","The `isCumulative` field on engagement metrics objects is now marked as deprecated via `@deprecated` directive, with guidance to use non-cumulative metrics instead. The field remains functional but should no longer be used for new integrations. A new error code `TOO_MANY_DISCOUNTS` was also added to contract draft validation.","292410a70b0d965c20946ebb6be3ded4efd6f3827a24b9395208c68fac5b9fee","2026-05-15T04:45:25.241Z","2026-05-15-deprecate-iscumulative-field-on-engagement-metrics",{"id":207,"severity":32,"title":208,"summary":209,"contentHash":210,"detectedAt":211,"slug":212},"01KRH5C3BGAQCPQJBK240KQYQN","Update original_upload_size filter documentation type","The documentation for the `original_upload_size` filter in the File search query was updated to reflect its type as `float` instead of `string`. The detailed description of how the filter works (supporting byte units, ranges, and multipliers) was also removed. This is a documentation clarification that does not change the actual API behavior or how clients should interact with the filter.","57fce12d40fdad6e01d48464add9254d9e403ab1f74aacf6c136804ae3d6dede","2026-05-13T17:15:25.424Z","2026-05-13-update-original-upload-size-filter-documentation-type",{"id":214,"severity":32,"title":215,"summary":216,"contentHash":217,"detectedAt":218,"slug":219},"01KRH2SP635ZX5JJEWEQ3SDPHF","Enhanced original_upload_size filter documentation","The `original_upload_size` filter documentation in the File search query has been expanded from a simple `float` type to include detailed filter capabilities, examples, and unit support (B, KB, MB, GB, TB). This clarifies existing API behavior without changing the actual implementation—the filter was already functional, just now better documented.","d7c2ab49aba655eb64b5753d9c83ce03c7dccf6c3083584e40dbf45b3e28cf7c","2026-05-13T16:30:24.963Z","2026-05-13-enhanced-original-upload-size-filter-documentation",{"id":221,"severity":32,"title":222,"summary":223,"contentHash":224,"detectedAt":225,"slug":226},"01KREEP1MDQ09C6GF2SQWK22AS","New changelog entries added to developer changelog","Two new changelog entries were added to the Shopify developer changelog page: one on barcode support for inventory shipments API and another on new rejection reason codes in the Payments Apps API. These are content updates to the changelog documentation and do not alter any API behaviour.","faab95fa781f2023ffb45eb3de52d3b8692628797bd7e4eb538020057252b768","2026-05-12T16:00:25.229Z","2026-05-12-01kreep1mdq09c6gf2sqwk22as",{"id":228,"severity":32,"title":229,"summary":230,"contentHash":231,"detectedAt":232,"slug":233},"01KRE8NQ8TXJHRQMRWAWMAPYC8","Changelog entry reordering and additions","The changelog page was reorganized to reorder entries and add a new changelog post about `LineItem.priceAfterAllDiscountsBeforeTaxesSet` field availability in the GraphQL Admin API. No changes to actual API functionality or documented behavior occurred — this is a webpage restructuring update.","2c14c0c699fb6e0a5ed98e23c5d789da81ce972df9a7949daff12d289d61e265","2026-05-12T14:15:23.162Z","2026-05-12-01kre8nq8txjhrqmrwawmapyc8"]