> ## Documentation Index
> Fetch the complete documentation index at: https://spreecommerce.org/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Editing Orders

> Learn how to edit existing orders in Spree Commerce.

Editing orders in the admin dashboard allows you to provide flexible customer support - whether that means adding items, correcting addresses, upgrading shipping, or adjusting payments. This is especially common in B2B scenarios, where bulk pricing, negotiated terms, or inventory changes may require updates after an order is placed.

## How to Edit an Order

To edit an order, navigate to **Orders** in the admin dashboard.

<img src="https://mintcdn.com/spreecommerce/kJWdUUZtHB6dkauV/images/user/orders/editing-orders/1-orders-tab.png?fit=max&auto=format&n=kJWdUUZtHB6dkauV&q=85&s=c197c8953895963a1ebc9a46051e1582" alt="How to edit orders in Spree Commerce" width="3142" height="1796" data-path="images/user/orders/editing-orders/1-orders-tab.png" />

Click the order you’d like to modify to open the order details page.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/spreecommerce/images/user/orders/editing-orders/2-orders-details-page.png" alt="Editing on via the order details page in Spree Commerce" />

You can edit most aspects of an order (except the order number). Below are the key areas you can modify.

## Add Line Items

<img src="https://mintcdn.com/spreecommerce/kJWdUUZtHB6dkauV/images/user/orders/editing-orders/3-add-items.png?fit=max&auto=format&n=kJWdUUZtHB6dkauV&q=85&s=936698f09f7360d52796c945f8932cd6" alt="Adding line items to an order in the Spree dashboard" width="1708" height="646" data-path="images/user/orders/editing-orders/3-add-items.png" />

You may need to add products at a customer’s request—for example, to include additional items, upgrades, or promotional gifts.

To add a product:

1. Click **+ Add line item** at the top of the line items section.
2. Select the desired variant from the form, set the quantity and click **Add selected variant**

## Adjust Quantity of Line Items

<img src="https://mintcdn.com/spreecommerce/kJWdUUZtHB6dkauV/images/user/orders/editing-orders/4-adjust-quantity.png?fit=max&auto=format&n=kJWdUUZtHB6dkauV&q=85&s=84cc68367ebf09854fe60ebbf3c764cf" alt="Adjusting order line item quantities in Spree Commerce" width="1708" height="646" data-path="images/user/orders/editing-orders/4-adjust-quantity.png" />

To adjust quantity of existing line items:

1. Click **Show details** to expand line items
2. Click the **three-dot menu** on the line item you’d like to adjust
3. Enter the updated quantity and click **Save**

<Warning>If adding items or adjusting quantities increases the order total, you’ll need to add an additional payment (unless the item is added at no charge).</Warning>

## Remove Line Items

<img src="https://mintcdn.com/spreecommerce/kJWdUUZtHB6dkauV/images/user/orders/editing-orders/5-remove-items.png?fit=max&auto=format&n=kJWdUUZtHB6dkauV&q=85&s=05e489807ef2d4c9ed885236cb44420a" alt="Removing line items from an order in the Spree dashboard" width="1708" height="646" data-path="images/user/orders/editing-orders/5-remove-items.png" />

You may remove items due to customer requests, partial cancellations, or stock issues.

To remove a product:

1. Click **Show details** to expand line items
2. Click the **three-dot menu** on the line item you’d like to remove
3. Select **Delete** from the menu

<Warning>If the order has already been paid, issue a partial refund. If the payment is still due, delete the existing payment and create a new one with the correct amount.</Warning>

## Change Shipping or Billing Address

<img src="https://mintcdn.com/spreecommerce/kJWdUUZtHB6dkauV/images/user/orders/editing-orders/6-change-addresses.png?fit=max&auto=format&n=kJWdUUZtHB6dkauV&q=85&s=6673636c4593761d88efe642f80df2b5" alt="Changing the shipping address of an order in Spree Commerce" width="1304" height="646" data-path="images/user/orders/editing-orders/6-change-addresses.png" />

To update addresses:

1. In the **Customer** section, click the **three-dot menu**
2. Edit the shipping or billing address as needed

<Warning>If the new shipping address changes the shipping zone, you may need to update the shipping method to reflect available options for that region.</Warning>

## Change Fulfillment Location

<img src="https://mintcdn.com/spreecommerce/kJWdUUZtHB6dkauV/images/user/orders/editing-orders/7-fulfillment-location.png?fit=max&auto=format&n=kJWdUUZtHB6dkauV&q=85&s=2abfbfd19a06578d4e357e8d425f6ddc" alt="Changing the fulfillment location of an order in the Spree dashboard" width="1686" height="846" data-path="images/user/orders/editing-orders/7-fulfillment-location.png" />

If you manage multiple stock locations, you can change where an item is fulfilled from.

To change fulfillment location:

1. In the **Shipment** section, click the **split arrow icon** next to the line item
2. Select a different stock location and click **Move**

This will split the order into multiple shipments, each with its own shipping cost.

<Warning>If shipping costs change, you’ll need to update the payment accordingly.</Warning>

## Change Shipping Method

<img src="https://mintcdn.com/spreecommerce/kJWdUUZtHB6dkauV/images/user/orders/editing-orders/8-shipping-method.png?fit=max&auto=format&n=kJWdUUZtHB6dkauV&q=85&s=7cf58b4e8882e9e686c13ede2a20486c" alt="Changing the shipping method of an order in the Spree dashboard" width="1686" height="846" data-path="images/user/orders/editing-orders/8-shipping-method.png" />

To update the shipping method:

1. Click the pencil icon next to the current shipping method
2. Select a new method from the dropdown
3. Click **Save**

<Warning>If the new method has a different cost, adjust the payment to reflect the updated total.</Warning>

## Add Adjustments

<img src="https://mintcdn.com/spreecommerce/kJWdUUZtHB6dkauV/images/user/orders/editing-orders/9-adjustments.png?fit=max&auto=format&n=kJWdUUZtHB6dkauV&q=85&s=df5c219cf36105f5ae86a9f0eca4130d" alt="Adding orders adjustments in Spree Commerce" width="1674" height="336" data-path="images/user/orders/editing-orders/9-adjustments.png" />

To manually adjust the order total (e.g., for discounts, fees, or custom credits):

1. Scroll to the **Adjustments** section
2. Click **+ New Adjustment**
3. Enter a Label and set an Amount:
   * Positive amount = charge
   * Negative amount  = credit
4. Click **Create**

Adjustments will be reflected in the cost summary.

## Add Payments

<img src="https://mintcdn.com/spreecommerce/kJWdUUZtHB6dkauV/images/user/orders/editing-orders/10-add-payments.png?fit=max&auto=format&n=kJWdUUZtHB6dkauV&q=85&s=e7d1aa019b5b64274bdbdf5f07dfb98a" alt="Adding a payments to an existing order in Spree Commerce" width="1676" height="942" data-path="images/user/orders/editing-orders/10-add-payments.png" />

When order changes increase the total, you’ll need to add payment to keep the order balanced.

There are three options:

### Create a New Payment

Click **+ New Payment** and configure:

* **Amount** (defaults to remaining balance)
* **Payment Method**
* **Payment Source** (saved cards or accounts, if applicable)

Click **Create** to add the payment.

<Note>Depending on the payment method and its configuration, the payment may be captured automatically or require manual capture. If the customer has no saved payment source for the selected method, you won’t be able to charge it directly.</Note>

## Remove Payments

To delete a payment:

1. Click the **three-dot menu**  next to the payment
2. Select **Delete**

If the payment status is **Paid**, it cannot be deleted - you must issue a refund instead.

See [<u>Refunding Orders</u>](https://spreecommerce.org/docs/user/orders/refunding-orders) for detailed instructions.
