Developer changelog

As of GraphQL Admin API version 2022-04, new fields on the App resource are available. These include previouslyInstalled, webhookApiVersion, developerType, requestedAccessScopes,...

App listing pages now show Partner details: total apps, average app rating, and Shopify development duration, aiding merchants in decision-making.

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

Product Scheduled Publishing lets merchants set a specific datetime for product launches. Channels with validation must integrate to validate products before their scheduled release.

A new attribute (total_duties) is now available on the order object. order.total_duties attribute returns the sum of all duties applied to line items in the order. order.total_duties...

New themes now generate translatable content keys in a new format for JSON templates. Existing translations and themes before Feb 17 remain unaffected.

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.

It’s now possible to upsell subscriptions in cart in the online store. We added a new field, selling_plan, to the ...

Apple Pay payments are now accepted for recurring transactions. We added source and virtualLastDigits to the...

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.

The Shopify GitHub app is renamed from Shopify Online Store to Shopify, with no functionality changes, supporting custom storefronts and theme code management.

Storefront API now returns non-Base64 encoded object IDs in unstable, 2022-04, and future versions, impacting how developers handle IDs in their apps.

The 2022-04 API update deprecates embeddedUrl for originUrl and adds embedUrl for iframe embedding in ExternalVideo type, impacting Admin and Storefront APIs.

Shopify now offers a streamlined process for creating custom apps with enhanced security, replacing private apps. Existing private apps remain usable and modifiable.

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.

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.

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

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.

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.

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

Added standardizedProductType and customProductType fields to Product object. Standardized links to Shopify Taxonomy; custom offers more granularity. Enhances product categorization.

API v2022-01 adds metafieldDefinitions query support for Order, Collection, and Customer, expanding from Product and ProductVariant, enhancing customization options.

Starting in version 2022-01, the BULK_MUTATION_USER_ERROR_CODE error code for the bulkOperationRunMutation mutation has been replaced by more granular error codes.

For the list of new...

The GraphQL API now includes supportedRefundType in SuggestedOrderTransaction, indicating CARD_NOT_PRESENT_REFUND or CARD_PRESENT_REFUND, affecting refund processing logic.

As of GraphQL Admin API version 2022-01, we are releasing a new mutation orderInvoiceSend. This mutation will take an Order ID and an EmailInput and send the order invoice to the email. It...

As of GraphQL Storefront API version 2022-01, the Shop object has a new field: subscriptionPolicy. This field returns the subscription policy associated with the shop.

Learn more about the...

As of GraphQL Storefront API version 2022-01, the ProductVariant object has a new field: barcode. This field returns the barcode value (ISBN, UPC, GTIN, etc.) associated with the variant.

...

As of GraphQL Admin API version 2022-01, the ProductVariant object has a new field: sellableOnlineQuantity. This field returns the total sellable quantity of the product variant for online...

The customer object properties in the Order resource are deprecated; use the Customer resource instead. Removal from unstable in early 2022, official in 2022-04 API version.

This new endpoint takes an array of specific resource GIDs, and returns a list of TranslatableResources associated...

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

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

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

MediaErrorCodes and FileErrorCodes will now include a...

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.

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

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

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.