Call the `sellingPlanGroupCreate` Admin GraphQL mutation, providing a `name`, `merchantCode` (a unique internal identifier), and an array of `sellingPlans` — each defining `name`, `billingPolicy`, `deliveryPolicy`, and `pricingPolicies`.
For the billing policy, specify the billing interval type (e.g., month) and interval count (e.g., 1 for monthly) and choose between `RECURRING` or `FIXED` billing policy types.
For the pricing policy, define either a fixed price adjustment or a percentage-off adjustment applied on top of the product's compare-at or base price.
After creating the group, associate it with specific product variants using the `sellingPlanGroupAddProductVariants` mutation, providing the selling plan group ID and variant IDs.
Verify the selling plan group appears on the variant in the Shopify admin and is queryable via the Storefront API `sellingPlanGroups` connection on the product object.
To update a selling plan group, use the `sellingPlanGroupUpdate` mutation — changes to pricing policies may affect existing subscription contracts that reference those selling plans, so test on a dev store first.
Known gotchas
Selling plans define the terms that subscription contracts are created against. If you update or delete a selling plan that active subscription contracts reference, those contracts may become orphaned or fail to bill correctly. Treat selling plan changes as schema migrations.
The Storefront API exposes selling plans so buyers can select subscription options on product pages. The plan name and description fields are buyer-facing — write clear, localized copy in these fields, not internal codes.
A product variant must be explicitly added to a selling plan group — creating the group alone does not associate it with any products. The association step is separate and easy to omit.
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp