Developer changelog

The Shopify Markets API (v2022-04) lets developers manage markets and settings, enhancing localized buyer experiences with custom domains, languages, currencies, and pricing.

New GraphQL Admin API features: offer recurring app discounts and extend trial days to attract merchants. Discounts apply for set billing cycles; trial extensions available in unstable API version.

GraphQL connections now support a nodes field, simplifying queries. PageInfo adds startCursor and endCursor, enhancing pagination and data return efficiency.

GraphQL and REST Admin APIs v2022-04 add fulfillBy, maxDeliveryDateTime, and minDeliveryDateTime to FulfillmentOrder and DeliveryMethod, enhancing order and delivery scheduling.

As of API version 2022-04, the GraphQL Admin API's FilterType enum has a new value(BOOLEAN). The BOOLEAN value is assigned when a filter is based off a boolean type metafield definition.

...

As of GraphQL Admin API version 2022-04, a new checkoutCharge field has been added to sellingPlan. It consists of a charge type (either percentage or price), and an amount, indicating how...

As of the 2022-04 version of the Storefront API, you can fetch a navigation menu by handle with the menu field. The new field returns a...

API v2022-04 deprecates acceptsMarketing fields. Update apps to use emailMarketingConsent and SMSMarketingConsent for detailed consent data. Adjust GraphQL and REST API integrations.

GraphQL Admin API Customer object updates: orders_count is now number_of_orders, total_spent fields replaced by amount_spent, and has_note and has_timeline_comment removed.

GraphQL Admin API 2022-04 lets developers issue prorated credits on app subscription cancellations, reducing refund support requests.

As of GraphQL Admin API version 2022-04, a new owner type ApiPermission is now available for metafields. A metafield with this permission type will only be readable and writable by the app that...

As of GraphQL Admin API version 2022-04, checkoutChargeAmount and remainingBalanceChargeAmount fields have been added to sellingPlanAllocation. These fields indicate how much of a product...

You can now create videos and transcode them to multiple formats, using the...

With the launch of the Markets API as of version 2022-04, price lists are no longer associated with a country, but with a market. We've deprecated the countries field on the...

In GraphQL Admin API v2022-04, INVALID_LOCALE_FOR_SHOP now indicates locale errors in Translation. Older versions use INVALID_CODE for these errors.

Theme developers can now use the Shopify CLI theme serve command with the new --theme-editor-sync flag. When active, theme editor changes are automatically synced back to the local development...

Developers can now programmatically push their scripts and extensions to Shopify from their CI/CD pipelines with CLI authentication tokens.

For more information on how to set up CI/CD for your...

Two new input setting types have been added to the theme editor: product_list and collection_list. They allow merchants to quickly create curated, ordered and paginatable lists of products and...

As of GraphQL Admin API version 2022-04, an error returns when a metafield definition is created with invalid characters in either the key or the namespace fields. The key and namespace...

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

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.

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.

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.

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

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.

...

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

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

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

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

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