Developer changelog

GraphQL Admin API 2022-10 introduces inventoryBulkToggleActivation mutation, enabling bulk activation/deactivation of an inventory item across up to 250 locations.

As of GraphQL Admin API version 2022-10, we are adding mutations so you can manage your locations using GraphQL. This will allow you to add, edit, deactivate, re-activate and delete locations. ...

Admin API 2022-10 adds transactional_sms_disabled to Shop object in GraphQL and REST APIs. The "shop/update" webhook now triggers on changes to this field.

As of Admin API version 2022-10, a new field marketing_sms_consent_enabled_at_checkout has been added to the Shop object in the REST...

GraphQL and REST Admin APIs now include merchantOfRecordApp and merchant_of_record_app_id fields in the Order object, providing Merchant of Record app details for supported applications.

GraphQL Admin API 2022-10 adds Subscription Billing Cycles, allowing order changes without affecting contracts, skipping orders, and combining orders to save shipping costs.

APIs now redact customer data by default. Access requires approval via Partner Dashboard. Apps must meet data protection requirements, including consent and encryption.

As of 2022-10, Location resources support metafields. Use metafields APIs to store additional information in metafield values, like store hours, and then reference them in Liquid.

To learn more...

GraphQL Admin API 2022-10 adds market and multi-currency support for draft orders, enabling region-specific settings and multi-currency payment flows with new query fields.

The Fulfillment API's cancel endpoint is now deprecated. Migrate to Fulfillment Orders by the 2023-04 release. A migration guide is available for assistance.

Added selected_delivery_option to CartDeliveryGroup and handle to CartDeliveryOption. New mutation cartSelectedDeliveryOptionsUpdate updates delivery options per group.

As of GraphQL Admin API version 2022-10, you can now use marketingActivityCreateExternal and marketingActivityUpdateExternal mutations to create and manage marketing activities, without the...

As of GraphQL Admin API version 2022-10, you can use the new manualHoldsFulfillmentOrders connection to fetch all the manually held fulfillment orders for a shop. Fulfillment orders can also be...

The 2022-10 Admin GraphQL API adds contextualPricing to fetch prices for a CompanyLocation using companyLocationId on Product and ProductVariant.

GraphQL Admin API v2022-10 adds fields and mutations for draft orders: duplicate, create from orders, bulk tag operations, delete, reserve inventory, and access hidden fields.

As of GraphQL Admin API version 2022-10, you can use the purchasing entity input field to create and update B2B draft orders.

This will attach company, location and contact to the draft order....

GraphQL APIs now support a references connection on metafield for list reference types, enabling paginated access to underlying resources. Available in unstable, releasing 2022-10.

As of GraphQL Admin API version 2022-10, we are adding queries, objects, and mutations to introspect and manage B2B primitives notably Companies, Company Locations, and Company Contacts with...

Storefront API now supports attaching shipping address preferences to guest carts via deliveryAddressPreferences in CartBuyerIdentity and CartBuyerIdentityInput objects.

As of 2022-10, partners can manage subscription delivery with new Local Delivery and Pickup options. Update API usage to handle these methods and revise delivery terminology accordingly.

As of 2022-10 you can now add, remove and view MarketWebPresence associated with a Locale through the ShopLocale GraphQL endpoints.

Learn more about...

GraphQL Admin API now supports Local Pickup management with new mutations to enable/disable and a field to access settings, enhancing location-based pickup configuration.

As of GraphQL API 2022-10, two new metafield definition types are available:

• collection_reference: A reference to a collection on the online store.
• list.collection_reference: A list...

As of Shopify CLI version 3.13.0, you can now preview theme app extensions by running the dev command. Shopify CLI supports hot...

The Product Recommendations API now supports an intent parameter for showing related or complementary products, enhancing theme developers' control over product suggestions.

We've added a new Rails association to Product and use it in the Product GraphQL, so that the database queries use an indexed access path, rather than doing a full table search as is being done...

New GraphQL Admin API 2022-10 endpoints enable custom market-specific content, including non-language-based types like money content. Key queries: marketLocalizableResource(s), marketLocalizationsRegister.

Authenticated access now supports Storefront API requests from servers, enhancing throughput and enabling effective bot protection compared to public tokens.

Shopify admin moves to admin.shopify.com. Update embedded apps to App Bridge 3.0 and adjust content security policy to ensure compatibility and optimal merchant experience.

New fields added to app listings; developers must update forms by Nov 1 for the new app listing page.

Starting November, app categories will be simplified for better merchant discovery, allowing developers to categorize their own apps.

As of ** 2023-01 ** version on the Admin GraphQL schema, you can use the DelegateAccessTokenDestroy mutation to delete the delegate tokens created by the API client.

For app architectures that...

As of 2022-10 the marketWebPresenceUpdate endpoint now supports adding unpublished locales as alternateLocales.

Learn more about...

As of the 2022-10 release of the Storefront API, you can now query a shop's brand settings and assets via the new Shop.brand field. ...

From October 3, Plus Merchants must use the Web Pixel Extension for checkout customization, enhancing pixel placement, data accuracy, and privacy compliance.

Icons added to your app using the Partner Dashvoard App setup page now must be 1200 px by 1200 px in size. This change makes icon sizes consistent across the Partner Dashboard, the Shopify App...

The Money scalar is removed from the Storefront API. Use MoneyV2 for all monetary fields. V2 suffixed fields are deprecated, enhancing API consistency and reducing confusion.

Shopify now supports automatically optimizing storefront images using the AV1 Image File Format (AVIF) format, which improves performance by reducing delivered bytes. Optimization occurs on a per...

App creation now auto-generates URL placeholders, simplifying setup. New Insights section added for easy access to app history and API health, enhancing developer efficiency.

Translations API now supports SellingPlanGroup and SellingPlan fields as translatable resources, impacting delivery frequency options and descriptions until the 2022-10 API release.

Shopify updated the Partner Program Agreement, requiring apps to be installed via Shopify surfaces. Developers should review the new terms effective August 3, 2022.

As of today, theme app extensions are be able to store translations up to 15 KB per locale file.

For more information about file and content size limits for theme app extensions, refer to the...

You may now see new error values and descriptions if you encounter a Braintree payment method being revoked when associating Braintree payment methods with the customers that you import into...

As of the API version 2022-10, upon deleting a reference type metafield definition with delete_all_associated_metafields argument set to false, REFERENCE_TYPE_DELETION_ERROR will be returned...

New TaxExemption enum values: US reseller exemptions for state tax and EU reverse charge for VAT exclusion, aiding B2B transactions.

Shopify's GitHub app now requests write permissions for GitHub Actions, enabling on-demand redeploys and automatic branch deployments for Hydrogen storefronts on Oxygen.

The customer ID for logged in customers is now included as a parameter in the forwarded query for app proxy requests. The customer ID is passed...

Migration deadline for 2022-04 API extended to June 30, 2023. Fulfillment API endpoints deprecated; switch to Fulfillment Orders API by 2023-07. Migration guide available.

From API v2022-07, GraphQL schemas use "@deprecated" for deprecated fields. Ensure your client supports this. Older versions use descriptions for deprecation warnings.

As of GraphQL Admin API version 2022-07, a new statistics field has been added to the Customer object for computed customer statistics. It includes a new field predictedSpendTier which...