---
title: >-
  Storefront API Cart now exposes selling plan errors - Shopify developer
  changelog
description: >-
  Shopify’s developer changelog documents all changes to Shopify’s platform.
  Find the latest news and learn about new platform opportunities.
source_url:
  html: >-
    https://shopify.dev/changelog/storefront-api-cart-exposes-selling-plan-errors
  md: >-
    https://shopify.dev/changelog/storefront-api-cart-exposes-selling-plan-errors.md
metadata:
  effectiveApiVersion: 2025-07
  affectedApi:
    - displayName: Storefront GraphQL API
      handle: storefront-graphql
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: New
    handle: new
  indicatesActionRequired: false
  createdAt: '2025-03-26T04:52:08-04:00'
  postedAt: '2025-03-31T12:00:00-04:00'
  updatedAt: '2025-03-27T10:03:51-04:00'
  effectiveAt: '2025-03-27T12:00:00-04:00'
---

March 31, 2025

Tags:

* Storefront GraphQL API
* 2025-07

# Storefront API Cart now exposes selling plan errors

As of version 2025-07 of the GraphQL Storefront API, enhanced error handling for selling plans is introduced. The Cart mutations now expose specific user errors for scenarios involving selling plans:

* `VARIANT_REQUIRES_SELLING_PLAN`: The error is returned when a merchandise added to the cart requires a selling plan, but none is provided.
* `SELLING_PLAN_NOT_APPLICABLE`: The error is returned when a selling plan is added to a merchandise in the cart but is not applicable.