# WMS settings reference
URL: https://support.starshipit.com/articles/14700000000031-wms-settings-reference
Canonical: https://support.starshipit.com/articles/14700000000031-wms-settings-reference
Markdown: https://support.starshipit.com/articles/14700000000031-wms-settings-reference.md
Updated: 2026-08-03

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

> Learn what each of the 21 WMS Settings tabs controls across operations, orders, inventory, notifications, account, apps, and system.

Use this reference to understand how each setting changes your Starshipit WMS workflows.

**Path:** **System > Settings**

The Settings page groups 21 tabs into six navigation sections:

| Section | Tabs |
| --- | --- |
| **Operations** | Picking, Packing, Printing, Receiving, Putaway, Job Interface |
| **Orders & Jobs** | Orders, Order Routing, Jobs, Allocation |
| **Products & Inventory** | Products, Product Syncs, Inventory Writeback, Direct Integrations |
| **Notifications** | Email Notifications, Webhooks |
| **Account & Apps** | Starshipit Account, WMS Integration, Apps, Appearance |
| **System** | System |

:::note
The tabs you can see depend on your permissions. **Products**, **Product Syncs**, **Inventory Writeback**, and **Direct Integrations** require permission to manage both settings and products. Integration-specific controls only appear when the matching provider is available on your Starshipit account.
:::

Can't find a setting? Use the **Search settings** box at the top of the page, or open **Search** from the left navigation and enter the setting name.

![The WMS Settings page with grouped navigation and picking controls](/uploads/articles/starshipit-wms/web/warehouse-configuration/settings.png)

## Operations

### Picking

| Setting or control | What it does |
| --- | --- |
| **Tote Picking** | Lets workers pick a batch directly into totes, with one tote per order. Completing the pick creates one pack job for each tote. |
| **Require Pick Job ID on Create** | Requires the user to enter a Pick Job ID instead of letting WMS generate one. |
| **Auto-download Batch Order Packing Slips** | Downloads one PDF containing a bin-aware packing slip for each order after a batch pick is created. |

### Packing

| Setting or control | What it does |
| --- | --- |
| **Allow Partial Packing** | Lets packers print labels for quantities already packed. Turn it off to require the full packable quantity before printing. |
| **Dedicated Ship Process** | Separates packing from shipping. Packers finish packing first, then labels are printed from the shipping dashboard. |
| **Allow Ship Jobs on Mobile** | Lets mobile workers view and complete dedicated ship jobs. Turn it off to restrict shipping to the browser WMS. |
| **Show Bundle Names in Packing** | Shows exploding bundle parent rows so packers can see which bundle each component belongs to. |
| **Prevent Carrier/Service Changes in Packing** | Keeps the carrier and service selected before packing locked for packers. |

### Printing

| Setting or control | What it does |
| --- | --- |
| **Open labels in browser print dialog** | Opens shipping labels in the browser print dialog. Leave this off to download PDFs, including when a Starshipit desktop app handles printing. |
| **Delay printing during packing** | Shows a countdown before labels print. Turn it off to print as soon as an order is ready. |
| **Auto-save carrier on print** | Saves carrier or service changes to Starshipit before printing. Turn it off to sync only changes that a user explicitly saves. |
| **Show Bin Locations on Packing Summary** | Includes pick bin locations on combined packing summary PDFs when allocation snapshots are available. |

### Receiving

| Setting or control | What it does |
| --- | --- |
| **Allow Over-Receiving** | Lets workers receive more than the ordered quantity on a purchase order line. |
| **Container Numbering** | Sets the next sequential `CON-` barcode used when containers are created in bulk. |

### Putaway

| Setting or control | What it does |
| --- | --- |
| **Aggregate Putaway Into Existing Jobs** | Adds newly staged purchase order stock to an existing open putaway job at the same staging location. Turn it off to create separate putaway work. |

### Job Interface

These controls apply across supported web and mobile job interfaces. Users without an assigned interface policy inherit the account default.

| Setting or control | What it does |
| --- | --- |
| **Interface Policy** | Selects the account default or a staff policy to edit. You can create, rename, and delete policies. A policy must be unassigned before it can be deleted. |
| **Common Workflows** | Applies a preset to the selected policy. Choose **Barcode warehouse**, **Strict scanning**, **Assisted scanning**, or **Manual warehouse**, then adjust individual controls if needed. |
| **Barcode Scanning** | Shows barcode scanner and camera input in supported job interfaces. Turning this off also disables scan history and location verification, and keeps manual location confirmation and item selection available. |
| **Show Scan History on Web** | Shows recent scans and scan errors in supported web job interfaces. Mobile job screens do not show scan-history panels. |
| **Allow Typed Barcode Entry** | Lets workers type or paste values into supported scanner controls. Turn it off for managed scan-only workflows. |
| **Require Location Verification** | Requires workers to verify job locations before confirmation in supported flows. Barcode scanning must also be enabled. |
| **Allow Manual Location Confirmation** | Shows manual actions such as **I am here** or **Confirm Location Without Scan**. Turn it off to require barcode input for location verification. |
| **Allow Manual Item Selection** | Lets workers select job items from lists or cards without scanning. Turn it off to require barcode input where supported. |
| **Allow Manual Quantity Entry** | Shows direct quantity input and plus or minus controls where a job line supports quantity adjustment. |
| **Allow Partial/Manual Completion** | Lets workers complete or confirm a line before its expected quantity has been scanned or entered. |
| **Allow Pick All / Receive All Shortcuts** | Shows full-quantity shortcuts such as **Pick All**, **Receive All**, or **Complete All** where supported. |

:::caution
Before enforcing scan-only work, make sure every required location and product has a readable barcode. Workers can be blocked when manual location confirmation or item selection is unavailable.
:::

## Orders & Jobs

### Orders

| Setting or control | What it does |
| --- | --- |
| **Order Hold Reasons** | Controls the reasons operators can choose when placing an order on hold. Add a code and label, set its display order, and make it active or inactive. Built-in reason codes cannot be changed or removed. |
| **Leave shipment stock movements as-is when cancelling orders** | Prevents shipment stock movements from being reversed when applicable after an order is archived or deleted. Related jobs and allocations are still removed. |

### Order Routing

| Setting or control | What it does |
| --- | --- |
| **Enable routed-order management actions** | Shows actions for rejecting pending routed orders or returning released orders to the parent pool from Starshipit Orders. |
| **Enable automatic order routing** | Lets WMS assign eligible pending orders to the best configured child store. |
| **Priority** | Ranks stores to set the routing preference order. |
| **Included** | Controls whether a store participates in routing. |
| **Auto-route** | Controls whether an included store can receive automatically routed orders. |
| **Temporarily unavailable** | Temporarily excludes an included store without removing its routing configuration. |

### Jobs

| Setting or control | What it does |
| --- | --- |
| **Job Pause Reasons** | Controls the active reason codes and labels workers can choose when pausing an in-progress job. |

### Allocation

| Setting or control | What it does |
| --- | --- |
| **Kitting allocation source priority** | Chooses whether kitting jobs reserve component stock from **Pick face first** or **Bulk storage first**. |

## Products & Inventory

### Products

| Setting or control | What it does |
| --- | --- |
| **Default allocation rule** | Sets the default for products created or imported without an allocation rule: **FIFO**, **LIFO**, **FEFO**, **LEFO**, or **Specific Lot**. A product can override the default. |
| **Default new products to no client** | Leaves manually created products without a client assignment. Imports can still assign a client from their source account or import data. |
| **Restocking sales-history window** | Sets how many days of product sales history WMS uses for restocking burn-rate forecasts. |
| **Stock adjustment reasons** | Controls the reason list warehouse users can select when recording manual stock adjustments. |

### Product Syncs

| Setting or control | What it does |
| --- | --- |
| **Starshipit inbound sync** | Imports product fields and SKU filters from Starshipit into WMS. Use **Configure** to choose and run the import. |
| **Daily import** | Runs the Starshipit-to-WMS product import each day. |
| **Starshipit outbound sync** | Exports WMS product data to Starshipit when you select **Run**. |
| **Daily export** | Runs the WMS-to-Starshipit product export each day. |
| **Shopify Daily product import** | Chooses which connected or source Shopify stores import products into WMS each day. |

### Inventory Writeback

Writeback controls appear for supported providers connected to the Starshipit account. Choose the relevant setup guide in [Understand WMS integrations](/articles/14700000000044-understand-wms-integrations).

| Provider | Settings and behavior |
| --- | --- |
| **[Shopify](/articles/14700000000018-set-up-shopify-with-starshipit-wms)** | Choose a writeback location and enable automatic writeback per store. **Location buckets** can map WMS quarantine and quality control stock to Shopify quality control inventory, and damaged returns to damaged inventory. **Exploding bundles** can [set Shopify bundle availability from WMS component stock and open order demand](/articles/14700000000048-sync-exploding-bundle-availability-to-shopify), independently of automatic writeback. |
| **[BigCommerce](/articles/14700000000050-set-up-bigcommerce-with-starshipit-wms)** | Choose a writeback location and enable automatic inventory writeback per store. Only linked products with a selected location can be updated. |
| **[Magento 2](/articles/14700000000052-set-up-adobe-commerce-magento-2-with-starshipit-wms)** | Choose a writeback location and enable automatic inventory writeback per store. Only linked products with a selected location can be updated. |
| **[Cin7 Omni](/articles/14700000000053-set-up-cin7-omni-with-starshipit-wms)** | Choose a writeback branch and enable automatic writeback for connected products. |
| **[Unleashed](/articles/14700000000054-set-up-unleashed-with-starshipit-wms)** | Enter the destination warehouse code and enable automatic writeback. WMS uses each SKU as the Unleashed product code. |
| **[WooCommerce](/articles/14700000000051-set-up-woocommerce-with-starshipit-wms)** | Enables automatic inventory writeback for connected WooCommerce products. |

### Direct Integrations

The Direct Integrations tab contains the WMS connection for Cin7 Core. This is separate from the standard Cin7 Core order integration configured in Starshipit.

| Setting or control | What it does |
| --- | --- |
| **Core account ID** | Identifies the Cin7 Core account connected directly to this WMS account. |
| **Application key** | Authenticates WMS API requests to Cin7 Core. Saved credentials are not returned to the browser. |
| **Webhook bearer secret** | Authenticates incoming Cin7 Core webhooks. |
| **Test connection** | Saves changed credentials when needed, tests the connection, and loads active Cin7 Core warehouses. |
| **Cin7 Core warehouse** | Maps the WMS account to one Cin7 Core warehouse. WMS locations below the warehouse level are not copied to Cin7 Core. |
| **WMS reconciliation location** | Selects the WMS staging location used when Cin7 Core stock cannot be matched to an existing WMS bin or pick face. |
| **Enable Cin7 Core sync** | Accepts product, stock, and Advanced Purchase changes from Cin7 Core. |
| **Enable Cin7 Core writeback** | Sends completed Advanced Purchase receipts and explicit WMS inventory adjustments to Cin7 Core. Cin7 Core sync must also be enabled. |
| **Register webhooks** | Creates the product, stock, and Advanced Purchase webhooks in Cin7 Core after the integration is enabled. |
| **Import products** | Queues the initial Cin7 Core product catalogue import into WMS. |
| **Apply opening stock** | Applies opening balances after products have been imported. |

## Notifications

### Email Notifications

| Setting or control | What it does |
| --- | --- |
| **Enable WMS email notifications** | Enables operational emails for the selected events. |
| **Recipient emails** | Sets one or more recipients. Separate addresses with new lines or commas. |
| **Low stock alerts** | Sends an email when projected days of stock cover falls below the product's restock lead time. |
| **Stock received emails** | Sends a summary after purchase order receiving completes. |

### Webhooks

Webhooks send best-effort JSON payloads to an external HTTPS endpoint. WMS signs each payload with HMAC SHA-256 in the `X-Starshipit-WMS-Signature` header and never sends the secret itself.

| Setting or control | What it does |
| --- | --- |
| **Enable webhooks** | Sends the selected WMS events to the configured endpoint. |
| **Webhook URL** | Sets the HTTPS endpoint that receives event payloads. |
| **Webhook secret** | Sets the shared secret used to sign payloads. |
| **Low stock alerts** | Emits when a product enters urgent restocking status. |
| **Stock received** | Emits when purchase order receiving records stock movements. |
| **Inventory changed** | Emits when WMS records a stock movement. |
| **Purchase order lifecycle** | Emits when a purchase order is created, updated, changes status, or is deleted. |
| **Job created** | Emits when a WMS job is created. |
| **Job status changed** | Emits when a WMS job moves to a new status. |
| **Order lifecycle** | Emits when a WMS order is created, updated, changes status, or is deleted. |

## Account & Apps

### Starshipit Account

This tab is read-only. It shows whether the WMS add-on is enabled and displays the Starshipit account ID, name, type, plan, status, timezone, UTC offset, and currency.

### WMS Integration

| Setting or control | What it does |
| --- | --- |
| **Enable WMS integration** | Enables or disables the Starshipit WMS integration for the account. |
| **Expand bundle items** | Expands WMS bundle items into their components when printing shipments. |
| **WMS instance override** | Sends order events to a related account's WMS instance. Leave it unset to use the current account's instance. |

### Apps

| Setting or control | What it does |
| --- | --- |
| **Desktop Apps** | Provides downloads for the Windows and macOS desktop apps with WMS support. |
| **Mobile Apps** | Provides downloads for the Android and iOS WMS mobile apps. |
| **Mobile Sign In Code** | Generates a temporary code for signing the mobile scanner app into the Starshipit account. |

### Appearance

These preferences are stored for the device you are using.

| Setting or control | What it does |
| --- | --- |
| **Theme mode** | Uses the device theme or keeps WMS in light or dark mode. |
| **Interface scale** | Makes dashboard text and spacing denser or roomier. |

## System

| Setting or control | What it does |
| --- | --- |
| **Reset Transactional Data** | Permanently deletes allocations, inventory records, jobs, purchase orders, order records, stock movements, and process logs. It preserves account information, locations, products, suppliers, and packages, but resets product and package quantities to zero. You must enter `confirm` before the reset runs. |

:::warning
Resetting transactional data cannot be undone. Use it only when you intend to clear the WMS account's operational history while keeping its configuration.
:::

See [WMS outbound webhooks](/articles/14700000001025-wms-outbound-webhooks) for endpoint requirements, event payloads, signature verification, retries, and ordering.

## Not finding what you're looking for?

Not everything is managed from **Settings**.

| Looking for | Go to |
| --- | --- |
| Automation recipes and schedules | **Automations** in the left navigation |
| User roles, permissions, and interface policy assignments | **System > Roles & Permissions** |
| System events and errors | **System > Process Logs** |
| Setup walkthrough | **Help > Setup Guide** |
| Locations, zones, products, packages, and suppliers | **Setup** in the left navigation |

## Related articles

- [Locations and warehouse setup](/articles/14700000000033-starshipit-wms-locations-and-warehouse-setup)
- [Products and inventory configuration](/articles/14700000000006-starshipit-wms-products-and-inventory-configuration)
- [Orders and allocation](/articles/14700000000010-starshipit-wms-orders-and-allocation)
- [Receiving stock](/articles/14700000000008-starshipit-wms-receiving-stock)