--- title: SellingPlanGroup - GraphQL Admin description: |- Represents a selling method (for example, "Subscribe and save" or "Pre-paid"). Selling plan groups and associated records (selling plans and policies) are deleted 48 hours after a merchant uninstalls their subscriptions app. We recommend backing up these records if you need to restore them later. api_version: 2025-10 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. Represents a selling method (for example, "Subscribe and save" or "Pre-paid"). Selling plan groups and associated records (selling plans and policies) are deleted 48 hours after a merchant uninstalls their subscriptions app. We recommend backing up these records if you need to restore them later. ## Fields * app​Id [String](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String) The ID for app, exposed in Liquid and product JSON. * applies​To​Product [Boolean!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/Boolean) non-null Whether the given product is directly associated to the selling plan group. * product​Id [ID!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/ID) required ### Arguments The ID of the product. *** * applies​To​Product​Variant [Boolean!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/Boolean) non-null Whether the given product variant is directly associated to the selling plan group. * product​Variant​Id [ID!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/ID) required ### Arguments The ID of the product. *** * applies​To​Product​Variants [Boolean!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/Boolean) non-null Whether any of the product variants of the given product are associated to the selling plan group. * product​Id [ID!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/ID) required ### Arguments The ID of the product. *** * created​At [Date​Time!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/DateTime) non-null The date and time when the selling plan group was created. * description [String](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String) The merchant-facing description of the selling plan group. * id [ID!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/ID) non-null A globally-unique ID. * merchant​Code [String!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String) non-null The merchant-facing label of the selling plan group. * name [String!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String) non-null The buyer-facing label of the selling plan group. * options [\[String!\]!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String) non-null The values of all options available on the selling plan group. Selling plans are grouped together in Liquid when they're created by the same app, and have the same `selling_plan_group.name` and `selling_plan_group.options` values. * position [Int](https://shopify.dev/docs/api/admin-graphql/latest/scalars/Int) The relative position of the selling plan group for display. * products [Product​Connection!](https://shopify.dev/docs/api/admin-graphql/latest/connections/ProductConnection) non-null Products associated to the selling plan group. * products​Count [Count](https://shopify.dev/docs/api/admin-graphql/latest/objects/Count) A count of products associated to the selling plan group. * product​Variants [Product​Variant​Connection!](https://shopify.dev/docs/api/admin-graphql/latest/connections/ProductVariantConnection) non-null Product variants associated to the selling plan group. * product​Variants​Count [Count](https://shopify.dev/docs/api/admin-graphql/latest/objects/Count) A count of product variants associated to the selling plan group. * selling​Plans [Selling​Plan​Connection!](https://shopify.dev/docs/api/admin-graphql/latest/connections/SellingPlanConnection) non-null Selling plans associated to the selling plan group. * summary [String](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String) A summary of the policies associated to the selling plan group. * translations [\[Translation!\]!](https://shopify.dev/docs/api/admin-graphql/latest/objects/Translation) non-null The published translations associated with the resource. *** ## 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 * [selling​Plan​Group](https://shopify.dev/docs/api/admin-graphql/latest/queries/sellingPlanGroup) query Returns a `SellingPlanGroup` resource by ID. * [selling​Plan​Groups](https://shopify.dev/docs/api/admin-graphql/latest/queries/sellingPlanGroups) query List Selling Plan Groups. *** ## \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/SellingPlanGroupConnection) *** ## Mutations * [selling​Plan​Group​Add​Products](https://shopify.dev/docs/api/admin-graphql/latest/mutations/sellingPlanGroupAddProducts) mutation Adds multiple products to a selling plan group. * [selling​Plan​Group​Add​Product​Variants](https://shopify.dev/docs/api/admin-graphql/latest/mutations/sellingPlanGroupAddProductVariants) mutation Adds multiple product variants to a selling plan group. * [selling​Plan​Group​Create](https://shopify.dev/docs/api/admin-graphql/latest/mutations/sellingPlanGroupCreate) mutation Creates a Selling Plan Group. * [selling​Plan​Group​Update](https://shopify.dev/docs/api/admin-graphql/latest/mutations/sellingPlanGroupUpdate) mutation Update a Selling Plan Group. *** ## <\~> 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 * * [Has​Published​Translations](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/HasPublishedTranslations) interface * [Node](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Node) interface *** ## ||-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)