---
title: >-
  Orders webhooks now include selling_plan_id on line items - 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/orders-webhooks-now-include-selling_plan_id-on-line-items
  md: >-
    https://shopify.dev/changelog/posts/orders-webhooks-now-include-selling_plan_id-on-line-items.md
metadata:
  effectiveApiVersion: 2026-10
  affectedApi:
    - displayName: Events & webhooks
      handle: webhook
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: Update
    handle: update
  indicatesActionRequired: false
  createdAt: '2026-09-09T11:51:18-04:00'
  postedAt: '2026-10-01T12:00:00-04:00'
  updatedAt: '2026-09-13T15:18:41-04:00'
  effectiveAt: '2026-09-10T12:00:00-04:00'
---

October 1, 2026

# Orders webhooks now include selling\_plan\_id on line items

DateOctober 1, 2026

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

FlagsUpdate

SurfacesAPI

Affected APIs[Events & webhooks](https://shopify.dev/changelog?api_type=webhook)

Line items in Orders webhook payloads now include a `selling_plan_id` field. This field identifies the selling plan applied to a subscription line item, which helps you avoid extra API calls to look up that information. The change applies to API version `2026-10` and later, and you don’t need to take any action to keep your app working.

Previously, if your app needed to know which selling plan applied to a subscription line item, it had to make a follow-up Admin API call for every order it received. That value now arrives directly in the webhook payload.

In Orders webhook payloads, `selling_plan_id` contains the ID of the selling plan applied to the line item. It’s `null` for line items that aren’t part of a subscription.

```json
{
  "line_items": [
    {
      "id": 123456789,
      "selling_plan_id": 987654321
    }
  ]
}
```

This example shows a line item that includes a `selling_plan_id` value for a subscription.

This change is available on API version `2026-10` and later. Earlier versions are unaffected, and no action is required.

For details on Orders webhook payloads, see the [orders webhooks reference](https://shopify.dev/docs/api/admin-rest/latest/resources/webhook#event-topics).