---
title: OrderEditAddCustomItemPayload - GraphQL Admin
description: Return type for `orderEditAddCustomItem` mutation.
api_version: 2025-01
api_name: admin
type: payload
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/admin-graphql/2025-01/payloads/ordereditaddcustomitempayload
  md: https://shopify.dev/docs/api/admin-graphql/2025-01/payloads/ordereditaddcustomitempayload.md
---

# Order​Edit​Add​Custom​Item​Payload

payload

Return type for `orderEditAddCustomItem` mutation.

## Fields

* calculated​Line​Item

  [Calculated​Line​Item](https://shopify.dev/docs/api/admin-graphql/2025-01/objects/CalculatedLineItem)

  The custom line item that will be added to the order based on the current edits.

* calculated​Order

  [Calculated​Order](https://shopify.dev/docs/api/admin-graphql/2025-01/objects/CalculatedOrder)

  An order with the edits applied but not saved.

* user​Errors

  [\[User​Error!\]!](https://shopify.dev/docs/api/admin-graphql/2025-01/objects/UserError)

  non-null

  The list of errors that occurred from executing the mutation.

***

## Mutations with this payload

* [order​Edit​Add​Custom​Item](https://shopify.dev/docs/api/admin-graphql/2025-01/mutations/orderEditAddCustomItem)

  mutation

  Adds a custom line item to an existing order. For example, you could add a gift wrapping service as a [custom line item](https://shopify.dev/apps/fulfillment/order-management-apps/order-editing#add-a-custom-line-item). To learn how to edit existing orders, refer to [Edit an existing order with Admin API](https://shopify.dev/apps/fulfillment/order-management-apps/order-editing).

  * id

    [ID!](https://shopify.dev/docs/api/admin-graphql/2025-01/scalars/ID)

    required

    ### Arguments

    The ID of the [calculated order](https://shopify.dev/api/admin-graphql/latest/objects/calculatedorder) to which the custom item is added.

  * title

    [String!](https://shopify.dev/docs/api/admin-graphql/2025-01/scalars/String)

    required

    The name of the custom item to add.

  * location​Id

    [ID](https://shopify.dev/docs/api/admin-graphql/2025-01/scalars/ID)

    The ID of the retail [location](https://shopify.dev/api/admin-graphql/latest/objects/location) (if applicable) from which the custom item is sold. Used for tax calculations. A default location will be chosen automatically if none is provided.

  * price

    [Money​Input!](https://shopify.dev/docs/api/admin-graphql/2025-01/input-objects/MoneyInput)

    required

    The unit price of the custom item. This value can't be negative.

  * quantity

    [Int!](https://shopify.dev/docs/api/admin-graphql/2025-01/scalars/Int)

    required

    The quantity of the custom item. This value must be greater than zero.

  * taxable

    [Boolean](https://shopify.dev/docs/api/admin-graphql/2025-01/scalars/Boolean)

    Whether the custom item is taxable. Defaults to `true`.

  * requires​Shipping

    [Boolean](https://shopify.dev/docs/api/admin-graphql/2025-01/scalars/Boolean)

    Whether the custom item requires shipping. Defaults to `false`.

  ***

***

## Map

### Mutations with this payload

* [order​Edit​Add​Custom​Item](https://shopify.dev/docs/api/admin-graphql/2025-01/types/orderEditAddCustomItem)