---
title: SellingPlanAllocation - Storefront API
description: >
  Links a
  [`ProductVariant`](/docs/api/storefront/2026-01/objects/ProductVariant) to a
  [`SellingPlan`](/docs/api/storefront/2026-01/objects/SellingPlan), providing
  the pricing details for that specific combination. Each allocation includes
  the checkout charge amount, any remaining balance due for the purchase, and up
  to two price adjustments that show how the selling plan affects the variant's
  price.


  Selling plan allocations are available on product variants and [cart
  lines](/docs/api/storefront/2026-01/objects/CartLine), enabling storefronts to
  display information such as subscription or purchase option pricing before and
  during checkout.
api_version: 2026-01
api_name: storefront
type: object
api_type: graphql
source_url:
  html: 'https://shopify.dev/docs/api/storefront/latest/objects/SellingPlanAllocation'
  md: >-
    https://shopify.dev/docs/api/storefront/latest/objects/SellingPlanAllocation.md
---

# Selling​Plan​Allocation

object

Requires `unauthenticated_read_selling_plans` access scope.

Links a [`ProductVariant`](https://shopify.dev/docs/api/storefront/2026-01/objects/ProductVariant) to a [`SellingPlan`](https://shopify.dev/docs/api/storefront/2026-01/objects/SellingPlan), providing the pricing details for that specific combination. Each allocation includes the checkout charge amount, any remaining balance due for the purchase, and up to two price adjustments that show how the selling plan affects the variant's price.

Selling plan allocations are available on product variants and [cart lines](https://shopify.dev/docs/api/storefront/2026-01/objects/CartLine), enabling storefronts to display information such as subscription or purchase option pricing before and during checkout.

## Fields

* checkout​Charge​Amount

  [Money​V2!](https://shopify.dev/docs/api/storefront/latest/objects/MoneyV2)

  non-null

  The checkout charge amount due for the purchase.

* price​Adjustments

  [\[Selling​Plan​Allocation​Price​Adjustment!\]!](https://shopify.dev/docs/api/storefront/latest/objects/SellingPlanAllocationPriceAdjustment)

  non-null

  A list of price adjustments, with a maximum of two. When there are two, the first price adjustment goes into effect at the time of purchase, while the second one starts after a certain number of orders. A price adjustment represents how a selling plan affects pricing when a variant is purchased with a selling plan. Prices display in the customer's currency if the shop is configured for it.

* remaining​Balance​Charge​Amount

  [Money​V2!](https://shopify.dev/docs/api/storefront/latest/objects/MoneyV2)

  non-null

  The remaining balance charge amount due for the purchase.

* selling​Plan

  [Selling​Plan!](https://shopify.dev/docs/api/storefront/latest/objects/SellingPlan)

  non-null

  A representation of how products and variants can be sold and purchased. For example, an individual selling plan could be '6 weeks of prepaid granola, delivered weekly'.

***

## Map

### Fields and connections with this object

* [BaseCartLine.sellingPlanAllocation](https://shopify.dev/docs/api/storefront/latest/interfaces/BaseCartLine#fields-sellingPlanAllocation)
* [CartLine.sellingPlanAllocation](https://shopify.dev/docs/api/storefront/latest/objects/CartLine#field-CartLine.fields.sellingPlanAllocation)
* [ComponentizableCartLine.sellingPlanAllocation](https://shopify.dev/docs/api/storefront/latest/objects/ComponentizableCartLine#field-ComponentizableCartLine.fields.sellingPlanAllocation)
* [ProductVariant.sellingPlanAllocations](https://shopify.dev/docs/api/storefront/latest/objects/ProductVariant#field-ProductVariant.fields.sellingPlanAllocations)
* [SellingPlanAllocationConnection.nodes](https://shopify.dev/docs/api/storefront/latest/connections/SellingPlanAllocationConnection#returns-nodes)
* [SellingPlanAllocationEdge.node](https://shopify.dev/docs/api/storefront/latest/objects/SellingPlanAllocationEdge#field-SellingPlanAllocationEdge.fields.node)