---
title: >-
  Add and remove customers from an order with GraphQL - 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-number-and-customer-graphql-update
  md: >-
    https://shopify.dev/changelog/posts/orders-number-and-customer-graphql-update.md
metadata:
  effectiveApiVersion: 2025-07
  affectedApi:
    - displayName: Admin GraphQL API
      handle: admin-graphql
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: New
    handle: new
  indicatesActionRequired: false
  createdAt: '2025-04-01T14:30:32-04:00'
  postedAt: '2025-05-23T12:00:00-04:00'
  updatedAt: '2025-05-21T15:51:42-04:00'
  effectiveAt: '2025-04-02T12:00:00-04:00'
---

May 23, 2025

# Add and remove customers from an order with GraphQL

DateMay 23, 2025

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

FlagsNew

SurfacesAPI

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

The Admin GraphQL API now includes `orderCustomerRemove` (to [remove a customer from an order](https://shopify.dev/docs/api/admin-graphql/2025-07/mutations/ordercustomerremove)) and `orderCustomerSet` (to [add a customer to an order](https://shopify.dev/docs/api/admin-graphql/2025-07/mutations/orderCustomerSet)) mutations, making it easier to manage orders and customers. The `orderCustomerRemove` mutation covers the same use case as setting [`order.customer: null` in the REST API](https://shopify.dev/docs/api/admin-rest/unstable/resources/order#put-orders-order-id), while `orderCustomerSet` is all-new functionality not previously possible in GraphQL or REST.

We've also added an `Order.number` [field](https://shopify.dev/docs/api/admin-graphql/2025-07/queries/order), equivalent to the [`order_number` REST field](https://shopify.dev/docs/api/admin-rest/unstable/resources/order#post-orders).