> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tetherdata.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Warehouses Overview

> Managing warehouse locations in Tether

# Warehouses Overview

Warehouses are the physical locations where your inventory is stored. In Tether, warehouses are essential for tracking stock levels, planning replenishment, and managing transfers.

## What is a Warehouse?

A warehouse represents any location that holds inventory:

* Distribution centers
* Retail stores
* 3PL facilities
* Manufacturing plants
* Fulfillment centers

## The Warehouses Dashboard

Navigate to **Inventory** → **Warehouses** to access the warehouse dashboard.

### Dashboard Features

| Feature            | Description                              |
| ------------------ | ---------------------------------------- |
| **Warehouse List** | All warehouses displayed in a data table |
| **Search**         | Find warehouses by name or code          |
| **Create Button**  | Add new warehouses                       |

## Creating a Warehouse

<Steps>
  <Step title="Navigate to Warehouses">
    Go to **Inventory** → **Warehouses**
  </Step>

  <Step title="Click Create Warehouse">
    Click the **Create Warehouse** button
  </Step>

  <Step title="Enter Warehouse Information">
    | Field                   | Required | Description                                                                |
    | ----------------------- | -------- | -------------------------------------------------------------------------- |
    | **Warehouse Code**      | Yes      | Short identifier (2-10 characters, letters, numbers, and underscores only) |
    | **Warehouse Name**      | Yes      | Descriptive display name (up to 100 characters)                            |
    | **Description**         | No       | Additional details about the warehouse (up to 500 characters)              |
    | **Address**             | No       | Physical location of the warehouse                                         |
    | **Contact Information** | No       | Phone, email, or other contact details                                     |
  </Step>

  <Step title="Save">
    Click **Create Warehouse** to create the warehouse
  </Step>
</Steps>

<Tip>
  Use clear, consistent naming. "NYC-01" is better than "Warehouse 1" when you have multiple locations.
</Tip>

## Warehouse Detail View

Click on a warehouse to open its detail page with multiple tabs:

### Overview Tab

The Overview tab displays basic warehouse information and lead time settings.

**Warehouse details shown:**

| Field                   | Description                                                            |
| ----------------------- | ---------------------------------------------------------------------- |
| **Warehouse Code**      | Short identifier                                                       |
| **Warehouse Name**      | Display name                                                           |
| **Management**          | Internally Managed or Externally Managed                               |
| **Description**         | Additional details (if set)                                            |
| **Address**             | Physical location (street, city, state/province, postal code, country) |
| **Contact Information** | Contact name, email, and phone (if set)                                |
| **Created Date**        | When the warehouse was added                                           |
| **Last Modified**       | When the warehouse was last updated                                    |

**Lead time settings** are also displayed in the Overview tab, showing transit lead times from this warehouse to other warehouses. See [Lead Time Configuration](/inventory/warehouses/lead-times) for details.

### Inventory Tab

View inventory at this warehouse:

* All SKUs with stock
* Inventory levels by state (sellable, committed, etc.)
* Health status indicators
* Quick filters

### Transactions Tab

Transaction history for this warehouse:

* Incoming orders
* Outgoing transfers
* Recent activity
* Pending transactions

### Inventory Settings Tab

Configure SKU-warehouse assignments for this warehouse. This determines which SKUs are tracked and managed at this location.

### Replenishment Settings Tab

Configure inventory and forecast settings specific to this warehouse, including safety stock levels, reorder points, and the **Max days** coverage cap.

## Externally Managed Warehouses

Warehouses can be flagged as **Externally Managed**:

| Management Type        | Behavior                                                                                               |
| ---------------------- | ------------------------------------------------------------------------------------------------------ |
| **Internally Managed** | Standard warehouse managed within Tether                                                               |
| **Externally Managed** | Warehouse managed by a third party (e.g., 3PL, supplier). Displayed with an "Externally Managed" badge |

<Note>
  Externally managed warehouses may be linked to suppliers. See [Supplier Held Inventory](/inventory/suppliers#supplier-held-inventory) for details.
</Note>

## Multi-Warehouse Operations

When you have multiple warehouses:

### Inventory Allocation

* Each SKU can have inventory in multiple warehouses
* Inventory is tracked separately by location
* [Supply planning](/supply-planning/overview) considers warehouse-specific needs

### Transfers

Move inventory between warehouses:

1. Create a Transfer Order
2. Specify source and destination
3. Select SKUs and quantities
4. Submit the transfer

### Fulfillment Rules

Configure which warehouses fulfill which channels:

* Warehouse A → Shopify US
* Warehouse B → Amazon
* Warehouse C → Wholesale

See [Inventory Settings](/administration/inventory-settings) for configuration.

## Best Practices

<AccordionGroup>
  <Accordion title="Naming Conventions">
    Use consistent, meaningful names:

    * Include location: "Chicago DC", "LA Warehouse"
    * Include type: "3PL-ShipBob", "Retail-NYC"
    * Use codes: "CHI-01", "LA-01"
  </Accordion>

  <Accordion title="Code Standards">
    Keep codes short and systematic:

    * 2-10 characters
    * Letters, numbers, and underscores only
    * Uppercase letters recommended
    * Include region if multi-location
  </Accordion>

  <Accordion title="Address Accuracy">
    Maintain accurate addresses:

    * Used for lead time calculations
    * Needed for shipping integrations
    * Important for reporting
  </Accordion>

  <Accordion title="Regular Audits">
    Periodically verify warehouse data:

    * Is inventory accurate?
    * Are addresses current?
    * Are lead times still correct?
  </Accordion>
</AccordionGroup>

## Common Operations

### Viewing Warehouse Inventory

1. Open warehouse detail page
2. Go to **Inventory** tab
3. See all SKUs with stock at this location

### Checking Warehouse Health

1. Go to **Inventory** and filter the grid to the warehouse
2. Review the health status indicators on each position
3. For projected coverage and shortfalls, see [inventory coverage](/supply-planning/coverage)

### Creating a Transfer

1. Go to **Transactions**
2. Create new Transfer Order
3. Select source and destination warehouses
4. Add SKUs and quantities
5. Submit

## Troubleshooting

### Warehouse Not Showing in Dropdowns

**Possible causes:**

* No inventory at warehouse
* Filter is excluding it

**Solutions:**

1. Verify filters include all warehouses
2. Ensure warehouse is configured for the operation

### Inventory Mismatch

**Possible causes:**

* Pending transactions not completed
* Sync delay from integrations
* Data entry error

**Solutions:**

1. Check pending transactions
2. Wait for sync to complete
3. Review transaction history for discrepancies

## Next Steps

<CardGroup cols={2}>
  <Card title="Lead Time Configuration" icon="clock" href="/inventory/warehouses/lead-times">
    Set up transfer times
  </Card>

  <Card title="Inventory Management" icon="gauge" href="/inventory/dashboard">
    Monitor warehouse inventory
  </Card>

  <Card title="Transactions" icon="file-invoice" href="/transactions/overview">
    Create transfers and orders
  </Card>

  <Card title="Inventory Settings" icon="gear" href="/administration/inventory-settings">
    Configure fulfillment rules
  </Card>
</CardGroup>