---
title: >-
  Removal of deprecated Shop.draftOrders connection in the GraphQL Admin 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/removal-of-deprecated-shopdraftorders-connection-in-admin-graphql-api
  md: >-
    https://shopify.dev/changelog/removal-of-deprecated-shopdraftorders-connection-in-admin-graphql-api.md
metadata:
  effectiveApiVersion: 2026-01
  affectedApi:
    - displayName: Admin GraphQL API
      handle: admin-graphql
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: Breaking API Change
    handle: breaking-api-change
  indicatesActionRequired: true
  createdAt: '2025-09-08T14:11:51-04:00'
  postedAt: '2025-09-26T12:00:00-04:00'
  updatedAt: '2025-10-06T19:03:02-04:00'
  effectiveAt: '2025-09-09T12:00:00-04:00'
---

September 26, 2025

Tags:

* Action Required
* Admin GraphQL API
* 2026-01

# Removal of deprecated `Shop.draftOrders` connection in the GraphQL Admin API

We are removing the `Shop.draftOrders` connection, which has already been deprecated for some time. This change is part of our ongoing efforts to streamline and improve the API's efficiency and functionality.

**What You Need to Do**

To ensure your integrations continue to function smoothly, please update your applications to use the [`QueryRoot.draftOrders`](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/QueryRoot#field-QueryRoot.fields.draftOrders) object for retrieving multiple draft orders. If you have any questions or need assistance, please refer to our [developer documentation](https://shopify.dev/docs) or reach out to our support team.