Developer changelog

We've released a new reporting column for App store ads - relevance. The relevance column provides advertisers with a more explicit signal for how relevant their app is for any given search term or keyword.

To learn more about creating ads in the Shopify App Store, refer to our documentation.

On October 14th, we’re introducing a new ‘Charge_ID’ field in the Partner Payout CSV, so app developers can link app charges with a particular payout item. This new field will help app developers reconcile app charges with their payouts.

Note that the new Charge_ID field is only available for data generated in new Partner Payouts CSV file downloads.

For more information on the Partner Payout CSV, visit the Shopify Help Center.

We’re excited to introduce APIs and tooling that will enable you to build support for subscriptions into the cart and product pages on the storefront.

You can use the Subscription APIs and Product Subscription Extension to develop flexible apps that support new selling methods for merchants, and are compatible with all of Shopify’s platform features (including discounts, shipping, reporting, and payments).

Start developing new subscription apps today! Request access to the new APIs using our early access sign up form.

To learn more about building with the new Subscription APIs and tooling, refer to our developer documentation.

To learn how we’re making Shopify checkout more extensible for you, check out our Web Design and Development blog.

As of 2020-10, legal settings can now be modified using the new Legal Policies API. Legal policy apps will be able to update the text content of policies by specified policy type (e.g. refund policy or privacy policy).

Learn more about the all new Legal Policy API in our developer docs.

In the 2020-10 version release, the status field was added to the product resource in both the REST Admin API and GraphQL Admin API. Merchants can use the field to identify, filter, and manage products based on their current status: draft, active, or archived.

Merchants can save new products as a draft and work on them iteratively until they’re complete and ready to be made available to selected sales channels with an active status. Merchants can also archive products they’re no longer selling to keep their product list organized, free of clutter, while retaining all product information.

To learn more about product status changes, refer to our product status API guide and 2020-10 release notes.

The following fields were previously deprecated, and have now been fully removed as of 2020-10.

• Refund.restocked
• RefundLineItem.refundType

These fields were deprecated by RefundLineItem.restockType.

For more information, see the RefundLineItem object in our documentation.

As of the 2020-10 API version, you can query a shop's shipping policy using the shippingPolicy field on the Shop object.

To learn more about the shippingPolicy field, refer to our developer reference documentation.

We've updated bid suggestions to give advertisers a more accurate view into what bid is required for their app to be competitive for any given keyword. Bid suggestions take into account your current relevance score when surfacing a suggested bid range.

• For exact match keywords, the likelihood that your ad will show up on the first page of search results increases.
• For broad match keywords, the competitiveness against other advertisers who bid on that keyword is measured.

To learn more about creating ads in the Shopify App Store, refer to our documentation.

Due to low usage, as of September 30th we no longer support AdRoll on Shopify App Store listings. For remarketing, we offer alternatives such as Google and Facebook Pixel support.

Learn more about setting up app listing tracking and retargeting from the Shopify Developer documentation.

The customer privacy API is a browser-based, Javascript API that enables developers to read and write cookies related to a buyer's privacy preferences. As of 2020-10, the API is available to all Shopify online stores as a property on the global window.Shopify object.

For more information on the new Customer Privacy API, visit our developer documentation.

We've made improvements to the rich text editor for Blogs posts, Pages, Products and Collections. You can now manually add RGB/HEX codes into the rich text editor with the new color picker, making it easier to precisely match text and background color to your brand and style.

Learn more about using the rich text editor from the Shopify Help Center.

As of 2020-10, apps can now add manual or percentage-based discounts to any item that is added while editing an order with the GraphQL Admin API.

For more information about using discounts with order edits, including the specific mutations to add discounts, visit the tutorial on editing an existing order with the Admin API.

The theme editor has been rebuilt in React and includes an updated mobile theme editing experience and many UI enhancements. The rebuild also decreases load times for large themes, making it easier and faster for merchants to set up and customize their online store, while also laying a new foundation for future improvements to the theme editing experience.

Update 9/25/2020: If you provide an app that detects usage in the Theme Editor, then please ensure that you’re using the official JavaScript API, Shopify.designMode, to detect the Theme Editor. Other implementations involving detection of the URL could cause broken experiences for merchants. For more information please review the community forum or the partner discussion area.

To learn more about the new theme editor, please visit the Shopify Help Center.

As of the 2020-10 API version, apps can add an array of media objects to product variants. Currently the array is limited to only one media object of type image.

For more information on how to work with product variants and media using the GraphQL API, refer to our variant media tutorial.

Additionally, we've added a new mime type field to the MediaImage object in the GraphQL API.

As of the 2020-10 REST API, checksums will be provided on assets that were recently updated.

If you use a client that supports checksums (ie Theme Kit 1.1 or newer), then the time it will take to sync your local files and the bandwidth used will be drastically reduced.

For more information, please see the checksum field in the REST API.

Please also see the blog post: How We Improved Theme Development Tooling Using Checksums

Beginning today, partners who want to test orders in development stores can only process payments using the following methods: * Shopify's test payment provider (Bogus Gateway). * A payment provider set to test mode.

If you want to test your development store using real transactions, then you can select and purchase a Shopify plan in the account settings of your development store.

This change was applied to all newly created development stores on March 30, 2020, as mentioned in our changelog update here. Beginning September 14, 2020, this change will be applicable across all development stores.

Learn more about test orders in the Shopify Help Center.

You can now subscribe to Shopify Payments dispute events with webhooks. The disputes/create and disputes/update topics are now available in all supported API versions.

For more information, visit the webhooks topic documentation.

Version 2020-10 of the GraphQL API will now allow you to directly query an order that is associated with a given refund.

For more information about the Refund object, visit our developer documentation

Earlier in the year we released the ability to refund duties using the GraphQL API. Now, as of version 2020-10, we are releasing the same functionality on the REST API.

For more information, please see the refund_duties property in the REST API.

Apps can now get additional context about batch discount code creation errors by looking into the new logs field. This field will return any error the system reported when trying to create the discount codes based on the price rule definition.

To learn more about this new field, visit the reference documentation.

Apps can now create BXGY discounts with a minimum purchase amount prerequisite via the REST Admin API.

A new prerequisite_to_entitlement_purchase field was added that defines the minimum purchase amount required to qualify for the discount.

For more information, visit the Price Rules API reference.

You can now access the online store speed report data from the Stores page in the partner dashboard, so you can quickly identify which clients might need your help making their online store faster. You can view store performance data for all of your managed stores and sort stores by speed score.

Learn more about the online store speed report in the Shopify Help Center.

Available today through the Partner Dashboard, the POS product recommendations app extension allows app developers who build product recommendations, and cross-sell and up-sell apps, to extend their app functionality to Shopify POS.

Product recommendations are a valuable feature for merchants with both online and physical store locations, who are looking to surface just-in-time product recommendations that are consistent across all storefronts, and make it easier for store staff to make more data-driven and informed purchase recommendations to buyers. This app extension allows app developers to provide this surface, while in turn making their app available to a whole new customer base.

To learn more about the POS product recommendations app extension, please visit the Shopify Help Centre.

As of API version 2020-10, we are removing the ability to change any tax field data usgin the countries and provinces resources.

Please see the community forum post for more information.

You can now subscribe to events related to delivery profiles with webhooks.

In the past, changes to a shop’s shipping zones triggered the shop/update webhook, but didn’t include any information about the new zone configuration. To stay current, apps would then have to send a follow up request to the shipping_zones endpoint and compare the results with their local copies of the data.

With the release of delivery profiles, we wanted to provide a proper webhook topic for apps that would allow them to avoid these frequent callbacks. As of today, you can now subscribe to the profile_create, profile_update, and profile_delete webhooks.

For more information, see the webhooks topic documentation, our updated delivery profiles guide, and the 2020-10 release notes.

As of the 2020-10 version, we have added information to fulfillment orders that allow API clients to understand the delivery method of any fulfillment order.

A fulfillment order delivery method can help you figure out how the line items represented by the fulfillment order should be delivered, or if they need to be picked up in-store.

Learn more about Fulfillment Orders and their associated delivery methods in our documentation.

Starting in the next few weeks, private app permissions will be set to Off by default in all non-Plus stores. This ensures that merchants opt in to all private apps and understand the permissions they’re giving to developers. All current private apps will continue to function, but cannot be modified until merchants re-enable private apps in the Shopify admin.

If you are looking for an alternative to private apps when building bespoke apps for merchants, consider using custom apps.

To learn more about private app permissions, please visit the Shopify Help Center.

Previously apps could only edit orders created through a Shopify channel (for example, POS, online store, or draft orders). Going forward, apps can now edit orders they created. To determine if your app can edit an order on Shopify, you can query the merchantEditable field on the Order object. If the return value of this field is true, your app can edit the order.

A new feature has been added to make it easier to manage and optimize your ads on the Shopify App Store - Recommended Keywords.

Recommended keywords - Keyword recommendations are now provided when partners add keywords. These recommendations are generated based on organic search performance, app category and other factors.

Learn more about Shopify App Store Ads in the Help Centre

On August 4, 2020, we resumed the activity requirement to continue receiving recurring commission payments for referrals and Plus upgrades. If you are a Partner that receives recurring commission payments for referrals or Plus upgrades, please check the Referrals page in your Partner Dashboard to understand how much time you have until you need to complete another activity. The activity requirement does not apply to ongoing earnings from app sales, theme sales, or any Partner activity other than referrals and Plus upgrades.

Shopify will now limit the amount of checkouts that can be created on the Storefront per minute. If an API client exceeds this throttle, then a 200 Throttled error response is returned.

For more information, see API rate limits.

Our new App Bridge authentication beta introduces session tokens to empower developers to create faster apps that are compatible with all modern browsers. Session token-based authentication does not depend on cookies, but instead relies on a Shopify-generated token that your app needs to send with every request.

To learn how you can participate in the beta and get started with App Bridge authentication and session tokens, refer to our developer documentation.

We've added a new report to the Shopify admin that will help merchants and Partners gauge and measure online store speed.

The new Online store speed report runs speed tests for merchants' home page and highest-traffic collection and product pages, and then combines each page’s Google Lighthouse speed score into an overall score. It also provides a comparison of how a merchants store’s speed compares to similar online stores.

The Online store speed report will roll out to all merchants over the coming weeks. You can learn about how the speed score and ranking are calculated and how you can help merchants improve their speed in the Shopify Help Center.

Google’s reCAPTCHA v3 has been added to online store contact forms and blog comments to reduce incoming spam. reCAPTCHA v3 analyzes visitor behavior to block spam from bots, and reduces friction for real users by eliminating CAPTCHA challenges. This feature is enabled by on all stores by default, but can be disabled in the online store preferences.

Learn more about reCAPTCHA v3 and how it interacts with themes on Shopify.dev.

To support more business models on the Shopify App Store, we’re introducing annual subscriptions through the Billing API. Merchants can choose a yearly subscription for your app, and you can track annual revenue from the Partner Dashboard.

We’ve also made it simple for merchants to upgrade an existing app subscription from a monthly to a yearly plan. Price differences will be prorated when merchants change plan intervals.

Learn more about enabling annual subscriptions for apps on Shopify Developers.

With the release of the 2020-07 version of the Admin GraphQL API, you can now access additional data on domains associated with a given shop using the new shop.domains field and webhook events.

Along with this new field you will be able to use the Domain object to determine if a shop has SSL enabled and surface cross border domain data including the country, default and alternate locales for each given domain.

The 2020-07 release adds Amazon EventBridge support, enabling you to receive Shopify webhooks using an event bus. Version 2020-07 also adds annual billing support to the Shopify Billing API, Tax ID support for Brazilian merchants using localization extensions, and additional data on domains associated with a given shop.

This release also improves access errors in GraphQL by adding an error code and a message that includes the name of the restricted resource.

Explore all the API changes included in this release in the 2020-07 release notes.

You can also read more about API versioning in the versioning guide and on the partner blog.

You can now add a Facebook pixel to your app listing. A Facebook pixel can help you to track your app listing traffic and increase your reach through Facebook. Learn more about tracking.

You can now use the page_image global object to output a store's social sharing image preview. This is the image that is displayed when Shopify store URLs are shared on social channels.

Learn more about the global page_image object in our developer documentation.

The currency API rate_updated_at field now returns the date the manual currency exchange rate was updated, if applicable. If no manual rate was set, the date the automatic rate was updated is returned. This change was made to support the new manual exchange rates feature.

Previously, the currency API returned the date the automatic rate was last updated in this field.

Learn more about the currency API Learn more about manual exchange rates Learn more about automatic exchange rates

The Shopify App Store is now available in Czech, Polish, Portuguese (Portugal), and Turkish. You can now create a listing in these languages that will be shown to merchants. Learn more about translated listings.

The Shopify Partner Program Agreement (PPA) updates previously announced on March 3, 2020, go into effect today.

These updates clarify our role as a billing agent, which means we’re the party responsible for facilitating payment transactions between partners and merchants of apps, themes, and services. Product changes that reflect these billing and tax updates will be live in the coming weeks.

A customer's multipass identifier is now available in the GraphQL Admin API 2020-07 release candidate using Customer.multipassIdentifer.

See the 2020-07 release candidate reference docs for details.

You can now use the Shopify theme inspector for Chrome to debug Liquid render performance on shops you have collaborator account access to.

If you'd like to learn more, contribute a feature, open an issue, or make a feature request, then check out the Shopify theme inspector Github repository.

The Localization Extensions developer preview is currently available. Localization extensions allow partners and app developers to access the tax id that is collected during checkout and use this information to augment shipping apps (expedite customs clearance) and invoicing apps (issue goverment invoices).

Starting in the 2020-07 release candidate, orders made through checkout in countries that require a tax id for customs clearance or government invoicing will have this information available through the GraphQL API.

You can try these APIs by using a development store with the 'Localization Extensions' developer preview enabled.

For more information on how to apply tax IDs on checkout and view them through the GraphQL API, read to our localization extenson tutorial.

For any questions and discussion regarding the Localization Extensions developer preview, visit our forum post.

Navigating to individual pages on the Online Store Editor is now supported for the Online Store Design Experience developer preview with a new page picker feature on the Online Store Editor.

The page picker option in the top bar of the Online Store Editor allows users to search for specific pages, or navigate to a page using a drop-down selector filtered by page types. This will enable merchants and developers to quickly access a specific page when customizing the storefront using the Online Store Editor.

The total tip amount received on an order is now available in the GraphQL Admin API 2020-07 release candidate via Order.totalTipReceived.

See the 2020-07 release candidate reference docs for details.

You can now integrate your app with Amazon EventBridge to receive Shopify webhooks using an event bus. EventBridge's serverless, event-driven architecture can help you reduce infrastructure costs while providing a scalable system.

Visit our developer documentation to learn how to set up an event source and manage events with EventBridge.

We’ve added two new Liquid theme tags.

liquid

The liquid theme tag simplifies theme code. Developers can now write multi-line tags and output expressions within one set of delimiters. This reduces the requirement to open and close multiple sets of delimiters when creating variables and conditions, or executing blocks of code. Learn more about the liquid tag in our developer documentation.

echo

The echo theme tag works inside the new liquid tag to output an expression, or Liquid object, in the rendered HTML. Filters can also be applied to expressions using the echo tag. Learn more about the echo tag in our developer documentation.

We’re adding more flexibility to merchant billing, making it easier for your users to keep running their businesses during COVID-19 and avoid store shutdowns. The change means that you might see delayed payouts from some of your referred stores.

Learn more about how merchant payments impact your payouts in the Shopify Help Center.

We’ve improved the reporting for ads so that advertisers can more accurately tell where their ads are showing up. Specifically, we are adding the following two new reporting columns:

• Average position will report on the position that their ad displays as. Learn more here.
• Visibility will report (as a percentage of first page auctions you participate in) what percentage of your impressions are served on the first page. Visibility will only apply to impressions served March 11, 2020 onward. Learn more here.

Shopify POS 6.0 has been rebuilt and redesigned. Omnichannel features and essential upgrades to Shopify’s point of sale, including a new smart grid interface, global search, analytics, curbside pickup, and more, have been added.

Apps built to integrate with Shopify POS using the POS SDK or App Bridge will continue to function in POS 6.0 (all-new POS), and the app interface will automatically adjust to work within the new smart-grid design.

Discover new opportunities to build integrations and features for brick and mortar merchants today.

Lean more about building apps for POS

Shopify has introduced a new Pause plan for stores. The new Pause plan allows merchants to pause their store for up to three months.

While merchants take a pause from running their store on Shopify, all apps will remain installed on the paused store, but app billings will be frozen and merchants will not abe able to access or use the apps. This means that merchants do not need to reinstall and reconfigure their apps when they resume running their business.

This update helps app developers to retain users in the long term by allowing a simple and seamless pause in the short term. No action is required from app developers.

Stores in this state have a plan display name of Full Pause in the shop/update webhook. Recurring charges for these stores appear as as Recurring charge frozen in the Partner Dashboard.

The amount field is no longer a required field on DraftOrderAppliedDiscountInput. If omitted, then the amount is automatically calculated based on the value and valueType. This avoids unnecessary calculations by API clients that can otherwise be done by Shopify.

For more information, refer to DraftOrderAppliedDiscountInput in our GraphQL reference.

This month we have released new features for developers participating in the Online Store Design Experience partner beta. The following features are now available for testing for new and existing development stores using the "online store design experience" developer preview. You can find info on how to create a developer preview store in our Help Center.

The Sections theme architecture is now supported on the Cart, Password, and 404 pages. Sections can be enabled on these pages using the Online Store Editor with a sections-compatible theme. More info on how to enable sections on a page can be found in our Developer Documentation.

The Section Rendering API can be used to request the HTML markup of frame, page, content, and app sections through an AJAX request. This improves storefront performance by allowing you to update page content by fetching only partial elements of a page, instead of reloading it entirely. More info on this new API can be found in our Developer Documentation.

HTML tags can be inserted around theme frame sections using the wrapper property. This allows developers to optionally use containers and other tags around the three segments of a page. More info on the wrapper property can be found in our Developer Documentation.

Sections can now contain a text input and a URL picker on a single setting with the link setting type. The link setting type can only be used in sections (including the additional settings of content sections).

For any questions regarding the online store design experience developer preview visit our dedicated forum.

As of today, we've changed how we calculate and display an app’s overall star rating, from a historical average to a weighted average that favours recent reviews. As apps change over time, we want to ensure that merchants see a rating that’s more reflective of the current capabilities of your app.

Please note that there shouldn't be a noticeable impact on your search and category ranking.

If you’re concerned that the volume of reviews you’ve received hasn’t grown inline with your app improvements, take note around best practices for asking for reviews. We also recommend replying to reviews as we’ve seen a positive correlation in review replies and updated star ratings.

The length of newly generated Shopify access tokens will increase from 32 to 38 characters, adding a static prefix of shpat_ (for public apps), shpca_ (for custom apps), or shppa_ (for legacy private apps). This change will take effect on April 1st, and will impact all access tokens generated after this date.

This is a breaking change only if your application makes assumptions regarding the length of Shopify access tokens. For example, if your app store Shopify access tokens in a 32-character database field or validates that they are exactly 32 characters, then you should adjust your application or database so it can accept longer access tokens prior to April 1st. Existing access tokens will continue to function in their 32-character form until they expire or are re-requested.

Learn more about authenticating your Shopify app from the Shopify Help Center.

Today we are releasing a new developer preview to allow merchants the ability to charge duties calculated by Shopify during checkout and avoid surprise charges for their customers upon delivery.

As of the 2020-04 release, duties and taxes charged on international orders through checkout can be viewed through the REST and GraphQL API, and refunded through the GraphQL API.

You can try these changes using a development store with the 'Duties and Taxes' developer preview enabled.

For more information on how to apply duties on checkout and refund them through the GraphQL API, refer to our tutorial.

For any questions and discussion regarding the Duties and Taxes developer preview, visit our forum post.

The 2020-04 release adds parameters to better represent edited orders to the Storefront API and exposes new information about duties and taxes on international orders . Version 2020-04 also adds more information about media that has been embedded on product pages with additional fields for Product Media.

Explore all the API changes included in this release in the 2020-04 release notes.

You can also read more about API versioning in the versioning guide and on the partner blog.

Beginning today, partners who want to test orders in development stores can only process payments using the following methods:

• Shopify's test payment provider (Bogus Gateway).
• A payment provider set to test mode.

If you need to test your development store using real transactions, then you need to transfer your store to a paid plan.

Orders and payments in existing development stores will not change immediately. Updates to existing development stores will be announced in the developer changelog.

Learn more about test orders on the Shopify Help Center.

If you have further questions about testing payments and orders in newly created development stores, get answers in our dedicated discussion area for developers, or reach out to partner support through your Partner Dashboard.

With the evolving concerns around COVID-19’s impact on communities around the world, we know that partners and merchants are making adjustments to continue running their businesses smoothly. That’s why we’ve decided to postpone the April 1 version removal from April 1, 2020 to July 1, 2020.

This change in the timeline means that you have until July 1 to update your apps to account for changes in both 2019-07 and 2019-10 API versions. The move from page to cursor-based pagination comes into effect for all endpoints on July 1. This simplifies the migration process for apps that need to update their pagination strategies.

To see the deprecated API calls your apps are making, check out the API Health report on the Partner Dashboard.

We’ve added the following Storefront API fields to the Order and OrderLineItem objects. These new fields can be used to gain additional visibility into an order's state after an edit.

• Order.fulfillment_status
• Order.cancelled_at
• Order.financial_status
• Order.cancel_reason
• LineItem.current_quantity
• LineItem.original_total_price
• LineItem.discounted_total_price
• Order.original_total_price
• Order.current_total_price
• Order.edited
• Order.current_subtotal_price
• Order.current_total_tax

We’ve updated our Partner Program Agreement (PPA) to include new definitions of public and custom apps, and to clarify our role as a billing agent. Being a billing agent means we’re the party responsible for facilitating payment transactions between partners and merchants of apps, themes, and services.

PPA updates regarding public and custom apps are effective immediately, as communicated on our partner blog.

For PPA updates regarding the billing and tax status of some Shopify partners, we’ve made sure to provide partners with 90 days notice to assess the potential impact on how they run their businesses. As a result, the billing and tax updates to our PPA will come into effect on June 1st, 2020. Partners will begin to see product changes that reflect these billing and tax updates starting June 2020.

Partners who are impacted by these PPA updates have been directly notified by email and their Partner Dashboard.

The new API Health report on the Partner dashboard shows the deprecated API calls your apps are making, along with documentation and timelines that help keep your apps up to date with Shopify’s API versions. This tool shows details of each deprecated call including the affected endpoint and the last time a call was detected.

Learn more about the API Health report in the Shopify Help Center.

Use the customerActivateByUrl mutation to activate customer accounts without parsing the activation URL for the customer ID and token. Just send the full URL and a new password to activate the customer.

Learn more about updating customers using the Storefront API in the Shopify Help Center.

Use the customerAccessTokenCreateWithMultipass mutation to log a customer in without the email and password inputs. Send the multipass token to enable a customer and log the customer in. If a customer record does not exist in the shop, then it will be automatically created.

Learn more about how to implement a multipass token and create a customer access token using multipass in the Shopify Help Center.

With over a million stores on Shopify, it’s rare that an incident impacts every store or every service. In order to help merchants understand if their store has been affected by an incident, we’re moving Shopify's status page to a dashboard that's specific to their Shopify single sign on account.

As part of this move to store-specific status updates, subscriptions to updates (SMS alerts and RSS feed) have been deprecated. Overall status and major outages will continue to be posted to the public shopifystatus.com page.

If you are a partner or an app developer who is working with merchants on projects that require status information, such as launching ads for their store or troubleshooting an app, please have your clients or app users check their store-specific status page first as part of the process. Our team is currently working on ways to enable Partners to see status information for stores where they have collaboration login access from the merchant.

All qualified partners with apps listed on the Shopify App Store will soon be able to create search ads to help merchants discover their apps in the Shopify App Store.

Ads will be shown to merchants on app store search result pages, above the organic search results. You can associate your ads to specific search terms so that your ads are shown when a merchant searches for those specific terms.

Learn more about advertising in the Shopify App Store, in the Shopify Help Center.

Beginning February 10th 2020, merchants who are using an iOS device to operate Shopify POS must be on iOS 11.2 or higher to receive updates. Merchants who are using iOS 10 or below will no longer be able to receive bug fixes or feature improvements.

If you develop embedded apps for POS Classic or the all-new Shopify POS, you should target iOS 11.2 as your minimum version to ensure that merchants get the best experience.

Shopify POS Faq - iOS and Android version support

We’ve added a new property for the article object as well as updated the behaviour of cart.attributes and the /cart/add.js endpoint.

article.updated_at

The article.updated_at property returns a timestamp defining when a blog article was updated. This allows themes to include the dateModified field within their Structured Data for SEO purposes. The date filter can be applied to format the timestamp. Learn more about the article.updated_at property in the Help Center.

cart.attributes

This existing property has been updated to hide keys with a double underscore (__) prefix from Liquid and AJAX API. Learn more about the cart.attributes property in the Help Center.

/cart/add.js

The /cart/add.js endpoint (add to cart) of the AJAX API has been updated to support adding multiple items to the cart in a single request. This previously required a complex queuing system to send multiple requests. The previous payload format is still supported, but the "multiple items" payload format is now the recommended approach. Learn more about the Ajax API in the Help Center.

The length of all newly generated Shopify app secret keys has increased from 32 to 38, adding a static prefix of shpss_, to make the secret keys easier to identify.

Existing API secrets will continue to function in their 32 character form until Shopify Partners manually regenerate them. This is the secret passed in as client_secret to https://{shop}.myshopify.com/admin/oauth/access_token to obtain an access token.

Learn more authenticating your Shopify app from the Shopify Help Center.

We are proud to announce a developer preview of our new sections theme architecture. As part of this developer preview you'll be able to:

• Define new theme frames to customize store headers and footers on different pages
• Customize page sections to create unique displays and formatting
• Create custom content sections that can be added to and removed from pages through the Shopify Admin
• Edit pages individually or globally, as master pages, with multi-page editing

This developer preview is limited to adding sections to product pages, but upcoming iterations will extend this functionality to all storefront pages. You can learn more about working with the new section architecture by visiting our Help Centre guides.

This developer preview is being released as part of our new online store design experience partner beta. In order to implement sections on product pages, you will need to edit your theme to conform to the new theme architecture. To see an example of this implementation, you can download our sections-compatible Debut theme.

For any questions regarding the online store design experience partner beta visit our dedicated forum.

You can now leverage two new app extensions to securely surface your app’s functionality on a merchant's store:

• App sections empower you to create new content sections that can be added, removed and configured right from the new online store editor
• App snippets help safely inject liquid code into a merchant’s online storefront.

You can learn more about creating both types of online store app extensions in our Help Centre.

This developer preview is being released as part of our new online store design experience partner beta. By participating in this beta you will be able to explore and test a number of new theming features, provide feedback and prepare and update your own custom themes with the new sections architecture.

For any questions regarding the online store design experience partner beta visit our dedicated forum.

You can now preview our new online store design experience. Through this preview you will be able to:

• Install our sections-compatible Debut theme and test new sections on product pages (all page types will be supported in the near future).
• Add, remove, and configure sections on product pages through the new online store editor.
• Explore our new online store editor to customize pages and sections within the Shopify Admin.

You can learn more about the online store design experience partner beta by reading our forum announcement.

If you have any questions or feedback about supporting this new online store design experience in your apps or themes, feel free to reach out to us in our dedicated discussion thread or through your partner dashboard.

With the release of the 2020-04 version of the Storefront GraphQL API, you can now access your inventory quantity if needed to build your shopping experience.

This information is hidden by default, but if you want to enable it, simply navigate to the private app and select the new checkbox for “inventory quantity” under the Storefront API section.

The Shopify Theme Inspector for Chrome is a Chrome DevTool plugin that lets you benchmark your Online Store’s Liquid performance, pinpoint Liquid performance issues in your theme, and test improvements for faster server response times.

• This tool helps you visualize results as a flame graph which is readable and easy to understand.
• You can examine the flame graph nodes to localize performance issues down to the exact file and line.
• A code snippet link will open up to the exact line of Liquid in your admin code editor so you can view and edit the code in context.

If you'd like to learn more, contribute a feature, open an issue, or make a feature request, check out the Shopify Theme Inspector Github repository.

Searchable resources for our predictive search API now include collections.

Read more about the predictive search API in the Shopify Help Center.

The 2020-01 release contains many of the features we previewed at Unite 2019. The product media, order editing, and fulfillment orders features are now stable and available on merchant stores. You’ll also find new additions to how you can manage smart collections and discount codes.

Explore all the API changes included in this release in the 2020-01 release notes.

You can also read more about API versioning in the versioning guide and on the partner blog.

With the release of the 2020-01 version of the REST Admin API, a new Collection API is available with the following features: * Get the products in a collection * Get a collection by its ID

Learn more about the Collection REST Admin API in the Shopify Help Center.

The Predictive Search response has been updated to include additional image details. These are all grouped under featured_image and include the following fields: * featuredimage[:alt]: the image alt tag * featuredimage[:width]: the image width * featuredimage[:height]: the image height * featuredimage[:aspectratio]: the image aspect ratio * featuredimage[:url]: the image url

Read more about the predictive search API in our Help Center.

Order editing is now available to select Shopify merchants. To help you extend this feature, we’ve published a set of order editing APIs to the release candidate of version 2020-01.

What’s included?

• GraphQL mutations that allow you to add and remove line items, as well as adjust line item quantities.
• An order/edited webhook that describes what's changed during an order edit.

Learn more about how to edit orders using GraphQL in the Shopify Help Center.

We’re putting safeguards in place for future Shopify public apps and introducing a new type of custom app.

No existing apps will be affected by this release.

Read more on the Shopify Web Design and Development blog.

Unit prices and the measurement information related to their generation is now available through the Storefront API as part of the release candidate (2020-01). The unit price feature associated with these fields is currently available to select Shopify merchants.

The following new fields were added to the product variant object:

• presentmentUnitPrices
• unitPrice
• unitPriceMeasurement

Learn more about these fields in the Shopify Help Center.

We’ve added a new global object and some new properties to Liquid, which are currently in production for all stores.

request.page_type

The request.page_type property returns the type of the current page, for example, product, article, and index.

Learn more about the request.page_type property in the Help Center.

routes

Generates URLs to your storefront. By using routes instead of hardcoded links, you can make sure your theme supports any changes to the URL format.

Learn more about the routes global object in the Help Center.

product.options_by_name

Gives direct access to a product' option values by using the option name.

Learn more about product.options_by_name property in the Help Center.

allow_false

The default filter now accepts an allow_false argument. You can use allow_false to set a default value for any variable with no assigned value. This can be used with strings, arrays, and hashes.

Learn more about this filter in the Help Center.

The Buy Button cart component’s model is no longer initiated to an empty checkout. Instead, the model is null until a variant is added to cart. This is expected to have a positive impact on the performance on your Buy Buttons!

If you have leveraged the cart’s model in any custom code written using Buy Button JS, it is recommended that you verify your Buy Button still functions as expected.

Learn more about these changes by reviewing the pull request on Github.

Errors in GraphQL responses now contain extra metadata under the extensions key. The error format follows the GraphQL specification.

The most notable metadata is the code property which returns the error code. This feature allows you to more easily match on the types of errors without having to match on the full error message.

For example:

{
  "errors": [
    {
      "message": "Internal error. Looks like something went wrong on our end.",
      "extensions": {
        "code": "INTERNAL_SERVER_ERROR",
        "requestId": "d2f47302-8559-4961-9a5b-3de60172aa29"
      }
    }
  ]
}

Querying a product's collections is now faster because we've optimized how we build the connection between a product and its collections.

Since this is a new way of building out connections and their associated cursors, you won't be able to use a cursor from a previous version of the API. Use the same workflow as today with the 2020-01 API version to unlock these performance gains.

We have removed the featured field from Collects. This field will no longer be available in Admin REST API queries returning collects.

See the collects API for a list of affected endpoints.

We've opened up the ability for any published Shopify marketing app to be embedded directly into the Shopify admin through the marketing activities API.

You can build your own app extension today to be on the list of marketing integrations.

You can find more information about creating an app extension using the marketing activities API in the Shopify Help Center At a high level, the implementation requires the following steps.

If you have any questions about this update, then contact support through your partner dashboard or request support in our Shopify APIs and SDKs discussion board.