# Set up WMS returns and quarantine locations
URL: https://support.starshipit.com/articles/14700000000045-set-up-wms-returns-and-quarantine-locations
Canonical: https://support.starshipit.com/articles/14700000000045-set-up-wms-returns-and-quarantine-locations
Markdown: https://support.starshipit.com/articles/14700000000045-set-up-wms-returns-and-quarantine-locations.md
Updated: 2026-11-08

> For the complete documentation index, see [llms.txt](https://support.starshipit.com/llms.txt).

> Create the locations and process rules your team needs to receive, inspect, quarantine, and restock returned stock.

Set up locations for returned stock before receiving your first return. Choose WMS location types that reflect the item’s condition, then check how your connected sales platforms treat that stock.

## Before you begin

You need permission to manage locations. To change commerce writeback settings, you also need settings and product-management access. Decide who can inspect returns and approve write-offs. To test a return, prepare a controlled Shipped order and a user with fulfilment-management access.

## Create returns and inspection locations

1. Go to **Locations** and select **Create location**.
2. Enter a name that matches its physical label, such as `Returns inspection`.
3. Choose **Quarantine** or **Quality Control** for items awaiting inspection, or **Returns/Damaged** for unsellable returns. A location’s name alone does not determine how WMS treats its stock.
4. Enter the location barcode if your team scans locations.
5. Save the location.
6. Create or identify the **Pick Face** or **Bulk Storage** location that will receive approved sellable items.
7. Print the location labels and confirm their names and barcodes match the physical areas.

## Check sellable inventory writeback

Before receiving uninspected stock, confirm that the destination is excluded from sellable inventory in every connected platform that receives automatic updates.

For Shopify, go to **System > Settings > Connections & Integrations > Inventory Writeback**. Select the store’s writeback location and enable **Auto Writeback** and **Location buckets**. Quarantine and Quality Control map to Shopify quality-control stock; Returns/Damaged maps to damaged stock. Follow [Shopify inventory writeback setup](/articles/14700000000018-set-up-shopify-with-starshipit-wms) for store and product links.

Other providers can use different stock quantities or mappings. Follow the relevant [WMS integration guide](/articles/14700000000044-understand-wms-integrations). If your integration cannot exclude inspection stock, inspect the item before processing its WMS return. Use the final sellable destination for accepted stock. For an unsellable item that would temporarily increase sellable stock, follow the writeback-pause and write-off procedure in [Process returns in WMS](/articles/14700000000019-process-returns-in-wms).

## Verify the setup

1. Check the saved location types and scan a location label.
2. Process a controlled test return to the inspection location.
3. Confirm the WMS stock and its movement record.
4. Check the completed writeback and the destination platform’s sellable quantity. Stock awaiting inspection must not become sellable.
5. Move approved stock to normal storage and confirm the resulting availability.

## Troubleshooting

| Problem | What to check |
| --- | --- |
| Inspection stock becomes sellable online | Check the actual WMS location type and provider mapping. For Shopify, check Location buckets on the correct store. Correct the writeback setup before receiving more inspection stock. |
| A returns location is missing | Confirm the location is active and visible to the user’s client scope. |
| A barcode selects the wrong area | Check the saved barcode and replace or relabel any duplicate physical label. |

## Related articles

* [Process returns in WMS](/articles/14700000000019-process-returns-in-wms)
* [Set up warehouse locations and work areas](/articles/14700000000033-set-up-warehouse-locations-and-work-areas)
* [Move stock between WMS locations](/articles/14700000000067-move-stock-between-wms-locations)
