---
title: SellingPlan - GraphQL Admin
description: >-
  How a product can be sold and purchased through recurring billing or deferred
  purchase options. Defines the specific terms for subscriptions, pre-orders, or
  try-before-you-buy offers, including when to bill customers, when to fulfill
  orders, and what pricing adjustments to apply.


  Each selling plan has billing, delivery, and pricing policies that control the
  purchase experience. The plan's
  [`options`](https://shopify.dev/docs/api/admin-graphql/latest/objects/SellingPlan#field-SellingPlan.fields.options)
  and
  [`category`](https://shopify.dev/docs/api/admin-graphql/latest/objects/SellingPlan#field-SellingPlan.fields.category)
  help merchants organize and report on different selling strategies. Plans are
  grouped within a
  [`SellingPlanGroup`](https://shopify.dev/docs/api/admin-graphql/latest/objects/SellingPlanGroup)
  that associates them with
  [`Product`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Product)
  and
  [`ProductVariant`](https://shopify.dev/docs/api/admin-graphql/latest/objects/ProductVariant)
  objects.


  > Caution:

  > Selling plans and associated records are automatically deleted 48 hours
  after a merchant uninstalls the
  [`App`](https://shopify.dev/docs/api/admin-graphql/latest/objects/App) that
  created them. Back up these records if you need to restore them later.


  Learn more about [selling
  plans](https://shopify.dev/docs/apps/build/purchase-options/subscriptions/selling-plans/build-a-selling-plan).
api_version: 2026-01
api_name: admin
type: object
api_type: graphql
source_url:
  html: 'https://shopify.dev/docs/api/admin-graphql/latest/objects/SellingPlan'
  md: 'https://shopify.dev/docs/api/admin-graphql/latest/objects/SellingPlan.md'
---

# Selling​Plan

object

Requires `read_products` access scope.

How a product can be sold and purchased through recurring billing or deferred purchase options. Defines the specific terms for subscriptions, pre-orders, or try-before-you-buy offers, including when to bill customers, when to fulfill orders, and what pricing adjustments to apply.

Each selling plan has billing, delivery, and pricing policies that control the purchase experience. The plan's [`options`](https://shopify.dev/docs/api/admin-graphql/latest/objects/SellingPlan#field-SellingPlan.fields.options) and [`category`](https://shopify.dev/docs/api/admin-graphql/latest/objects/SellingPlan#field-SellingPlan.fields.category) help merchants organize and report on different selling strategies. Plans are grouped within a [`SellingPlanGroup`](https://shopify.dev/docs/api/admin-graphql/latest/objects/SellingPlanGroup) that associates them with [`Product`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Product) and [`ProductVariant`](https://shopify.dev/docs/api/admin-graphql/latest/objects/ProductVariant) objects.

***

Caution

Selling plans and associated records are automatically deleted 48 hours after a merchant uninstalls the [`App`](https://shopify.dev/docs/api/admin-graphql/latest/objects/App) that created them. Back up these records if you need to restore them later.

***

Learn more about [selling plans](https://shopify.dev/docs/apps/build/purchase-options/subscriptions/selling-plans/build-a-selling-plan).

## Fields

* billingPolicy
* category
* createdAt
* deliveryPolicy
* description
* id
* inventoryPolicy
* metafield
* metafields
* name
* options
* position
* pricingPolicies
* translations
* metafieldDefinitions: deprecated

***

## Map

### Fields and connections with this object

* [SellingPlanConnection.nodes](https://shopify.dev/docs/api/admin-graphql/latest/connections/SellingPlanConnection#returns-nodes)
* [SellingPlanEdge.node](https://shopify.dev/docs/api/admin-graphql/latest/objects/SellingPlanEdge#field-SellingPlanEdge.fields.node)
* [SellingPlanGroup.sellingPlans](https://shopify.dev/docs/api/admin-graphql/latest/objects/SellingPlanGroup#field-SellingPlanGroup.fields.sellingPlans)

***

## Interfaces

* HasMetafieldDefinitions
* HasMetafields
* HasPublishedTranslations
* Node

***

## SellingPlan Implements

### Implements

* [Has​Metafield​Definitions](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/HasMetafieldDefinitions)
* [Has​Metafields](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/HasMetafields)
* [Has​Published​Translations](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/HasPublishedTranslations)
* [Node](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Node)