Developer changelog

Returns now create Sales entries. New enums: ReturnAgreement, RETURN, FEE (RestockingFee, ReturnShippingFee). Admin API must accept new enums. New "returns/update" webhook added. INVALID_STATE error for canceled orders.

Admin GraphQL API 2024-04 adds InventoryItemMeasurement for weight and deprecates several ProductVariant fields, streamlining inventory and product data management.

Developers can now generate even more demand for their apps by showcasing them on the category and subcategory pages of the Shopify App Store.

Learn more about category page ads on...

As of 2024-04, filter Product.media by media_type like IMAGE. Migrate from Product.images to access all media types, enhancing app functionality and flexibility.

GraphQL Admin API 2024-04 lets you add, remove, or update shipping lines in orders. Use isRemoved to check removals. REST and webhooks now include is_removed for tracking changes.

As of 2024-04, you can now query the OrderPaymentStatus object to obtain information about its corresponding...

As of 2024-04, you can specify custom amounts to be charged from a vaulted card through the...

As of version 2024-04 of the Admin GraphQL API, you can now void a transaction through the transactionVoid mutation. ...

The @defer directive is in developer preview, enabling single GraphQL requests with streamed responses. Test it to help decide its inclusion in the Storefront API. Feedback is encouraged.

React developers can start using the App Bridge React v4 via NPM. This optional NPM package works with the [required App Bridge...

The 2024-04 GraphQL Admin API adds withCodeDiscounts to order.lineItem.discountedTotalSet, allowing inclusion of code-based discounts. Default is false, no client changes needed.

As of Feb 20, 2024, returnCreate and returnApproveRequest mutations create return sales. Update to LineItem definitions and use returnRefund for accurate sales ledger entries.

POS UI Extensions 1.6.0 adds bannerProps to CameraScanner for banner display and fetchPaginatedProductVariantsWithProductId to ProductSearch API for paginated variant fetching.

Product duplication now includes variant metafields. Previously, variant metafields were ignored when products were duplicated. Products can be duplicated via...

Order risk REST and GraphQL APIs deprecated April 2024. Use new Risk Assessments API with orderRiskAssessmentCreate mutation and ORDERS_RISK_ASSESSMENT_CHANGED webhook.

As of version 2024-04 of the Admin GraphQL API, you can read the additionalInformation object value on the deliveryMethod object using the [fulfillmentOrder...

Shopify's new Store Credit API lets developers issue, track, and report store credits, differentiating them from gift cards, enhancing checkout and support workflows. Available in developer preview.

New OAuth2 Token Exchange and Shopify managed install reduce redirects and flickers, speeding up app loads. Configure access scopes via CLI for seamless installation and token retrieval.

You can now use Admin UI extensions to provide a user interface for merchants to configure your Cart and Checkout Validation Functions.

Additionally, merchants on any plan can now use validation...

The Checkout Branding API now allows styling for main and order summary sections, enhancing control over design elements. Header and footer customization will follow in a future update.

As of 2024-01-31, customize checkout headers/footers via GraphQL API. Hide elements, control layout, and use UI extensions for content. New targets for Checkout and Thank you pages.

You can now use the Discounts Allocator Function API in Developer Preview to implement custom logic for distributing discounts across multiple products or orders.

This new API allows you to...

Theme Check 2.0 unifies Shopify theme tools, adding LSP features like hover docs, code completion for settings, translations, HTML, Liquid, and enhanced auto-closing in all editors.

You can now subscribe to select DOM events with the Web Pixels API, including input_changed, input_blurred, input_focused,...

The latest release enhances production with new tools: subrequest profiler, error console, CLI deploys, E2E testing, shareable previews, runtime mirroring, bundle insights, and CLI upgrades.

You can now integrate the Customer Privacy API and the Shopify Privacy & Compliance app into...

Shopify App Store now supports structured app category details, enhancing app evaluation for merchants. Categories include reviews, dropshipping, bundles, subscriptions, and more.

When you define the permissions your app requests, they will now show up in a new "Data Access" section on your app details...

Shopify's Checkout Sheet Kit v1.0.0 is now available for Android, React Native, and Swift, offering customizable, high-conversion checkouts in mobile apps. Open-source and ready to use.

Now in developer preview, we’ve introduced new GraphQL product APIs that support 2000 variants, allowing for support of more complex catalogs.

[Learn more...

Merchants can now find your app via AI-powered guided search using natural language in the Shopify App Store. Ensure your app listing is accurate to reach the right audience.

Starting January 31, 2024, use shopify app deploy instead of shopify app config push for app configuration. Update CLI and CI/CD scripts to avoid breaking changes.

You can now subscribe to compliance topics using you app's [TOML configuration file] (https://shopify.dev/docs/apps/app-extensions/configuration) and use PubSub or Eventbridge URIs as your...

Updated App Design Guidelines: Revised full-screen mode to max modal; removed admin app block directive for summary property.

With the latest version of App Bridge, you can use the POS API. This provides the ability to retrieve the POS user, device, and...

As of 2024-04, the Abandonment.isFromCustomStorefront field has been released into stable version.

In preparation for supporting IPv6 on storefront domains, merchants and partners should update any third-party tools, such as firewall rules, to allow traffic in the CIDR range 2620:127:f00f::/48...

As of version 2024-01, you can use the GraphQL Admin API to get and set a firstName and lastName on the CompanyAddress.

From 2024-04, MarketWebPresence fields defaultLocale and alternateLocales will use ShopLocale type. Update API calls to access enhanced locale info.

As of Shopify CLI version 3.53+, you can use GraphiQL in the CLI while running app dev by simply pressing the g hotkey.

This GraphiQL instance uses your app's credentials, working with the...

With the latest version of App Bridge, you can use the filter query option with the Resource Picker API to filter...

The 2024-01 REST Order APIs update aligns channel_liable behavior with GraphQL, clarifying tax remittance responsibility. Defaults to false if unspecified.

As of API version 2024-01, we've added the CAPABILITY_VIOLATION error code to the MetafieldsSetUserErrorCode enum. This error code is returned if you attempt to update a metafield in a way that...

The 2024-01 Cart Transform API adds fixed pricing, custom titles, and images for bundles, plus an update operation for Plus merchants. blockOnFailure ensures critical function execution.

As of 2024-01 version in the admin GraphQL API, you can specify whether to include translations when calling the...

Admin API 2024-01 allows checkoutBrandingUpsert to reset branding to defaults using null in checkoutBrandingInput, simplifying the reset of branding settings and subfield groups.

API version 2024-01 fixes a bug allowing refunds on returns with REQUESTED status. Refunds are now blocked, ensuring accurate return processing.

As of 2024-01 Metaobjects will be exposed as a MarketLocalizableResourceType. This means that...

As of 2024-01 the OrderTransaction endpoint now exposes the multiCapturable field, to inform whether a transaction can be captured multiple times.

Learn more about...

As of 2024-01, the line_items field on AbandonedCheckout GraphQL API will be available to public.