> For the complete documentation index, see [llms.txt](https://learn.moselle.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://learn.moselle.io/operations/inventory/create-a-warehouse.md).

# Create a Warehouse

{% hint style="info" %}
**Quick Answer:** To create a standalone warehouse, go to **Operations > Inventory > Warehouse tab > + Add Warehouse**. To link a warehouse to an integration, go to your **avatar > Settings > Warehouse tab > Create a Warehouse**. Both take about 2 minutes.
{% endhint %}

## Warehouse Types

**Synced Warehouses** Warehouses connected via integrations (e.g. Shopify, Amazon) that automatically sync inventory daily. If a sync is delayed or missing for a day, Moselle automatically carries forward the last known inventory value so your planning remains uninterrupted.

**Moselle Managed Warehouses** Manual warehouses where you control inventory updates by uploading inventory snapshots. See [Managing Inventory](/operations/inventory/managing-inventory.md) for upload instructions and best practices.

## Create a Warehouse

Create warehouses from the **Inventory** section of the app.

{% stepper %}
{% step %}

### Navigate to Warehouses

1. Click **Inventory** in the left sidebar under **Operations**
2. Click the **Warehouse** tab
   {% endstep %}

{% step %}

### Add a New Warehouse

Click **+ Add Warehouse**, then enter the warehouse details:

* Name
* Address, state/province, zip code, country

Click **Create**.
{% endstep %}
{% endstepper %}

## Link a Warehouse to an Integration

Linking a warehouse to an integration connects it to a location in an external system (e.g. a Shopify location or Amazon fulfillment center) so Moselle can sync inventory automatically. This is done from **Settings**, not the Inventory section.

{% hint style="info" %}
**Quick Answer:** Go to your avatar → **Settings** → **Warehouse** tab → **Create a Warehouse**. Enter a name, select a data source, then pick the matching location from the second dropdown.
{% endhint %}

{% embed url="<https://www.youtube.com/watch?v=uF2C8gpNHGM>" %}

### Prerequisites

**Time Required:** 1–2 minutes

* The integration is already connected under **Settings > Integrations**
* The location exists in your external system
* You have permission to manage warehouses

### Steps

{% stepper %}
{% step %}

### Open Warehouse Settings

1. Click your **avatar** in the top-right corner
2. Select **Settings**
3. Click the **Warehouse** tab

You'll see a list of your existing warehouses.
{% endstep %}

{% step %}

### Click Create a Warehouse

Click the **Create a Warehouse** button. A form will appear.
{% endstep %}

{% step %}

### Enter a Warehouse Name

Type a name for the warehouse, then continue to the next field.
{% endstep %}

{% step %}

### Select a Data Source

In the **Data source** dropdown, choose the integration you want to link to. Only integrations you've already connected will appear.
{% endstep %}

{% step %}

### Pick the External Location

A second dropdown appears listing all locations available within that data source. Select the location you want to link to this Moselle warehouse.

{% hint style="info" %}
Locations already linked to another Moselle warehouse are marked so you don't link the same source twice.
{% endhint %}
{% endstep %}

{% step %}

### Save

Click **Create**. You'll see a confirmation banner:

{% hint style="success" %}
**Syncing — full backfill in 24-48 hours.**
{% endhint %}
{% endstep %}
{% endstepper %}

### What Happens After You Link

| Stage               | Timing         | What you'll see                                        |
| ------------------- | -------------- | ------------------------------------------------------ |
| Initial sync        | Within minutes | Current on-hand levels appear in **Stock Levels**      |
| Historical backfill | 24-48 hours    | Past inventory available for forecasting and reporting |
| Ongoing sync        | Daily          | Inventory levels stay current automatically            |

Once linked, the warehouse becomes a **Synced Warehouse**.

### Supported Integrations

Self-serve linking works for: Shopify, Amazon FBA, QuickBooks Online, QuickBooks Desktop, NetSuite, Cin7 Omni, Fulfil, Trackstar (ShipBob, ShipStation, Extensiv, and other 3PLs), SKU Vault, and Walmart Fulfillment Services.

### FAQ

**Why is a location greyed out in the dropdown?**\
It's already linked to another Moselle warehouse. Each external location can only feed one Moselle warehouse at a time.

**Can I change which location a warehouse is linked to?**\
Yes. Open the warehouse in Settings, change the selection, and save. The new source replaces the old one on the next sync.

**How long until my reports reflect the new warehouse?**\
Live stock levels show up within minutes. Forecasts, plans, and historical reports refresh after the 24-48 hour backfill completes.

**What if my integration isn't listed?**\
Connect it under **Settings > Integrations** first. If you need a provider not yet supported, contact Moselle Support.

## Warehouse Details

Each warehouse has multiple tabs:

**Stock Levels**

* View current inventory for the warehouse
* Search by SKU or product name
* Download stock data

**Details**

| Field                | Description                                            |
| -------------------- | ------------------------------------------------------ |
| Name                 | Warehouse name                                         |
| Address              | Physical street address                                |
| State/Province       | State or province location                             |
| Zip/Postal Code      | Zip or postal code                                     |
| Country              | Country location                                       |
| Days on Hand Minimum | Minimum inventory days before triggering replenishment |
| Days on Hand Maximum | Maximum inventory days to maintain at this warehouse   |

**Constraints** Optimize your warehouse by setting constraints on product groups and SKUs.

**History** (Moselle Managed warehouses only) View all inventory transactions including manual uploads and Purchase Order inventory receives.

**Update Inventory**

To upload a new inventory snapshot for a manual warehouse, see [Managing Inventory](/operations/inventory/managing-inventory.md).