Skip to content

Shopify Dude Fix

Shopify Draft Order Subscription Won’t Complete? Use Selling Plans and Invoice Checkout in 2027-01

Shopify API 2027-01 supports selling plans on draft-order variant lines, but draftOrderComplete still fails. Use invoice checkout and test the subscription contract.

Quick answer: In Admin GraphQL API 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.

Common misunderstanding: Adding a selling plan to a draft is not the same as creating a subscription contract. The contract is created when the customer pays through the supported invoice checkout path.

How to test this

  1. On a development store, choose an eligible variant and recurring or prepaid plan; create a draft using API 2027-01.
  2. Read the saved and calculated sellingPlanApplication; confirm the expected plan ID and pricing.
  3. Send the draft invoice and complete the checkout in a controlled test; verify the resulting order and subscription contract.
  4. 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.
  5. Reject unsupported B2B, custom-line, fixed-billing, and price-override combinations before presenting the option to staff.