> 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).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://learn.moselle.io/operations/inventory/create-a-warehouse.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.