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.
Tags:
- Tools
CI/CD support for scripts, extensionsRead full post –>Developers can now programmatically push their scripts and extensions to Shopify from their CI/CD pipelines with CLI authentication tokens.
For more information on how to set up CI/CD for your...
Tags:
- Themes
New theme editor setting types: product list and collection listRead full post –>Two new input setting types have been added to the theme editor:
and. They allow merchants to quickly create curated, ordered and paginatable lists of products and...Tags:
- API
- 2022-04
Changes to metafield definition error codesRead full post –>As of GraphQL Admin API version 2022-04, an error returns when a metafield definition is created with invalid characters in either the
keyor thenamespacefields. Thekeyandnamespace...Tags:
- API
- 2022-04
New fields on App and AccessScopeRead full post –>As of GraphQL Admin API version 2022-04, new fields on the App resource are available. These include
,,,,...Tags:
- Shopify App Store
App store listings now have additional Partner detailsRead full post –>App listing pages now show Partner details: total apps, average app rating, and Shopify development duration, aiding merchants in decision-making.
Tags:
- API
Theme app extensions now support locales directoryRead full post –>As of today, apps will be able to store translation strings in a centralized locales folder accessible across all app blocks and app embeds within a theme app extension.
For more information...
Tags:
- API
Scheduled Publishing to Channels is now Generally AvailableRead full post –>Product Scheduled Publishing lets merchants set a specific datetime for product launches. Channels with validation must integrate to validate products before their scheduled release.
Tags:
- Themes
Display duties with Liquid usingorder.total_dutiesRead full post –>A new attribute (
) is now available on theorderobject.attribute returns the sum of all duties applied to line items in the order....Tags:
- API
Changes to Theme Translatable Content KeysRead full post –>New themes now generate translatable content keys in a new format for JSON templates. Existing translations and themes before Feb 17 remain unaffected.
Tags:
- Platform
Shopify Markets is now Generally AvailableRead full post –>Shopify Markets lets merchants sell globally from one store. Apps/themes must use routes for locale URLs and country object for switchers. Now available for all merchants and dev stores.
Tags:
- API
Cart change REST API now supports changing selling planRead full post –>It’s now possible to upsell subscriptions in cart in the online store. We added a new field,
, to the ...Tags:
- API
- 2021-10
Subscriptions APIs now support Apple PayRead full post –>Apple Pay payments are now accepted for recurring transactions. We added source and virtualLastDigits to the...
Tags:
- Action Required
- API
- 2022-04
Segmentation API available in 2022-04 releaseRead full post –>Shopify's 2022-04 API introduces a Segmentation API, replacing saved searches for targeting customer groups. Apps must migrate to support segments for marketing and analytics.
Tags:
- Tools
Name change for Shopify’s GitHub appRead full post –>The Shopify GitHub app is renamed from Shopify Online Store to Shopify, with no functionality changes, supporting custom storefronts and theme code management.
Tags:
- Action Required
- API
- 2022-04
Changes to Storefront API Object IDsRead full post –>Storefront API now returns non-Base64 encoded object IDs in
unstable,2022-04, and future versions, impacting how developers handle IDs in their apps.Tags:
- API
- 2022-04
Updated Admin GraphQL/Storefront ExternalVideo URL fieldsRead full post –>The 2022-04 API update deprecates
forand addsfor iframe embedding intype, impacting Admin and Storefront APIs.Tags:
- Platform
Introducing a new custom app developer experienceRead full post –>Shopify now offers a streamlined process for creating custom apps with enhanced security, replacing private apps. Existing private apps remain usable and modifiable.
Tags:
- API
Channel Attribution is now available in betaRead full post –>Channel Attribution beta improves order source accuracy via new fields in Orders, Checkout, and Draft Orders APIs. Ensure API version is unstable and include Content-Type in headers.
Tags:
- Action Required
- API
Updates to Facebook and Instagram Order and Fulfillment WorkflowsRead full post –>Update your app's order and fulfillment workflows to support Shopify Payments for Facebook and Instagram checkouts, ensuring smooth order processing and minimizing automation issues.
Tags:
- Platform
Stripe as additional payment gateway for subscriptionsRead full post –>Merchants can use the Subscription API if they have Stripe on their Shopify checkout or have permission to do so.
For more information, refer to...
Tags:
- Shopify App Store
New Regulatory operating fee field in the Partner payout and app earnings CSVRead full post –>On Jan 5, 2022, a new 'Regulatory operating fee' field will be added to payout CSVs, aiding developers in understanding fee deductions based on merchant location.
Tags:
- Action Required
- Platform
Updates to our API License and Terms & Partner Program AgreementRead full post –>Updated API License and Partner Program terms now affect Shopify developers' platform interactions and offerings. Review changes effective January 5, 2022, to align your app development.
Tags:
- API
- 2022-01
Authorization errors in mutations are refinedRead full post –>API calls made to the Admin and Storefront API are denied access if the API client does not have the required access scopes or the user does not have...
Tags:
- API
- 2022-01
Introducing standardized and custom product types to GraphQL Admin APIRead full post –>Added standardizedProductType and customProductType fields to Product object. Standardized links to Shopify Taxonomy; custom offers more granularity. Enhances product categorization.
Tags:
- API
- 2022-01
New error codes for bulkOperationRunMutationRead full post –>Starting in version
2022-01, theBULK_MUTATION_USER_ERROR_CODEerror code for themutation has been replaced by more granular error codes.For the list of new...
Tags:
- API
- 2022-01
New barcode field on the Storefront API ProductVariant objectRead full post –>As of GraphQL Storefront API version 2022-01, the
object has a new field:barcode. This field returns the barcode value (ISBN, UPC, GTIN, etc.) associated with the variant....
Tags:
- API
- 2022-01
New subscriptionPolicy field on Shop objectRead full post –>As of GraphQL Storefront API version 2022-01, the
Shopobject has a new field:. This field returns the subscription policy associated with the shop.Learn more about the...
Tags:
- API
- 2022-01
New mutation OrderInvoiceSendRead full post –>As of GraphQL Admin API version 2022-01, we are releasing a new mutation
. This mutation will take anOrderID and anand send the order invoice to the email. It...Tags:
- API
- 2022-01
Metafield Definitions available on Order, Collection, and CustomerRead full post –>API v2022-01 adds
query support forOrder,Collection, andCustomer, expanding fromProductand, enhancing customization options.Tags:
- API
New field on the SuggestedOrderTransaction objectRead full post –>The GraphQL API now includes
in, indicatingCARD_NOT_PRESENT_REFUNDorCARD_PRESENT_REFUND, affecting refund processing logic.Tags:
- API
- 2022-01
New sellable online quantity field on ProductVariant objectRead full post –>As of GraphQL Admin API version 2022-01, the
object has a new field:. This field returns the total sellable quantity of the product variant for online...Tags:
- Action Required
- API
- 2021-10
Property deprecations in the REST Admin API Order resourceRead full post –>The
customerobject properties in the Order resource are deprecated; use the Customer resource instead. Removal fromunstablein early 2022, official in2022-04API version.Tags:
- API
- 2022-01
New endpoint: translatableResourcesByIdsRead full post –>This new endpoint takes an array of specific resource GIDs, and returns a list of TranslatableResources associated...
Tags:
- Platform
Developer preview: Shopify MarketsRead full post –>Shopify Markets is a cross-border management tool that helps merchants identify, set up, launch, optimize and manage their international markets - all from a single store. You can now enable a...
Tags:
- API
Subscription support on dynamic and accelerated checkout methods for PayPal ExpressRead full post –>We've added subscription support for dynamic and accelerated checkout methods for PayPal Express on some stores.
Learn more about subscriptions in the...
Tags:
- Action Required
- API
- 2022-04
Cleaning up deprecations in the Storefront APIRead full post –>Deprecated fields and image arguments removed from Storefront API
unstableand2022-04versions, impacting data retrieval and image handling for developers.Tags:
- API
- 2021-10
Locale fields are now appended with language and country codesRead full post –>Locale fields now support language and region codes in
andCustomer.localefor more granularity, e.g.,fr-Frfor French customers in France.Tags:
- API
- 2021-10
Adding the manually_revoked value to theCustomerPaymentMethodRevocationReason enumRead full post –>As of GraphQL API version 2021-10, running the
mutation can now set thefield to.For more information,...
Tags:
- Themes
JSON templates now have limit of 1000 per themeRead full post –>The limit for JSON templates is increased from 50 per template to 1000 per theme. After this limit is reached, you can't create more JSON templates on the theme.
Learn more about [JSON...
Tags:
- API
- 2022-01
Contract notes for subscriptionsRead full post –>We’ve added support for contract notes to the 2022-01 API version. Contract notes are carried over from order notes on the initial order, if present.
For more information, refer to the [release...
Tags:
- API
- 2021-10
Adding new enum value for handling processing errors for Model3d objectsRead full post –>MediaErrorCodes and FileErrorCodes will now include a...
Tags:
- API
Adding mediaWarnings and 3D model bounding box informationRead full post –>Media objects in the Admin API now includes mediaWarnings which returns information about a media item that might require attention such as when a 3D Model is incorrectly scaled. Data about the...
Tags:
- Action Required
- API
Updating apps capturing transactionsRead full post –>Include
authorizationorin transactions to prevent errors with order editing apps. Support multiple authorizations for successful payment captures.Tags:
- API
Changes to Cart default bundled section rendering (Ajax API)Read full post –>Cart API now renders sections using the current page context via the Referer header if
isn't set, instead of defaulting to/cart. Existing behavior remains unchanged.Tags:
- API
Vulnerable password validation on the Storefront API's Customer objectRead full post –>Validation to identify vulnerable passwords has been added to the Storefront API's customerReset and...
Tags:
- Themes
Make images responsive with the new image_tag filterRead full post –>The new
filter simplifies adding responsive images, supports custom HTML attributes, and preloading, enhancing theme performance and flexibility for developers.Tags:
- API
New: Marketplace KitRead full post –>Released Marketplace Kit with APIs, components, and code snippets to integrate commerce features, connect Shopify merchants, and enable customer actions like viewing, adding to cart, and checkout.
Tags:
- API
Specify private metafields for webhooks using GraphQL Admin APIRead full post –>The
GraphQL object now has afield. You can use this field to specify private metafields that you want to be included in the payload for events...Tags:
- Tools
Updated permissions on the Shopify Online Store app for GitHubRead full post –>Shopify's GitHub app now syncs theme changes for faster development, requiring new permissions for custom storefronts. Existing store functions remain unaffected without these permissions.
Tags:
- API
Expose selected fields on AbandonedCheckout GraphQL API to publicRead full post –>We have changed part of the
GraphQL API visibility to public. Third-party apps only have access to theobject and a selection of its fields if the...