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
Minimum requirement is now optional on automatic discounts API
Previously merchants were required to specify minimum purchase conditions on product, order, and free shipping automatic discounts. We're now making these conditions optional, so the minimumRequirement
field in our APIs is now able to return a null
value.
As of version 2025-01, the minimumRequirement
field for both DiscountAutomaticBasic and DiscountAutomaticFreeShipping will become nullable.
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
Action required
Public apps must use new GraphQL Product APIs to be accepted in the Shopify App Store Shopify App Store
Starting January 1, 2025, all new apps submitted to the Shopify App Store must use the new GraphQL Product APIs. After this date, apps that query deprecated REST API product resources won’t be approved.
As of February 1, 2025, all public apps must migrate to the new GraphQL Product APIs. This includes apps already listed in the Shopify App Store.
Public apps are always required to use currently supported APIs. To learn more about the specific changes to Shopify’s product APIs, and how to update your app, check out our migration guide.
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.
January 01, 2025
Support Delayed
Fulfillment Status in GraphQL API
API
As of Admin API 2025-01, we have officially introduced a new fulfillment event status called delayed
.
January 01, 2025
ReverseFulfillmentOrder.order field is nullable as of 2025-01 API
As of 2025-01, ReverseFulfillmentOrder.order
field is nullable. An Order
can be nullable if the client does not have access to the read_all_orders
scope and the order is older than 60 days or no longer exists. For versions that predate 2025-01, the order field will return a graphql error when the order is not available.
Learn more about ReverseFulfillmentOrder
on Shopify.dev.
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.