# Set up Starshipit WMS
URL: https://support.starshipit.com/articles/14700000000002-set-up-starshipit-wms
Canonical: https://support.starshipit.com/articles/14700000000002-set-up-starshipit-wms
Markdown: https://support.starshipit.com/articles/14700000000002-set-up-starshipit-wms.md
Updated: 2026-09-15

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

> Step-by-step guide to enabling Starshipit WMS, signing in for the first time, and completing initial warehouse setup.

Connect Starshipit to WMS, prepare your product catalogue and locations, bring in opening stock, and verify one end-to-end order before going live.

{{video:youtube:-0gYjAKu-n8}}

## Before you start

Before enabling Starshipit WMS, make sure you have:

* An active Starshipit account.
* Admin (or equivalent) access to **Settings** in Starshipit.
* Products set up in Starshipit with SKUs (barcodes recommended for scanning workflows).
* If you use multiple Starshipit child accounts or warehouses, decide whether they should share a WMS instance. See [Choose one or multiple WMS instances](/articles/14700000000061-choose-one-or-multiple-wms-instances) before enabling the integration.

## Step 1: Add the Starshipit WMS integration

1. In Starshipit, go to **Settings > Integrations > Add a new integration**.
2. Under *Inventory, Warehouse or Retail Management Platform*, select **Starshipit WMS**.

## Step 2: Configure the integration options

When adding the integration, configure the following:

**Enable Sending Order Events to Starshipit WMS**
This must be ticked. It ensures orders and shipment events flow from Starshipit into WMS so the warehouse can allocate and fulfil them.

**Expand WMS bundle items into their components when printing shipments** *(optional)*
Enable this if you use exploding bundles and need component products to appear on shipping documents (for example, on customs declarations).

**Choose a WMS Override** *(optional)*
Use this if you want the current Starshipit account to share a WMS instance with a different Starshipit account. See [Choose one or multiple WMS instances](/articles/14700000000061-choose-one-or-multiple-wms-instances) for help choosing the right structure.

> **Example:** You have two child accounts — one for B2B and one for B2C — both shipping from the same warehouse. You can point both accounts to a single WMS instance using WMS Override.

## Step 3: Save and open WMS

1. Click **Save** to enable the integration.
2. Open [wms.starshipit.com](https://wms.starshipit.com) and sign in using your Starshipit credentials.

## Signing in

Sign in at [wms.starshipit.com](https://wms.starshipit.com) using your Starshipit username and password.

If you cannot sign in, confirm:
* The WMS integration is enabled in the correct Starshipit account.
* You are using the right account environment (for example, the correct child account).

## Initial setup steps

Once you can access WMS, open **Setup** and follow the core setup journey. It prepares the warehouse foundation first, then brings stock in and verifies fulfilment. Work through these steps before processing real orders:

### 1. Sync and review products

1. Go to **Products** in WMS.
2. Click the menu and choose a sync option to import products from your Starshipit account.
3. For each key product, review and set:
   * Bundle configuration (exploding or require-stock)
   * Tracking type (Standard, Batch, or Serial)
   * Allocation strategy (FIFO, LIFO, FEFO, or LEFO)
   * Unit-of-measure relationships (if you buy in cartons and sell in eaches)

Getting product configuration right early avoids receiving errors and allocation issues later. See [Products and inventory configuration](/articles/14700000000006-starshipit-wms-products-and-inventory-configuration) for details.

### 2. Set up warehouse locations

1. Go to **Locations** in WMS.
2. Create your core locations:
   * **Pick faces** — forward-picking bins for fast order fulfilment.
   * **Bulk storage** — reserve stock used to replenish pick faces.
   * **Staging docks** — where inbound deliveries land before putaway.
   * **Packing benches** — stations where orders are packed and shipped.
   * **Special locations** — returns, quarantine, quality control, equipment/trolleys.
3. For pick faces, set minimum and maximum capacity if you plan to use automated replenishment.

See [Locations and warehouse setup](/articles/14700000000033-starshipit-wms-locations-and-warehouse-setup) for naming conventions, barcodes and layout options.

### 3. Seed your starting stock

If you are migrating from another system or setting up a fresh warehouse, import your current stock levels via the starting stock page:

You need `inventory.adjust`, synced products, and existing warehouse locations. Starting Stock adds positive whole-number opening balances for one location per SKU. It does not replace stock, and there is no user-facing undo. Use **Inventory > Stock Adjustments > Adjustments** for batch-, serial-, multi-location, or corrective changes.

1. Go to **Getting started > Bring stock in > Add starting stock**. After onboarding, use **Help > Setup Guide** to reopen the guide, or open [Starting Stock](https://wms.starshipit.com/dashboard/setup/starting-stock) directly.
2. Select **Have a lot of stock? Import via CSV instead**.
3. Select **Download a pre-filled template with your products**. WMS loads all product pages automatically.
4. Fill in `starting-stock-template.csv` with your opening quantities and locations. Keep its `sku,product_name,quantity,location` columns.
5. Import the completed file and review the staged quantities and locations.
6. Select **Save starting stock** once, then verify the balances in **Inventory**.

Follow [Migrate starting stock and cut over to Starshipit WMS](/articles/14700000000049-migrate-starting-stock-and-cut-over-to-starshipit-wms) for rehearsal, reconciliation, and error recovery.

### 4. Test an end-to-end order

1. Create a test order in your ecommerce platform or Starshipit.
2. Confirm it appears in WMS under **Orders**.
3. Release the order to create a pick job.
4. Pick, pack and ship the order, then verify:
   * Inventory is reduced correctly in WMS.
   * The order is marked as shipped in both Starshipit and WMS.

After the workflow is active, use the **Operations** dashboard to monitor work queues, warnings, stock health and fulfilment activity from one place.

![The WMS Operations dashboard showing warehouse health, work queues and fulfilment activity](/uploads/articles/starshipit-wms/web/getting-started/operations-overview.png)

## Installing the mobile app

Starshipit WMS has companion apps for handheld devices:

* **iOS** — in WMS, go to **System > Settings > Apps**, then select **Download for iOS** under Mobile Apps.
* **Android** — go to **System > Settings > Apps**, then select the Android download under Mobile Apps.

Mobile devices are automatically detected and redirected to a mobile-optimised experience when accessing WMS from a phone or tablet.

## FAQ

<!-- faq:start -->

<!-- faq:question -->Do I need to set up WMS before processing orders?<!-- /faq:question -->

You should complete at least products sync and location setup before processing real orders. Without locations, WMS cannot allocate stock to specific bins. Without correct product configuration, tracking and allocation rules will not behave as expected.

<!-- faq:question -->Can multiple Starshipit accounts share one WMS?<!-- /faq:question -->

Yes. Use the **WMS Override** option in the integration settings to point multiple Starshipit child accounts to a single WMS instance when they share the same warehouse and inventory.

<!-- faq:question -->Can I keep using my current Starshipit workflows while setting up WMS?<!-- /faq:question -->

Yes. WMS can run alongside your existing Starshipit pick/pack flows while you set up and test. See [Running WMS alongside Starshipit](/articles/14700000000004-running-wms-alongside-starshipit-hybrid-headless) for hybrid and headless models.

<!-- faq:end -->
