--- title: DraftOrder - GraphQL Admin description: >- 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](https://shopify.dev/api/usage/access-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. api_version: 2026-01 api_name: admin type: object api_type: graphql source_url: html: 'https://shopify.dev/docs/api/admin-graphql/latest/objects/DraftOrder' md: 'https://shopify.dev/docs/api/admin-graphql/latest/objects/DraftOrder.md' --- # Draft​Order object Requires `read_draft_orders` access scope or `read_quick_sale` access scope. 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](https://shopify.dev/api/usage/access-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. ## Fields * acceptAutomaticDiscounts * allowDiscountCodesInCheckout * allVariantPricesOverridden * anyVariantPricesOverridden * appliedDiscount * billingAddress * billingAddressMatchesShippingAddress * completedAt * createdAt * currencyCode * customAttributes * customer * defaultCursor * discountCodes * email * events * hasTimelineComment * id * invoiceEmailTemplateSubject * invoiceSentAt * invoiceUrl * legacyResourceId * lineItems * lineItemsSubtotalPrice * localizedFields * metafield * metafields * name * note2 * order * paymentTerms * phone * platformDiscounts * poNumber * presentmentCurrencyCode * purchasingEntity * ready * reserveInventoryUntil * shippingAddress * shippingLine * status * subtotalPriceSet * tags * taxesIncluded * taxExempt * taxLines * totalDiscountsSet * totalLineItemsPriceSet * totalPriceSet * totalQuantityOfLineItems * totalShippingPriceSet * totalTaxSet * totalWeight * transformerFingerprint * updatedAt * visibleToCustomer * warnings ### Deprecated fields * localizationExtensions: deprecated * marketName: deprecated * marketRegionCountryCode: deprecated * subtotalPrice: deprecated * totalPrice: deprecated * totalShippingPrice: deprecated * totalTax: deprecated *** ## Map ### Fields and connections with this object * [Company.draftOrders](https://shopify.dev/docs/api/admin-graphql/latest/objects/Company#field-Company.fields.draftOrders) * [CompanyContact.draftOrders](https://shopify.dev/docs/api/admin-graphql/latest/objects/CompanyContact#field-CompanyContact.fields.draftOrders) * [CompanyLocation.draftOrders](https://shopify.dev/docs/api/admin-graphql/latest/objects/CompanyLocation#field-CompanyLocation.fields.draftOrders) * [CustomerMergePreviewDefaultFields.draftOrders](https://shopify.dev/docs/api/admin-graphql/latest/objects/CustomerMergePreviewDefaultFields#field-CustomerMergePreviewDefaultFields.fields.draftOrders) * [DraftOrderConnection.nodes](https://shopify.dev/docs/api/admin-graphql/latest/connections/DraftOrderConnection#returns-nodes) * [DraftOrderEdge.node](https://shopify.dev/docs/api/admin-graphql/latest/objects/DraftOrderEdge#field-DraftOrderEdge.fields.node) * [PaymentTerms.draftOrder](https://shopify.dev/docs/api/admin-graphql/latest/objects/PaymentTerms#field-PaymentTerms.fields.draftOrder) ### Possible type in * [Comment​Event​Embed](https://shopify.dev/docs/api/admin-graphql/latest/unions/CommentEventEmbed) * [Metafield​Referencer](https://shopify.dev/docs/api/admin-graphql/latest/unions/MetafieldReferencer) *** ## Queries * draftOrder * draftOrders *** ## DraftOrder Queries ### Queried by * [draft​Order](https://shopify.dev/docs/api/admin-graphql/latest/queries/draftOrder) * [draft​Orders](https://shopify.dev/docs/api/admin-graphql/latest/queries/draftOrders) *** ## Mutations * draftOrderComplete * draftOrderCreate * draftOrderCreateFromOrder * draftOrderDuplicate * draftOrderInvoiceSend * draftOrderUpdate *** ## DraftOrder Mutations ### Mutated by * [draft​Order​Complete](https://shopify.dev/docs/api/admin-graphql/latest/mutations/draftOrderComplete) * [draft​Order​Create](https://shopify.dev/docs/api/admin-graphql/latest/mutations/draftOrderCreate) * [draft​Order​Create​From​Order](https://shopify.dev/docs/api/admin-graphql/latest/mutations/draftOrderCreateFromOrder) * [draft​Order​Duplicate](https://shopify.dev/docs/api/admin-graphql/latest/mutations/draftOrderDuplicate) * [draft​Order​Invoice​Send](https://shopify.dev/docs/api/admin-graphql/latest/mutations/draftOrderInvoiceSend) * [draft​Order​Update](https://shopify.dev/docs/api/admin-graphql/latest/mutations/draftOrderUpdate) *** ## Interfaces * CommentEventSubject * HasEvents * HasLocalizationExtensions * HasLocalizedFields * HasMetafields * LegacyInteroperability * Navigable * Node *** ## DraftOrder Implements ### Implements * [Comment​Event​Subject](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/CommentEventSubject) * [Has​Events](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/HasEvents) * [Has​Localization​Extensions](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/HasLocalizationExtensions) * [Has​Localized​Fields](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/HasLocalizedFields) * [Has​Metafields](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/HasMetafields) * [Legacy​Interoperability](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/LegacyInteroperability) * [Navigable](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Navigable) * [Node](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Node)