Manage Reservations in Medusa Admin

In this guide, you’ll learn how to manage reservations in your store.

What is a Reservation?#

A reservation is a reserved quantity of an inventory item. Medusa automatically creates reservations for inventory items whose variants are purchased. This ensures that the inventory item is not sold to another customer while the order is being processed. Once the item in the order is fulfilled, the reservation is removed.

You can also manually create reservations for inventory items. For example, you can reserve a quantity of an inventory item for an offline sale or a customer who has requested a reservation.

View Reservations#

To view reservations, go to Inventory from the sidebar, then click the Reservations sub-item shown in the sidebar.

In the list, you can see reservation details such as the SKU and reserved quantity. You can also search, filter, and sort the reservations to find the specific item you are looking for.

Create a Reservation#

To create a reservation manually:

1. Go to Inventory → Reservations.
2. Click on the Create button at the top right.
3. In the form that opens:
   • For the “Item to reserve” field, enter or choose the SKU of the item you want to create a reservation for.
   • For the “Location” field, select the location where the reservation is created.
   • Set the reserved quantity in the "Quantity" field.
     • The table above the field shows you how many available quantities of the item are in the chosen location. When you make changes to the Quantity field, the availability will be updated in the table to reflect the change.
   • You can optionally add a description in the Description field.
4. Once you’re done, click the Create button.

View Reservation Details#

To view a reservation's details:

1. Go to Inventory → Reservations.
2. Click on the reservation you want to view.

This will open the reservation's details page.

Edit Reservation#

To edit a reservation:

1. Go to Inventory → Reservations.
2. Find the reservation you want to edit, and click the icon on its right.
3. Choose Edit from the dropdown.
4. In the side window that opens, you can edit the reservation's location, reserved quantity, and description.
5. Once you’re done, click the Save button.

Edit Reservation Metadata#

Metadata is custom data that can be associated with the reservation in key-value pairs. This is usually used by developers for custom integrations or to store additional information about the reservation.

To edit the reservation's metadata:

1. Go to the reservation's details page.
2. Click the icon at the right of the "Metadata" section.
3. In the side window that opens:
   • Manage the key-value pairs in the table.
   • To add a new row of key-value pairs before or after a row:
     • Hover over the row and click the icon at its right.
     • Choose "Insert row above" or "Insert row below" from the dropdown.
   • To delete a row of key-value pairs:
     • Hover over the row and click the icon at its right.
     • Choose "Delete row" from the dropdown.
4. Once you're done, click the Save button.

Delete Reservation#

To delete a reservation:

1. Go to Inventory → Reservations.
2. Find the reservation you want to delete, and click the icon on its right.
3. Choose Delete from the dropdown.
4. Confirm deleting the reservation by clicking the Delete button in the pop-up.