Developer changelog

The 2021-10 Storefront API update introduces handle/ID lookups, the OnlineStorePublishable interface, and plans to remove Base64 encoding for object IDs, impacting future API interactions.

Apps can now use the bulk_operations/finish webhook for notifications on Bulk Operation status, eliminating the need to poll the GraphQL Admin API for updates.

As of API version 2021-10, the line_item object on a Fulfillment will include a fulfillment_line_item_id property. This property represents the ID of a line item from an order that's...

As of API version 2021-10, the Order object will include an app field representing the application that created the order. The field returns an OrderApp object.

Learn more about [this API...

GraphQL API 2020-10 adds revokedReason to CustomerPaymentMethod, detailing why a payment method was revoked, aiding in error diagnosis and handling.

API v2021-10 adds ONLINE_STORE_MENU and PACKING_SLIP_TEMPLATE to TranslatableResourceType. Their title and body fields are now translatable via the translations API.

API version 2021-10 adds the origin_address property to the REST Admin API's Fulfillment resource. origin_address specifies the address at which a fulfillment occurred.

origin_address ...

External apps can now use a webhook for 3-D Secure subscription billing challenges. Requires own_subscription_contracts access scope for subscription_billing_attempts/challenged topic.

API v2021-10 removes full from User permissions, aligning with v2021-07's explicit permissions list. Ensure your integrations handle this change.

As of API version 2021-10, you can use the bulkProductResourceFeedbackCreate mutation to create up to 50 feedback entries on a product resource in a single API request. You can also query for...

The BulkOperation object has a new type field that returns whether the operation is a query or a mutation.

Learn more about the type field in the [BulkOperation object...

API v2021-10 introduces contextualPricing for querying prices by context, including international pricing, on Product Variant and Product objects.

The 2021-10 API adds customerPaymentMethodGetUpdateUrl mutation for secure payment updates. Supports Shop Pay; more methods soon. Use customerPaymentMethodSendUpdateEmail as fallback.

API v2021-10: Sales Channels can now use TokenizedPaymentInputV3 with PaymentTokenType set to STRIPE_VAULT_TOKEN to complete checkouts via Storefront API.

You can now take advantage of preload links in Liquid by using the preload_tag filter. The filter will add a link tag with...

In limited circumstances, such as when using cart permalinks, customer details like email and shipping address could be contained in the query...

You can now directly report violations of our Partner Program Agreement, instead of...

As of API version 2021-10, you can use the GraphQL Admin API and REST Admin API to retrieve, add, and update a customer's consent to receive marketing material by SMS.

You can also subscribe to...

Shopify’s post-purchase checkout extension now supports subscriptions offers. By surfacing subscription offerings immediately after checkout, you can now start building high-converting experiences...

Shopify adds fulfill_by field to FulfillmentOrder in unstable APIs, helping merchants meet multi-channel order deadlines and avoid penalties. Available via new mutation and endpoint.

You can now query merchantApprovalSignals on the Shop object to determine whether a merchant is pre-verified for onboarding to channel apps.

This query helps you to accelerate the process...

We increased the maximum number of app blocks supported in theme app extensions from 10 to 25. Learn more about theme app extensions on...

We've updated the terms related to the new revenue sharing plan for theme developers in our Partner Program Agreement.

For more information and...

The SKU sharing preview lets fulfillment apps stock and fulfill variants with merchants. Use permits_sku_sharing to enable shared fulfillment across locations and services.

Starting Tuesday September 7, 2021, if you're submitting an app that integrates with a theme to the Shopify App Store, then you need to use [theme app...

You can now show predictive search results through a rendered section using the following:

• The Liquid predictive_search object
• The /search/suggest...

Shopify themes can now include a currency setting to display currency codes with prices, aiding customer clarity and reducing checkout confusion.

Metafields now support a Rating type. Ratings represent a value on a specified scale, such as a product rating of 4.8 out of 5, or a spiciness rating of 3 chili peppers.

Learn more about Ratings...

Update theme sections to use @app instead of @global for app blocks. Download the latest Dawn version or manually update sections for compatibility with Shopify's new schema.

As of August 2021, Shopify automatically minifies theme JavaScript when it is requested by the storefront. Minified JavaScript files are cached until the next time the underlying file is updated. ...

External apps can now subscribe to SellingPlanGroups webhook events for lifecycle tracking. Requires read_products scope. Events: create, update, delete SellingPlanGroups.

We've updated the following items in our Partner Program Agreement:

• Terms related to the new revenue sharing plan for app developers
• Administrative...

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.

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.

The unstable Partner API now includes processingFee in transactions, updates netAmount calculations, deprecates SALE_SHOPIFY_FEE, and introduces taxType for better revenue tracking.

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...

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...

Use the BulkOperationRunMutation endpoint to efficiently import data in bulk asynchronously, supporting various mutations like productCreate and productUpdate without throttling issues.

As of version 2021-04 of the REST Admin API, the Checkout resource returns the application_type property for discounts that are added to a checkout. The field shows how the discount was applied....

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...

The 2021-07 API update adds a channel_liable field to TaxLine, clarifying sales tax remittance responsibility for developers and merchants across sales channels.

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.

API v2021-07: GraphQL Admin API returns XXX for unrecognized currency codes. XXX is invalid as input. Prevents order page errors with unsupported currency codes.

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.

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.

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...

Theme Check now integrates with Shopify Liquid VS Code extension, detecting Liquid syntax errors, missing templates, unused variables, deprecated tags, and performance issues.

Shopify CLI now auto-creates hidden development themes with shopify theme serve, ensuring privacy and reusability within the same session.

Themes now support JSON templates, excluding gift_card and robots.txt. JSON allows default section setup and dynamic data linking. Liquid updates include translation and rendering improvements.

New commerce-oriented metafield type system enhances interoperability. type field replaces deprecated valueType. json replaces json_string, but no auto-migration occurs.