Developer changelog

As of GraphQL Admin API version 2024-10, the CustomerPaymentMethodRevocationReason object has a new enum value: FAILED_TO_RETRIEVE_BILLING_ADDRESS. This value is assigned when a customer payment...

As of 2024-10, deprecated image mutations are removed from the GraphQL API. Use productCreateMedia, productDeleteMedia, productUpdateMedia, and productReorderMedia instead.

Admin API v2024-10 adds created_fulfillment_hold to fulfillment_orders/placed_on_hold webhook, ensuring visibility of created holds even if released or deleted.

Webhook API 2024-10 adds app/scopes_update topic, notifying apps of changes in granted access scopes, aiding in tracking installation permissions.

In API v2024-10, inventory errors move from userErrors to warnings with codes for stock issues. Use warnings to manage cart items or inform buyers of changes.

Subscription Status updates can now be run with the bulkOperationRunMutation.

The following mutations have been added:

• subscriptionContractActivate
• subscriptionContractCancel *...

As of 2024-10, query events via eventsCount, event, and events. events connection added to multiple types. CommentEvent.subject is now nullable; deletionEvents deprecated.

In the 2024-10 Admin GraphQL API, ProductInput is split into ProductCreateInput and ProductUpdateInput. productCreate and productUpdate now use a new product argument.

Version 2024-10 of the Admin GraphQL API allows reading/modifying Pages, Articles, Blogs, and Comments with new types and queries, enhancing content management for developers.

App Store ads on the Shopify App Store now support targeting tag-level category pages, in addition to main and sub-category pages. For more information on App Store category page types, [see...

Specifying grants for specific apps on app-owned metafields is now deprecated. New apps will not be able...

Added API resource for local payment methods payment details, enhancing transaction data access for developers.

New "SubscriptionBillingAttempt" resource logs billing attempts with idempotency keys to avoid duplicates, creating orders on success. No impact on existing partners.

New resource logs each subscription billing attempt, using idempotency keys to prevent duplicate orders. Successful attempts create orders, no impact on existing partners.

API v2024-10 introduces admin API for Online Store Themes, matching REST API features. New queries and mutations enhance theme and file management, boosting efficiency for developers.

As of 2025-01, the default value for the permitsSkuSharing argument in the fulfillmentServiceCreate mutation has been updated to true.

Please be aware that this argument is deprecated and...

API version 2024-10 introduces metafield definition management via Admin API, allowing developers to enable, disable, and query metafield capabilities for enhanced Shopify integration.

API v2024-10 introduces the Metafield Definition Capability Framework, replacing use_as_collection_condition with smart_collection_condition for better flexibility and extensibility.

GraphQL API v2024-10 introduces ProductSetInventoryInput for setting available or on_hand quantities in ProductSet and ProductSetVariant mutations, enhancing inventory management.

Shopify CLI update: Instant dev server startup, no Ruby dependency, unified TypeScript commands, and headless Liquid console for streamlined theme development.

Added shop_name and shop_url to theme install events for better merchant insights. Implemented Google e-commerce events for enhanced tracking and precise data analysis in Shopify Theme Store.

As of Shopify CLI 3.67 and Javy 3.1, Shopify Functions built in JavaScript can see improved performance by as much as 40% when combined with [@shopify/shopify_function...

New parameters shop_name and shop_url added for app install events in Shopify, plus Google e-commerce events for better tracking and data analysis on app listing pages.

The quantityAvailable and availableForSale fields will now reflect country-specific inventory availability, scoped to the specified market country of the Product Feed. The Fulfillable Inventory...

Post-purchase upsell offers increased from 2 to 3, boosting order value potential. Review custom code for optimal buyer experience.

GraphQL Admin API 2024-10: GiftCard endpoints open to all; new GiftCardTransaction types. Rename giftCardDisable to giftCardDeactivate. Add recipientAttributes and transaction fields.

As of the Admin API version 2024-10, the fulfillmentOrdersReleaseHolds mutation has been deprecated.

...

As of Admin GraphQL API version 2024-10, you can access QueryRoot.urlRedirectsCount field to retrieve the count of redirects.

Learn more about urlRedirectsCount on...

As of the 2024-10 version of the GraphQL Admin API, the products query filter has been expanded to allow filtering on additional attributes: publication_ids, variant_id and...

Several fields deprecated from Abandoned Checkout REST API; switch to new GraphQL API by 2024-10 for continued support.

GraphQL Admin API 2024-10 adds id to FulfillmentHold and optional holdIds to fulfillmentOrderReleaseHold mutation, allowing precise hold releases by ID.

As of Admin GraphQL API version 2024-10, you can access Order.statusPageUrl field to retrieve the URL where the customer can check the order's current status.

Learn more about Order on...

From Sept 12, 2024, CustomerConsentCollectedFrom returns SHOPIFY for SMS consent in Shopify Checkout, affecting 1st party and UI extensions; other flows remain unchanged.

Hydrogen v2024.7.5 enhances sitemaps, search, cart gift cards, and security. Fixes redirects and mobile links. Adds privacy utilities. Optimizes cart totals.

API v2024-10 introduces PRODUCT_CATEGORY_ID in CollectionRuleColumn for smart collections, replacing deprecated PRODUCT_TAXONOMY_NODE_ID. Update implementations for enhanced functionality.

Webhooks retry 8 times over 4 hours with exponential backoff. Original payloads are used; check timestamps for staleness. Address updates won't affect retries. Improves delivery reliability.

Static app navigation for admin apps is deprecated. Use App Bridge components for navigation. Delete existing menus via Partners dashboard by Dec 2024; auto-removal by Dec 2026.

As of 2024-10, we're deprecating fulfillmentCreateV2 and fulfillmentTrackingInfoUpdateV2. Instead, please use fulfillmentCreate and fulfillmentTrackingInfoUpdate.

Note that the...

The 2024-10 Admin REST API requires the read_locations scope to access the location resource. Without it, a 403 Forbidden error occurs. Update your app permissions accordingly.

To help merchants discover the freshest and most well-integrated themes for their store, we've shipped an update to the Theme Store homepage to highlight Top and New themes (published in the last...

GraphQL Storefront API 2024-10 now supports retrieving product taxonomy categories, enhancing storefront customization. Available via both GraphQL and Liquid APIs for improved buyer experience.

GraphQL Admin API 2024-10 adds stockAtLegacyLocation to inventoryActivate mutation, enabling inventory activation at non-SKU-sharing locations. Ensure parameter is true for such activations.

As of 2024-10, ReverseFulfillmentOrderLineItem.fulfillmentLineItem is nullable. Older API versions will error if fulfillmentLineItem is missing.

As of Admin GraphQL API version 2024-10, use Order.lineItems instead of lineItemsMutable field to get a list of the order's line items.

Learn more about Order on...

We are retroactively adding Customer, Order, Company, and Model3d graphql types to the MetafieldReference union for...

Apps must meet Level 1 Protected Customer Data Requirements to access the Customer Account GraphQL API, affecting public apps but not Hydrogen, Headless, or Custom Apps.

As of 2024-10 version, we are adding productVariantsCount field to the Admin GraphQL API.

Learn more about...

Renamed criteria, updated app distribution layout, added category-specific section, merged safety and design standards, and removed outdated app listing requirements for clarity.

• Merchants can now filter themes by 3 new features: "Quick Order List", "Sign in with Shop" & "Swatch Filters". And we have removed 3 feature filters: "Product reviews", "Event Calendar" & "Store...

The 2024-10 GraphQL Admin API release removes HAS_OPEN_TRANSFERS_ERROR and FAILED_TO_RELOCATE_OPEN_TRANSFERS from LocationDeactivateUserErrorCode. Update code to remove checks.