---
title: >-
  Add selling plans to draft order line items with the Admin GraphQL API -
  Shopify developer changelog
description: >-
  Shopify’s developer changelog documents all changes to Shopify’s platform.
  Find the latest news and learn about new platform opportunities.
source_url:
  html: >-
    https://shopify.dev/changelog/posts/add-selling-plans-to-draft-order-line-items-with-the-admin-graphql-api
  md: >-
    https://shopify.dev/changelog/posts/add-selling-plans-to-draft-order-line-items-with-the-admin-graphql-api.md
metadata:
  effectiveApiVersion: 2027-01
  affectedApi:
    - displayName: GraphQL Admin API
      handle: admin-graphql
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: New
    handle: new
  indicatesActionRequired: false
  createdAt: '2026-10-15T13:53:48-04:00'
  postedAt: '2026-10-28T11:50:00-04:00'
  updatedAt: '2026-10-27T16:31:24-04:00'
  effectiveAt: '2027-01-01T12:00:00-05:00'
---

October 28, 2026

# Add selling plans to draft order line items with the Admin GraphQL API

DateOctober 28, 2026

Version[2027-01](https://shopify.dev/changelog?api_version=2027-01)

FlagsNew

SurfacesAPI

Affected APIs[GraphQL Admin API](https://shopify.dev/changelog?api_type=admin-graphql)

Admin GraphQL API version `2027-01` adds selling plan support to draft orders. You can now apply a selling plan to a draft order line item and read back the applied plan. These fields are additive, so no action is required to keep your app working.

## What's added

On the GraphQL Admin API, three new fields let your app work with selling plans on draft orders:

* [`DraftOrderLineItemInput.sellingPlanId`](https://shopify.dev/docs/api/admin-graphql/2027-01/input-objects/DraftOrderLineItemInput#fields-sellingPlanId) sets the selling plan to apply when you create or update a draft order line item. This input field can apply to [`draftOrderCalculate`](https://shopify.dev/docs/api/admin-graphql/2027-01/mutations/draftOrderCalculate), [`draftOrderCreate`](https://shopify.dev/docs/api/admin-graphql/2027-01/mutations/draftOrderCreate), and [`draftOrderUpdate`](https://shopify.dev/docs/api/admin-graphql/2027-01/mutations/draftOrderUpdate). Note that you can only attach selling plans to product variant line items.
* [`DraftOrderLineItem.sellingPlanApplication`](https://shopify.dev/docs/api/admin-graphql/2027-01/objects/DraftOrderLineItem#field-DraftOrderLineItem.fields.sellingPlanApplication) returns the selling plan applied to a line item on a saved draft order.
* [`CalculatedDraftOrderLineItem.sellingPlanApplication`](https://shopify.dev/docs/api/admin-graphql/2027-01/objects/CalculatedDraftOrderLineItem#field-CalculatedDraftOrderLineItem.fields.sellingPlanApplication) returns the applied selling plan on the calculated draft order, so you can preview the result before you save.

The following example applies a selling plan to a line item and reads back the applied plan:

```graphql
mutation {
  draftOrderCreate(input: {
    lineItems: [{
      variantId: "gid://shopify/ProductVariant/1",
      quantity: 1,
      sellingPlanId: "gid://shopify/SellingPlan/1"
    }]
  }) {
    draftOrder {
      lineItems(first: 1) {
        nodes {
          sellingPlanApplication { sellingPlanId name }
        }
      }
    }
    userErrors { field message }
  }
}
```

## Behavior to account for

* Only recurring and prepaid subscription plans are supported. Fixed-billing plans, such as pre-orders and try before you buy, aren't.
* B2B draft orders, custom line items, and price overrides on selling plan lines aren't supported.
* [`draftOrderComplete`](https://shopify.dev/docs/api/admin-graphql/2027-01/mutations/draftOrderInvoiceSend) is not yet supported: calling `draftOrderComplete` on a draft that has a selling plan line item returns a user error and creates no order. You can send the draft order invoice to checkout via [`draftOrderInvoiceSend`](https://shopify.dev/docs/api/admin-graphql/2027-01/mutations/draftOrderInvoiceSend).

Learn more about this change in our [product changelog](https://changelog.shopify.com/posts/subscriptions-supported-in-draft-orders) and [help docs](https://help.shopify.com/en/manual/fulfillment/managing-orders/create-orders/create-draft#add-subscriptions).