Skip to main content

Securing your app, together

Act now to secure your app: We're asking every app dev to act this week. We have new tools to help, including AI security scans, expiring tokens, and better log filtering. Read on to learn how.
Read the full story
Changelog

Surfaces & APIs

Versions

Change type

  1. July 2025

    Surface
    1. Order cancellation now supports refunds to store credit
      DeprecatedGraphQL Admin API
    2. Customer Account API now includes subscription discount data
      Customer Account API
    3. New warning DraftOrderMarketRegionCountryCodeNotSupportedWarning added to DraftOrder
      GraphQL Admin API
    4. Add created/updated at time based filters for an order's fulfillments
      GraphQL Admin API
    5. New field for discount classes on DraftOrderPlatformDiscount
      Action requiredGraphQL Admin API
    6. New range fields available for segment filters in GraphQL Admin API
      GraphQL Admin API
    7. New AppUninstall mutation to allow apps to uninstall themselves.
      GraphQL Admin API
    8. Remove unprocessed exchange lines from a return
      GraphQL Admin API
    9. New GraphQL fields for return management
      GraphQL Admin API
    10. Returns Processing APIs replaces Return Refund APIs
      Breaking changesGraphQL Admin API
  2. June 2025

    Surface
    1. Increase draft order line item limit from 250 to 499
      GraphQL Admin API
    2. New estimatedShippedAt argument added to FulfillmentOrderAcceptFulfillmentRequest mutation
      GraphQL Admin API
    3. Add shop_id to app/scopes_update webhook payload
      Events & webhooks
    4. Optional groupObjects argument in bulk operations mutations that offers faster and more reliable job execution
      GraphQL Admin API
    5. Standardized target and operation names across Function APIs
      Functions
    6. Shop metafield definitions are now available in the Shopify Admin and Admin API
      GraphQL Admin API
    7. Use cart.deliveryGroups.groupType in Function APIs to determine the type of delivery group
      Functions
    8. Cart metafields are accessible in Shopify Functions and Checkout UI extensions
      Functions
    9. Define payment terms conditionally at checkout
      Functions
    10. productCreate surfaces input errors as userErrors
      Breaking changesGraphQL Admin API
    11. New fields for OrderTransaction and OrderCreateManualPayment
      GraphQL Admin API
  3. May 2025

    Surface
    1. Add and remove customers from an order with GraphQL
      GraphQL Admin API
    2. The Storefront API's Cart object now exposes warnings for non-applicable discount codes
      Storefront API
    3. Deprecation of legacy return APIs and improvements to return management
      Breaking changesGraphQL Admin API
    4. Filter articles by title
      GraphQL Admin API
    5. Early access: Declarative Custom Data Definitions
      Tools
    6. Uncapped counts in GraphQL
      Breaking changesGraphQL Admin API
    7. POS-specific Shopify Function logic
      Functions
    8. New GraphQL API for Draft Order Delivery Options for Developers
      GraphQL Admin API
    9. New Storefront API CartErrorCode: BUYER_CANNOT_PURCHASE_FOR_COMPANY_LOCATION
      Storefront API
    10. New filter options added to orders connection in Customer Account API
      Customer Account API
    11. The UnitPriceMeasurementMeasuredUnit enum now includes imperial units and counts
      Breaking changesGraphQL Admin API
    12. Shop Component: Shop Pay Payment Request Receipt queries
      GraphQL Admin API
    13. Deprecation of draftOrderCreateMerchantCheckout mutation
      DeprecatedGraphQL Admin API
  4. April 2025

    Surface
    1. Display modals after purchase
      Payments Apps API
    2. Change in productSet mutation error code for suspended product
      Breaking changesGraphQL Admin API
    3. Adding publicDisplayName field on ShopPlan
      GraphQL Admin API
    4. Create smart collections automatically with PRODUCT_CATEGORY_ID_WITH_DESCENDANTS
      GraphQL Admin API
    5. Session creation payloads now include ISO 3166-2 province codes
      Payments Apps API
    6. Support for card not present transaction details in PaymentsApps API
      Payments Apps API
    7. draftOrderCount available in 2025-07
      GraphQL Admin API
  5. March 2025

    Surface
    1. Storefront API Cart now exposes selling plan errors
      Storefront API
    2. New additions to delivery promise participants APIs
      GraphQL Admin API
    3. FeeSale fee field is nullable as of 2025-07
      Breaking changesGraphQL Admin API
  6. February 2025

    Surface
    1. Metafield description input field removal
      Breaking changesGraphQL Admin API
  7. December 2024

    Surface
    1. Deprecated SubscriptionMailingAddress in favor of MailingAddress
      Breaking changesGraphQL Admin API