Choose a version:

LocalizedFieldPurpose

enum

The purpose of a localized field.

Anchor to Valid valuesValid values

Anchor to SHIPPINGSHIPPING: Fields that are used for shipping purposes, for example, customs clearance.
Anchor to TAXTAX: Fields that are used for taxes purposes, for example, invoicing.

Was this section helpful?

Anchor to FieldsFields

Anchor to DraftOrder.localizedFields DraftOrder.localizedFields •ARGUMENT: An order that a merchant creates on behalf of a customer. Draft orders are useful for merchants that need to do the following tasks:

Create new orders for sales made by phone, in person, by chat, or elsewhere. When a merchant accepts payment for a draft order, an order is created.

Send invoices to customers to pay with a secure checkout link.

Use custom items to represent additional costs or products that aren't displayed in a shop's inventory.

Re-create orders manually from active sales channels.

Sell products at discount or wholesale rates.

Take pre-orders.

For draft orders in multiple currencies presentment_money is the source of truth for what a customer is going to be charged and shop_money is an estimate of what the merchant might receive in their shop currency.

Caution: Only use this data if it's required for your app's functionality. Shopify will restrict access to scopes for apps that don't have a legitimate use for the associated data.

Draft orders created on or after April 1, 2025 will be automatically purged after one year of inactivity.
Anchor to HasLocalizedFields.localizedFields HasLocalizedFields.localizedFields •ARGUMENT: Localized fields associated with the specified resource.
Anchor to LocalizedField.purpose LocalizedField.purpose •OBJECT: Represents the value captured by a localized field. Localized fields are additional fields required by certain countries on international orders. For example, some countries require additional fields for customs information or tax identification numbers.
Anchor to Order.localizedFields Order.localizedFields •ARGUMENT: The Order object represents a customer's request to purchase one or more products from a store. Use the Order object to handle the complete purchase lifecycle from checkout to fulfillment.

Use the Order object when you need to:

Display order details on customer account pages or admin dashboards.

Create orders for phone sales, wholesale customers, or subscription services.

Update order information like shipping addresses, notes, or fulfillment status.

Process returns, exchanges, and partial refunds.

Generate invoices, receipts, and shipping labels.

The Order object serves as the central hub connecting customer information, product details, payment processing, and fulfillment data within the GraphQL Admin API schema.

Note
Only the last 60 days' worth of orders from a store are accessible from the Order object by default. If you want to access older records, then you need to request access to all orders. If your app is granted access, then you can add the read_all_orders, read_orders, and write_orders scopes.
Caution
Only use orders data if it's required for your app's functionality. Shopify will restrict access to scopes for apps that don't have a legitimate use for the associated data.
Learn more about building apps for orders and fulfillment.

Was this section helpful?