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:
- Platform
Updates to our Partner Program Agreement now in effectRead full post –>We've updated the following items in our Partner Program Agreement:
- Terms related to the new revenue sharing plan for app developers
- Administrative...
Tags:
- Platform
Changes to the Partner payout CSV and app earnings CSVRead full post –>On Aug 1, 2021, Partner payout CSVs will include a new "Processing fee" field, and "Partner share" will be updated to reflect deductions, aiding revenue understanding for developers.
Tags:
- API
- 2022-01
New updates to Partner APIRead full post –>The unstable Partner API now includes
in transactions, updatescalculations, deprecates, and introducesfor better revenue tracking.Tags:
- Shopify App Store
Published app developers can register for the new revenue share model on August 1stRead full post –>Starting Aug 1, 2021, Shopify app developers can opt for a new revenue plan: 0% on the first $1M and 15% on excess, down from 20%, via the Partner Dashboard.
Tags:
- API
- 2021-07
Manage webhooks with Google Cloud Pub/SubRead full post –>As of API version 2021-07, you can use the GraphQL Admin API and Google Cloud Pub/Sub to subscribe to, update, and delete webhook subscriptions.
You can learn more about [managing webhooks with...
Tags:
- Action Required
- Tools
Validate draft versions of theme app extensions using Theme CheckRead full post –>You can now validate a draft version of a theme app extension using Theme Check.
You can validate the content and structure of your extension by...
Tags:
- API
Bulk Mutation API now availableRead full post –>Use the BulkOperationRunMutation endpoint to efficiently import data in bulk asynchronously, supporting various mutations like productCreate and productUpdate without throttling issues.
Tags:
- API
- 2021-07
TaxLine object now has a channel_liable fieldRead full post –>The 2021-07 API update adds a
field to, clarifying sales tax remittance responsibility for developers and merchants across sales channels.Tags:
- API
- 2021-07
Metafields in GraphQL Storefront API available on additional resourcesRead full post –>Metafields are currently available to Products and Product Variants in the unstable API version. When the stable API version 2021-07 is released, the Metafields will also be available to Shop...
Tags:
- API
- 2021-04
Discount application methods are returned by the Checkout resourceRead full post –>As of version 2021-04 of the REST Admin API, the Checkout resource returns the
property for discounts that are added to a checkout. The field shows how the discount was applied....Tags:
- Themes
Online Store 2.0: Introducing the new Liquid input settingRead full post –>The new Liquid input setting lets merchants add custom Liquid code in the editor, accessing global and template-specific Liquid objects without altering theme code.
Tags:
- API
- 2021-07
New code for unrecognized currenciesRead full post –>API v2021-07: GraphQL Admin API returns
for unrecognized currency codes.is invalid as input. Prevents order page errors with unsupported currency codes.Tags:
- Tools
Online Store 2.0: Detect theme errors with Theme CheckRead full post –>Theme Check now integrates with Shopify Liquid VS Code extension, detecting Liquid syntax errors, missing templates, unused variables, deprecated tags, and performance issues.
Tags:
- API
- 2021-07
File API is now availableRead full post –>As of API version 2021-07, you can use the File API to create, update, and delete generic files and images. This functionality allows merchants to reuse files for different apps. These files are...
Tags:
- Tools
Online Store 2.0: Create and manage themes using Shopify CLIRead full post –>Shopify CLI now supports theme development: build, preview, hot-reload, initialize with Dawn, push, publish, lint with Theme Check, and populate test data directly from the command line.
Tags:
- API
Post-purchase checkout extensions beta accessRead full post –>You can now access our post-purchase checkout extension beta. This allows you to start building high-converting experiences like upsell offers, survey, donation requests, and more.
For more...
Tags:
- Action Required
- API
- 2021-07
New updates to the Storefront APIRead full post –>The 2021-07 Storefront API release adds subscription support, international pricing, local pickup, and more metafields. Unstable API introduces cart and filtering features.
Tags:
- Tools
Online Store 2.0: Shopify GitHub integration now availableRead full post –>With the Shopify GitHub integration, you can connect your GitHub user account or organization to your Shopify admin, and connect Git branches to themes in your store. Native support for version...
Tags:
- Tools
Online Store 2.0: Build and test themes with development themesRead full post –>Shopify CLI now auto-creates hidden development themes with
shopify theme serve, ensuring privacy and reusability within the same session.Tags:
- Action Required
- Themes
Online Store 2.0: JSON templates and improvements to LiquidRead full post –>Themes now support JSON templates, excluding
androbots.txt. JSON allows default section setup and dynamic data linking. Liquid updates include translation and rendering improvements.Tags:
- Themes
- 2021-10
Online Store 2.0: New metafields type system and dynamic sources availableRead full post –>New commerce-oriented metafield type system enhances interoperability.
typefield replaces deprecated.jsonreplaces, but no auto-migration occurs.Tags:
- Action Required
- Shopify App Store
Online Store 2.0: Extend apps into the Online Store with theme app extensionsRead full post –>App developers can now integrate their apps into the Online store with theme app extensions. A theme app extension is a bundle of app block definitions and supporting files. App blocks can be...
Tags:
- Themes
Online Store 2.0: New reference theme available: DawnRead full post –>Dawn is Shopify's first open-source theme using Online Store 2.0 features like JSON templates, enhancing flexibility and performance. Ideal for developers as a model for new themes.
Tags:
- API
- 2022-01
Online Store 2.0: New metafields type system and dynamic sourcesRead full post –>New commerce type system for metafields enhances interoperability.
typefield replaces deprecated. Non-breaking change;removed in 2022-01. Dynamic sources supported.Tags:
- API
Subscription APIs now support Authorize.netRead full post –>Shopify Subscription APIs now support Authorize.net, enabling credit card storage via CustomerPaymentMethod API for use with SubscriptionContract API.
Tags:
- API
Retrieve accurate and reliable order sales dataRead full post –>Shopify's new APIs let developers query comprehensive sales changes on orders, providing accurate data on discounts, taxes, and line items, ensuring precise sales insights.
Tags:
- API
Storefront API now available for custom appsRead full post –>The Storefront API, which was previously limited to only private apps and public sales channel apps, can now also be used by custom apps to create custom buying experiences.
Learn more about...
Tags:
- Tools
Build and test your product subscription app extension with the Developer ConsoleRead full post –>Test app extensions locally with real store data; changes render instantly without publishing. Supports both desktop and mobile environments.
Tags:
- Tools
App developers can initiate app refunds from the Partner DashboardRead full post –>Developers can now issue app refunds up to $1,000 directly, enhancing merchant satisfaction. Staff accounts need 'Manage refunds' permission. No need to contact Shopify Support.
Tags:
- Tools
Access theme files with the Theme Kit Access appRead full post –>The new Theme Kit Access app makes it easier for merchants to grant access to their theme. Instead of relying on a private app API password to authenticate, merchants can now leverage the Theme Kit...
Tags:
- Shopify App Store
Update - Shopify App Store Categories and SubcategoriesRead full post –>Shopify App Store categories are streamlined and renamed for better merchant search. Developers may see apps in new categories, affecting page rank.
Tags:
- Themes
The pages global Liquid object is now iterableRead full post –>Iterate through the global Liquid
pagesobject for paginated access to up to 50 pages, enabling dynamic HTML generation based on page data. Access specific page properties directly.Tags:
- API
- 2021-07
Subscriptions APIs now support PayPal ExpressRead full post –>Added CustomerPaypalBillingAgreement to store PayPal Billing Agreements in Shopify. Introduced mutations to create and update agreements, enhancing SubscriptionContracts functionality.
Tags:
- Themes
New localization form enables country selectors in themesRead full post –>New localization form enables country selectors in themes, allowing different prices for countries with the same currency. Backwards compatible, but recommended over the currency form.
Tags:
- Platform
Shopify now serves minified CSS files automaticallyRead full post –>As of May 2021, Shopify will automatically minify theme CSS when it is requested by the storefront. Minified CSS files are cached until the next time the underlying CSS file is updated.
...
Tags:
- API
New query filter on SellingPlanGroupsRead full post –>Shopify API now allows querying
by, enabling access to groups created by other apps. Use,, or specific app IDs for targeted queries.Tags:
- Action Required
- API
- 2021-07
Post-purchase fulfillment holdsRead full post –>Orders with post-purchase offers now have fulfillment holds, affecting
. Fulfillment status updates after 60 mins or offer acceptance. Use FulfillmentOrders API for updates.Tags:
- API
BulkDiscountCodeCreationJob performance improvementRead full post –>The discount code creation job has been updated to enhance its performance, including an update to our request throttling. For best results, enqueue a discount code creation job, and then enqueue...
Tags:
- Shopify App Store
Activity log added for app store adsRead full post –>New activity log for app store ads tracks ad creation, status, budget, and keyword changes, enhancing ad management and accountability for developers.
Tags:
- API
New constituent countries for United Kingdom zoneRead full post –>UK zone info now includes constituent countries: England, Northern Ireland, Scotland, Wales, and British Forces. Existing shops auto-update. Use GraphQL/REST APIs for data queries.
Tags:
- Platform
Host parameter added to the OAuth redirect URIRead full post –>Shopify adds a
hostquery parameter for OAuth redirects, crucial for App Bridge 2.0. Ensurehmacverification includes all URI parameters to avoid breaking changes.Tags:
- Tools
Restrict staff member access to development & managed stores with Store access controlsRead full post –>Enhanced store access controls now let owners specify staff access levels, manage store ownership, and provide store-specific access via the Partner Dashboard, improving security and collaboration.
Tags:
- Action Required
- API
EASDK being removed and embedded apps must migrate to App BridgeRead full post –>EASDK and compatibility layer deprecated by Jan 1, 2022. Migrate to App Bridge 2.0 for better performance. New apps need App Bridge 2.0 and session tokens by May 1.
Tags:
- Shopify App Store
Increased app quality checks for published appsRead full post –>Shopify App Store enhances app quality checks to ensure compliance with updated requirements, performance standards, and honest listings. Non-compliant apps will receive guidance for corrections.
Tags:
- API
Removing discount allocation method "one".Read full post –>API v2020-07 updates discount allocation methods, replacing "one" with "each" and "across." Affects discount_applications in order-related webhooks. Apps won't be delisted for warnings.
Tags:
- API
Predictive Search now returns appropriate results for translated storefrontsRead full post –>We’ve just released a change to predictive search that fixes the issue where predictive search API returns results in multiple languages. This helps customers searching for products on translated...
Tags:
- API
3D Secure Customer Authentication Support for SubscriptionsRead full post –>3D Secure 2.0 is now required for recurring payments in Europe. Shopify notifies buyers of authentication needs; partners must retry payments if authentication fails.
Tags:
- API
Manage international pricing with the price list admin APIRead full post –>Introducing price lists, a new API resource that allows you to configure international pricing. ...
Tags:
- Platform
New App Charge Overview Page in Partner DashboardRead full post –>New app charge overview page in Partner Dashboard lets developers view all charges, aiding in billing inquiries and understanding payouts.
Tags:
- API
- 2021-04
GiftCard API available for Shopify Plus custom and private appsRead full post –>GiftCard GraphQL and REST APIs are now available for custom apps on Shopify Plus, enabling developers to manage gift cards by querying, creating, updating, and disabling them.