Developer changelog

We've added subscription support for dynamic and accelerated checkout methods for PayPal Express on some stores.

Learn more about subscriptions in the...

Deprecated fields and image arguments removed from Storefront API unstable and 2022-04 versions, impacting data retrieval and image handling for developers.

Locale fields now support language and region codes in Order.customerLocale and Customer.locale for more granularity, e.g., fr-Fr for French customers in France.

As of GraphQL API version 2021-10, running the CustomerPaymentMethodRevoke mutation can now set the customer_payment_method.revoked_reason field to manually_revoked.

For more information,...

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

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

MediaErrorCodes and FileErrorCodes will now include a...

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

Include authorization or parent_id in transactions to prevent errors with order editing apps. Support multiple authorizations for successful payment captures.

Cart API now renders sections using the current page context via the Referer header if sections_url isn't set, instead of defaulting to /cart. Existing behavior remains unchanged.

Validation to identify vulnerable passwords has been added to the Storefront API's customerReset and...

The new image_tag filter simplifies adding responsive images, supports custom HTML attributes, and preloading, enhancing theme performance and flexibility for developers.

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.

The WebhookSubscription GraphQL object now has a privateMetafieldNamespaces field. You can use this field to specify private metafields that you want to be included in the payload for events...

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.

We have changed part of the AbandonedCheckout GraphQL API visibility to public. Third-party apps only have access to the AbandonedCheckout object and a selection of its fields if the...

The following types of storefront filters on product and variant metafields are now supported:

• single_line_text_field
• number_decimal
• number_integer

Learn more about [storefront...

We've added a new CustomerPaymentInstrument and...

Shopify's new Payment Terms API lets developers set order due dates and track overdue payments, enhancing B2B merchant flexibility and reducing manual payment management.

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

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

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

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

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

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.

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.

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

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

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

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.

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.

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

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

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.