---
title: Order Update Phone Field Public - 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/order-update-phone-field-public'
  md: 'https://shopify.dev/changelog/order-update-phone-field-public.md'
metadata:
  effectiveApiVersion: 2026-01
  affectedApi:
    - displayName: Admin GraphQL API
      handle: admin-graphql
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: New
    handle: new
  indicatesActionRequired: false
  createdAt: '2025-10-15T18:28:00-04:00'
  postedAt: '2025-11-01T00:00:00-04:00'
  updatedAt: '2025-10-15T19:30:49-04:00'
  effectiveAt: '2025-11-01T00:00:00-04:00'
---

November 1, 2025

Tags:

* Admin GraphQL API
* 2026-01

# Order Update Phone Field Public

As of Admin API 2026-01, the `phone` field is now publicly available in the [orderUpdate](https://shopify.dev/docs/api/admin-graphql/latest/mutations/orderUpdate) mutation's [OrderInput](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/OrderInput). This field allows developers to update the customer phone number for an order, overwriting the existing phone number.

This change brings parity with the REST API, which already supports updating the phone field through the [Order resource](https://shopify.dev/docs/api/admin-rest/latest/resources/order#put-orders-order-id). The phone field is particularly useful for maintaining accurate customer contact information, especially for SMS notifications and order-related communications.

For implementation details, refer to the [orderUpdate mutation documentation](https://shopify.dev/docs/api/admin-graphql/latest/mutations/orderUpdate).
