Create and manage Shopify selling plan groups and selling plans for subscription products via the Admin GraphQL API

In-depth guide

Steps

1. Create a selling plan group with the sellingPlanGroupCreate Admin GraphQL mutation, providing name, merchantCode, options (e.g., ['Delivery every']), and a sellingPlans array with billingPolicy (recurringBillingPolicy: interval and intervalCount), deliveryPolicy, and pricingPolicies
2. Associate the selling plan group with products or variants using sellingPlanGroupAddProducts or sellingPlanGroupAddProductVariants mutations, passing the selling plan group GID and an array of product or variant GIDs
3. On the storefront, query sellingPlanGroups on the product object via the Storefront API to retrieve available plans with their IDs and human-readable options
4. When adding to cart, include sellingPlanId in the cartLinesAdd mutation (Storefront API) alongside the merchandiseId to create a subscription line item
5. Read back subscription contracts created by Shopify via GET /admin/api/2025-07/subscription_contracts.json (REST) or the subscriptionContracts query (GraphQL Admin API) after purchase
6. Update a subscription contract's billing interval with subscriptionContractUpdate mutation and commit with subscriptionContractCommit mutation