---
title: SellingPlanGroup - GraphQL Admin
description: >-
  A selling method that defines how products can be sold through purchase
  options like subscriptions, pre-orders, or try-before-you-buy. Groups one or
  more
  [`SellingPlan`](https://shopify.dev/docs/api/admin-graphql/latest/objects/SellingPlan)
  objects that share the same selling method and options.


  The group provides buyer-facing labels and merchant-facing descriptions for
  the selling method. Associates
  [`Product`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Product)
  and
  [`ProductVariant`](https://shopify.dev/docs/api/admin-graphql/latest/objects/ProductVariant)
  objects with selling plan groups to offer them through these purchase options.


  > Caution:

  > Selling plan groups and their 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.
api_version: 2026-01
api_name: admin
type: object
api_type: graphql
source_url:
  html: 'https://shopify.dev/docs/api/admin-graphql/latest/objects/SellingPlanGroup'
  md: >-
    https://shopify.dev/docs/api/admin-graphql/latest/objects/SellingPlanGroup.md
---

# Selling​Plan​Group

object

Requires `read_products` access scope.

A selling method that defines how products can be sold through purchase options like subscriptions, pre-orders, or try-before-you-buy. Groups one or more [`SellingPlan`](https://shopify.dev/docs/api/admin-graphql/latest/objects/SellingPlan) objects that share the same selling method and options.

The group provides buyer-facing labels and merchant-facing descriptions for the selling method. Associates [`Product`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Product) and [`ProductVariant`](https://shopify.dev/docs/api/admin-graphql/latest/objects/ProductVariant) objects with selling plan groups to offer them through these purchase options.

***

Caution

Selling plan groups and their 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.

***

## Fields

* appId
* appliesToProduct
* appliesToProductVariant
* appliesToProductVariants
* createdAt
* description
* id
* merchantCode
* name
* options
* position
* products
* productsCount
* productVariants
* productVariantsCount
* sellingPlans
* summary
* translations

***

## Map

### Fields and connections with this object

* [DeliveryProfile.sellingPlanGroups](https://shopify.dev/docs/api/admin-graphql/latest/objects/DeliveryProfile#field-DeliveryProfile.fields.sellingPlanGroups)
* [Product.sellingPlanGroups](https://shopify.dev/docs/api/admin-graphql/latest/objects/Product#field-Product.fields.sellingPlanGroups)
* [ProductVariant.sellingPlanGroups](https://shopify.dev/docs/api/admin-graphql/latest/objects/ProductVariant#field-ProductVariant.fields.sellingPlanGroups)
* [SellingPlanGroupConnection.nodes](https://shopify.dev/docs/api/admin-graphql/latest/connections/SellingPlanGroupConnection#returns-nodes)
* [SellingPlanGroupEdge.node](https://shopify.dev/docs/api/admin-graphql/latest/objects/SellingPlanGroupEdge#field-SellingPlanGroupEdge.fields.node)

***

## Queries

* sellingPlanGroup
* sellingPlanGroups

***

## SellingPlanGroup Queries

### Queried by

* [selling​Plan​Group](https://shopify.dev/docs/api/admin-graphql/latest/queries/sellingPlanGroup)
* [selling​Plan​Groups](https://shopify.dev/docs/api/admin-graphql/latest/queries/sellingPlanGroups)

***

## Mutations

* sellingPlanGroupAddProducts
* sellingPlanGroupAddProductVariants
* sellingPlanGroupCreate
* sellingPlanGroupUpdate

***

## SellingPlanGroup Mutations

### Mutated by

* [selling​Plan​Group​Add​Product​Variants](https://shopify.dev/docs/api/admin-graphql/latest/mutations/sellingPlanGroupAddProductVariants)
* [selling​Plan​Group​Add​Products](https://shopify.dev/docs/api/admin-graphql/latest/mutations/sellingPlanGroupAddProducts)
* [selling​Plan​Group​Create](https://shopify.dev/docs/api/admin-graphql/latest/mutations/sellingPlanGroupCreate)
* [selling​Plan​Group​Update](https://shopify.dev/docs/api/admin-graphql/latest/mutations/sellingPlanGroupUpdate)

***

## Interfaces

* HasPublishedTranslations
* Node

***

## SellingPlanGroup Implements

### Implements

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