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.
Filter by tag:
Get prepared for future changes to Shopify’s APIs and other developer products.
There are no entries for your filter criteria.
April 01, 2023
Server Pixels Limited Release API
As of 2023-04, select partners can use Server Pixels to consume customer events on the server-side. These new mutations are available to those partners:
April 01, 2023
Action required
Removal of deprecated status
field in Payments Apps API 2023-04 release
API
As of 2023-04
GraphQL Payments Apps API version, we are removing the status
field as it was deprecated since 2022-04
version in favour of the state
field of the following objects returned by our GraphQL mutations:
To get up to date, make sure you no longer query the status
field on these objects and use state
instead.
Learn more about payments apps on Shopify.dev.
April 01, 2023
Release of the subscriptionContractAtomicCreate and subscriptionContractProductUpdate mutations API
As of the 2023-04 release of the GraphQL Admin API, you can create a subscription contract in a single operation with the subscriptionContractAtomicCreate
mutation.
You can also replace a retired product by a new one, or update the price of a product in a subscription contract in one GraphQL call to the subscriptonContractProductUpdate
mutation.
More information on Bulk Operations can be found here
April 01, 2023
Generate targeted product recommendations with the new ProductRecommendationIntent
type
API
As of the 2023-04 API version of the Storefront API, the ProductRecommendations query will accept an optional intent
argument. Additionally, a new ProductRecommendationIntent
will be introduced as a GraphQL Enum Type, defining the supported product recommendation intents. By default, the API will return RELATED
recommendations for backward compatibility.
April 01, 2023
New selected_delivery_option
error codes in cart
API
We've added the error codes INVALID_DELIVERY_GROUP
and INVALID_DELIVERY_OPTION
for cartSelectedDeliveryOptionsUpdate
mutation , allowing you to get descriptive error codes when GraphQL returns invalid delivery group id or invalid delivery options input.
April 01, 2023
Introduce onsite credit card support for payments apps API
As of version 2023-04
, payments apps will have support for onsite credit card payments through new types introduced to the GraphQL Payments Apps API.
Changes to support on-site credit card processing are as follows:
-
New rejection codes are now available in the
paymentSessionReject
GraphQL mutation for credit card payments apps -
A new error code is introduced in the
paymentSessionPending
GraphQL mutation
April 01, 2023
Introducing the new Customer Merge API API
As of GraphQL Admin API version 2023-04, you can now use the Customer Merge API to combine two separate customer profiles with certain non-blocking criteria. You can use the new mutations and queries to:
Additionally, you can check whether a customer can be merged with another customer using the new Customer.mergeable field. This field is also available on the CustomerSegmentMember API CustomerSegmentMember. mergeable.
You can learn more about merging customer profiles on Shopify Help Center.
April 01, 2023
Filter orders by return status API
You can now filter orders by their return status.
The return_status
filter is available on the orders connection. This status corresponds to the return status merchants see in the orders page.
Learn more about the order's return status on Shopify.dev.
Learn more about return statuses on the help center.
April 01, 2023
Action required
ChangingCartLine
from an Object
to an Interface
API
As part of the GraphQL Storefront API 2023-04 API release, we are creating BaseCartLine
as an interface to CartLine
and we are updating CartLineConnection
to BaseCartLineConnection
.
Learn more about the Cart
object on Shopify.dev.
April 01, 2023
Action required
Deprecating PublishedTranslation
GraphQL type
API
As of 2023-04
, we are deprecating the PublishedTranslation
graphQL type in the admin API. Use the Translation
graphQL type instead.
The Translation
graphQL type contains more fields; outdated
, updatedAt
and market
.
To get up to date, make sure you no longer query the marketId
field on these objects and query using the market
field instead.
Learn more about Translation
on Shopify.dev.
April 01, 2023
productVariantsBulkUpdate mutation returns data along with errors API
In the Admin GraphQL API version 2023-04, the productVariantsBulkUpdate
mutation will return product
and productVariants
data even when errors are present. Previously, the mutation would always return null
for the product
and productVariants
data.
Learn more about the mutation here.