2027-01, draft-order variant lines can carry sellingPlanId. But a draft containing a selling plan cannot be completed with draftOrderComplete. Send an invoice with draftOrderInvoiceSend and let the customer complete checkout; Shopify creates the order and subscription contract through that flow.On this page
What changed in October 2026
Older draft-order integrations commonly assume every draft can be converted to an order through the same admin-side completion mutation. Shopify announced selling-plan support for draft orders on October 28, 2026 for API version 2027-01. That support is real, but it does not make every draft completion path subscription-aware.
The new DraftOrderLineItemInput.sellingPlanId works with draftOrderCalculate, draftOrderCreate, and draftOrderUpdate. The saved DraftOrderLineItem.sellingPlanApplication and calculated line equivalent let you read the applied plan back. The app needs write_draft_orders and API version 2027-01 or later.
Create a draft with an actual variant and plan
Use a product variant ID that supports the intended selling plan, not a custom line item. The following example uses placeholder GIDs; replace both with IDs from the same store.
mutation CreateSubscriptionDraft($input: DraftOrderInput!) {
draftOrderCreate(input: $input) {
draftOrder {
id
lineItems(first: 10) {
nodes {
sellingPlanApplication { sellingPlanId name }
}
}
}
userErrors { field message }
}
}
{
"input": {
"lineItems": [{
"variantId": "gid://shopify/ProductVariant/123",
"quantity": 1,
"sellingPlanId": "gid://shopify/SellingPlan/456"
}]
}
}
Read back sellingPlanApplication rather than assuming a successful draft mutation guarantees the plan is attached. For price previews, use draftOrderCalculate and inspect the calculated selling-plan application before creating the draft.
Why draftOrderComplete fails
Shopify explicitly says draftOrderComplete returns a user error and creates no order for drafts with selling-plan lines. The supported customer-facing path is draftOrderInvoiceSend followed by invoice checkout. Design your internal order-management workflow around that distinction; do not retry the completion mutation or silently remove the selling plan to force an order through.
Limitations that affect real integrations
Only recurring and prepaid subscription plans are supported. Fixed-billing plans, including preorders and try-before-you-buy, are not. B2B draft orders, custom line items with plans, and price overrides on selling-plan lines are also unsupported. A B2B ERP that sends every order through drafts cannot simply append a selling plan ID and expect subscription checkout to work.
How to test this
- On a development store, choose an eligible variant and recurring or prepaid plan; create a draft using API 2027-01.
- Read the saved and calculated sellingPlanApplication; confirm the expected plan ID and pricing.
- Send the draft invoice and complete the checkout in a controlled test; verify the resulting order and subscription contract.
- In a separate test, call draftOrderComplete on a selling-plan draft and confirm your integration handles the documented user error without creating a duplicate order.
- Reject unsupported B2B, custom-line, fixed-billing, and price-override combinations before presenting the option to staff.

