# orderEditAddLineItemDiscount - admin-graphql - MUTATION
Version: 2024-07

## Description
Adds a discount to a line item on the current order edit. For more information on how to use the GraphQL Admin API to edit an existing order, refer to [Edit existing orders](https://shopify.dev/apps/fulfillment/order-management-apps/order-editing).

### Access Scopes
`write_order_edits` access scope. Also: The user must have apply_discounts_to_orders permission.


## Arguments
* [discount](/docs/api/admin-graphql/2024-07/input-objects/OrderEditAppliedDiscountInput): OrderEditAppliedDiscountInput! - The discount to add to the line item.
* [id](/docs/api/admin-graphql/2024-07/scalars/ID): ID! - The ID of the [calculated order](https://shopify.dev/api/admin-graphql/latest/objects/calculatedorder)
to update.
* [lineItemId](/docs/api/admin-graphql/2024-07/scalars/ID): ID! - The ID of the calculated line item to add the discount to.


## Returns
* [addedDiscountStagedChange](/docs/api/admin-graphql/2024-07/objects/OrderStagedChangeAddLineItemDiscount): OrderStagedChangeAddLineItemDiscount The discount applied to a line item during this order edit.
* [calculatedLineItem](/docs/api/admin-graphql/2024-07/objects/CalculatedLineItem): CalculatedLineItem The line item with the edits applied but not saved.
* [calculatedOrder](/docs/api/admin-graphql/2024-07/objects/CalculatedOrder): CalculatedOrder An order with the edits applied but not saved.
* [userErrors](/docs/api/admin-graphql/2024-07/objects/UserError): UserError! The list of errors that occurred from executing the mutation.


## Examples