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

# Inventory Management

> View stock levels across warehouses, track changes, and manage on-hand adjustments

# Inventory Management

The **Inventory Management** page is your central view of current stock levels across all warehouses. From here you can inspect positions, upload inventory in bulk, review the full change history, and propose or approve on-hand adjustments.

## Accessing the page

Navigate to **Inventory** in the sidebar. The page opens on the **Inventory** tab.

## Page tabs

| Tab             | Purpose                                                    | Who sees it                                   |
| --------------- | ---------------------------------------------------------- | --------------------------------------------- |
| **Inventory**   | Current stock levels across warehouses                     | Everyone                                      |
| **History**     | The full inventory change feed and point-in-time snapshots | Everyone                                      |
| **Approvals**   | Queue of adjustment requests waiting for a decision        | Users with the `inventory:approve` permission |
| **My requests** | Your own adjustment requests and their outcomes            | Users with the `inventory:adjust` permission  |

See [Inventory history](/inventory/history) for the History tab and [Inventory adjustments](/inventory/adjustments) for the Approvals and My requests tabs.

## Inventory tab

The Inventory tab shows a grid of stock positions — one per SKU and warehouse pairing.

### Filtering and grouping

* Use the search box and filters to narrow the grid to specific SKUs, warehouses, or product groups.
* Group rows by warehouse, health status, collection, SKU, product hierarchy fields, or attributes.
* Toggle **Pivot by location** to fold the grid into one row per SKU with a column per warehouse. Warehouse and health status grouping are unavailable while pivoted, since those values are per-position.

### Row actions

Right-click a row (or, in the pivoted view, a location's cell) to open the context menu:

* **Adjust on-hand…** — propose a change to the position's on-hand count. See [Inventory adjustments](/inventory/adjustments).
* **Remove from warehouse** — zero out a position through an audited adjustment.

<Note>
  In the pivoted view a row spans locations, so both actions apply to the location of the cell you clicked, not the whole row.
</Note>

## Uploading inventory

Users with write permissions see an **Upload Inventory** button in the page header.

<Steps>
  <Step title="Open the upload dialog">
    Click **Upload Inventory** in the top-right corner of the page.
  </Step>

  <Step title="Provide your inventory file">
    Follow the dialog to upload your inventory data. An upload is treated as a batch of inventory adjustments.
  </Step>

  <Step title="Verify the results">
    Check the [History tab](/inventory/history) to confirm the changes landed as expected.
  </Step>
</Steps>

<Info>
  The **Upload Inventory** button is hidden for users without write permissions and for the stock-counting role, which has no direct-commit path to on-hand. See [Roles & Permissions](/roles-permissions) for details.
</Info>

## Planning and replenishment

Inventory levels feed directly into supply planning. Order recommendations, transfer suggestions, and coverage projections live in the [Supply Planning](/supply-planning/overview) section, not on this page.

## Best practices

<AccordionGroup>
  <Accordion title="Reconcile counts through adjustments">
    When a physical count disagrees with the system, use **Adjust on-hand…** rather than editing data elsewhere. Adjustments are audited, carry a reason and note, and flow through approval when required.
  </Accordion>

  <Accordion title="Use pivot by location for cross-warehouse review">
    When you carry the same SKUs in several warehouses, the pivoted view puts every location's count on one row so imbalances stand out immediately.
  </Accordion>

  <Accordion title="Check History after bulk uploads">
    Every upload lands in the [History feed](/inventory/history) with its source recorded. Review it after an upload to confirm the batch applied cleanly.
  </Accordion>

  <Accordion title="Keep planning in the Supply Planning section">
    Use this page to verify what you have; use [Supply Planning](/supply-planning/overview) to decide what to order, transfer, or produce next.
  </Accordion>
</AccordionGroup>

## Troubleshooting

### Approvals or My requests tab is missing

**Possible cause:** These tabs are permission-gated — Approvals requires `inventory:approve` and My requests requires `inventory:adjust`.

**Solution:** Ask your administrator to review your role. See [Roles & Permissions](/roles-permissions).

### Upload Inventory button is missing

**Possible cause:** Your account lacks write permissions, or you are on the stock-counting role.

**Solution:** Uploads write on-hand directly, so they require a write permission. Ask your administrator if you believe you should have access.

### A count looks wrong

**Possible causes:** A pending adjustment has not been approved yet, or a sync from an integration is still in flight.

**Solutions:**

1. Check the [Approvals queue](/inventory/adjustments) for a pending request against that position.
2. Open the [History tab](/inventory/history) and drill into the position to see every change with its source and actor.

## Next Steps

<CardGroup cols={2}>
  <Card title="Inventory History" icon="clock-rotate-left" href="/inventory/history">
    Trace every change to your stock levels
  </Card>

  <Card title="Inventory Adjustments" icon="clipboard-check" href="/inventory/adjustments">
    Propose and approve on-hand corrections
  </Card>

  <Card title="Warehouses" icon="warehouse" href="/inventory/warehouses/overview">
    Configure warehouse settings
  </Card>

  <Card title="Supply Planning" icon="clipboard-list" href="/supply-planning/overview">
    Plan replenishment from your current stock
  </Card>
</CardGroup>