Developer changelog
Subscribe to the changelog to stay up to date on recent changes to Shopify’s APIs and other developer products, as well as preview upcoming features and beta releases.
RSS updatesThere are no entries for your filter criteria.
January 01, 2025
Introduce concatenatedOriginContract to subscriptionLine API
As of 2025-01, we've introduced concatenatedOriginContract
to subscriptionLine
.
You can now query the origin contract of the lines if you have used the Subscription Billing Cycle APIs to combine multiple contracts. This can be accessed through subscriptionBillingCycle.editedContract.lines.concatenatedOriginContract
.
Learn more about combining contract on Shopify.dev.
January 01, 2025
Update to percentage_adjustment
field on SellingPlanPercentagePriceAdjustment
API
In the Storefront API version 2025-01, there is an update to the adjustmentPercentage field on the SellingPlanPercentagePriceAdjustment
object. This field, which facilitates the percentage price adjustment for a selling plan's pricing policy, will transition from an Int
data type to a Float
.
January 01, 2025
Add override_respect_inventory_policy
option to subscriptionBillingAttemptCreate
mutation
API
As of API version 2025-01, you can use the override_respect_inventory_policy
flag on the subscriptionBillingAttemptCreate
mutation to force billing attempts to get created regardless of the inventory policy on a shop.
January 01, 2025
Admin access input is now optional when setting metafield definition access API
When creating or updating a metafield definition's access
the admin
field is now optional. When admin
is not explicitly set, it will default the same way it is when the entire access
field is omitted.
Learn more about metafield access controls on Shopify.dev
January 01, 2025
Action required
New validation against duplicate handles in productCreate, productUpdate, and productSet mutation inputs API
As of the 2025-01
version of the Admin GraphQL API, the handle
field in productInput for productCreate and productUpdate, as well as in productSetInput for productSet will be validated for uniqueness. This means that you will no longer be able to input a duplicate handle. This change does not affect existing behaviour when handle
is not provided as input.
This enhancement ensures that there are no collisions when creating or updating product handles.
October 28, 2024
Action required
Breaking Changes to CAPTCHA protection on Storefront forms Platform
From the week commencing 28th October 2024, the following changes to CAPTCHA protection will occur:
Classic Customer Accounts: Removal of the /challenge
page for Login, Create Account and Reset Password flows
If hCaptcha is enabled in Admin for these forms, they will now require a valid hCaptcha token as part of the form submission, otherwise a 400 error response will be returned.
Form submissions that fail the hCaptcha assessment will also return a 400 error response.
The vast majority of form submissions already comply with this requirement, due to hCaptcha being automatically wired up to forms with the correct markup. More information is available in the dev docs
Full deprecation of reCAPTCHA on Storefront forms
The recent migration to hCaptcha on all Storefront forms is now complete. Applications or themes that have bespoke code that submits a reCAPTCHA v3 token (site key 6LeHG2ApAAAAAO4rPaDW-qVpPKPOBfjbCpzJB9ey
) will need to update to use hCaptcha. All form submissions containing a recaptcha-v3-token
field will result in a 400 error response.
Again, the vast majority of form submissions already comply with this requirement. If you application or theme invokes the reCAPTCHA api directly, ie via methods on window.grecaptcha
then you will need to make changes. More information on wiring forms with hCaptcha using methods supported by Shopify is available in the dev docs
October 22, 2024
Storefront API Cart now supports removing Gift Cards API
As of version 2025-01 of the GraphQL Storefront API, Cart now support removing Gift Cards.
After a cart has been created and a Gift Card applied - perform the cartGiftCardCodesRemove
mutation to remove one or more gift cards.