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

# View Inventory Segments

Segmented inventory is displayed in the Inventory UI and Inventory API data, and you can manage the inventory tags of individual order items from the Orders UI.

<CardGroup cols={2}>
  <Card title="Inventory Concepts" icon="book-open" horizontal href="/concept-guides/inventory" data-rec="concept-guide">
    Learn about inventory management fundamentals
  </Card>

  <Card title="Developer Reference" icon="code" horizontal href="/developer-guides/inventory" data-rec="developer-doc">
    See the Inventory API documentation for programmatic access
  </Card>

  <Card title="Watch: Inventory Segmentation" icon="circle-play" horizontal href="/video/inventory-segmentation" data-rec="video">
    Learn how to configure and manage inventory segments
  </Card>
</CardGroup>

<CardGroup cols={2}>
  <Card title="Inventory Concepts" icon="book-open" horizontal href="/concept-guides/inventory">
    Learn about inventory management fundamentals
  </Card>

  <Card title="Developer Reference" icon="code" horizontal href="/developer-guides/inventory">
    See the Inventory API documentation for programmatic access
  </Card>

  <Card title="Watch: Inventory Segmentation" icon="circle-play" horizontal href="/video/inventory-segmentation">
    Learn how to configure and manage inventory segments
  </Card>
</CardGroup>

## Inventory UI

<Note>
  **Note:** The Inventory UI has been updated with a new look and feel and new functional changes, and has been renamed to **Supply/Demand UI**. Contact [Kibo Support](https://help.kibocommerce.com/) to opt in and begin using it. All sandbox tenants will receive the new UI on July 21. Select the tab below based on which UI your tenant is currently using.
</Note>

<Tabs>
  <Tab title="Legacy Inventory UI">
    Expanding a row in the main Inventory table will reveal its tags and the portions of the total quantities that has been set for each segment of tag values. As shown earlier, the On Hand, Available, and Allocated values add up to the total quantity for the inventory record.

    If inventory is out of stock (in other words, if the available inventory is 0) at a particular location, then its row will be highlighted red. If available inventory is less than the safety stock but is not yet 0, then it will be highlighted yellow to warn that it will be going out of stock soon.

    The safety stock is set at the overall record level, and all segments within that record are compared against that value. If only one segment is out of stock or its available quantity is below the safety stock value, then only that row will be highlighted.

    <img src="https://mintcdn.com/kibocommerce-59e68a4a/mirjU24xTFSyw6n2/img/out-of-stock.png?fit=max&auto=format&n=mirjU24xTFSyw6n2&q=85&s=a9712aeb107fd5550d62e0d52797724a" alt="Example of a product highlighted in red where quantity is 0" width="2436" height="304" data-path="img/out-of-stock.png" />
  </Tab>

  <Tab title="Supply Demand UI">
    In the new UI, segmented inventory is viewed through the View/Edit drawer rather than by expanding rows in the table.

    Go to **Main > Orders > Inventory** and search for the product-location you want to inspect. Click **View** or **Edit** on any row to open the drawer, then select the **Tags tab**.

    The Tags tab shows per-tag quantities:

    | Column    | Description                          |
    | :-------- | :----------------------------------- |
    | Tag       | The tag name and value               |
    | On Hand   | Inventory on hand for this segment   |
    | Available | Available inventory for this segment |
    | Allocated | Allocated inventory for this segment |

    <Frame>
      <img src="https://mintcdn.com/kibocommerce-59e68a4a/zyPGId2tNMortFFy/images/ViewTags-MainInventory.png?fit=max&auto=format&n=zyPGId2tNMortFFy&q=85&s=d4d1245739bdcbfc20d4d545621e7967" alt="View Tags Main Inventory" width="1861" height="653" data-path="images/ViewTags-MainInventory.png" />
    </Frame>

    **Stock status colors**

    The new UI uses four row colors at the record level instead of two:

    | Color  | Status       | Condition                      |
    | :----- | :----------- | :----------------------------- |
    | Green  | In Stock     | Available ≥ safety stock       |
    | Yellow | Low Stock    | Available \< safety stock, > 0 |
    | Red    | Out of Stock | Available = 0                  |
    | Purple | Excess       | Excess quantity > 0            |

    The safety stock is still set at the overall record level. Individual tag-level quantities are visible inside the Tags tab.

    <Frame>
      <img src="https://mintcdn.com/kibocommerce-59e68a4a/zyPGId2tNMortFFy/images/StatusPills-InventoryTags.png?fit=max&auto=format&n=zyPGId2tNMortFFy&q=85&s=fc95f5decaddaf2bd3f3dfab1fcdf53b" alt="Status Pills Inventory Tags" width="1902" height="801" data-path="images/StatusPills-InventoryTags.png" />
    </Frame>
  </Tab>
</Tabs>

### View Segmented Future Inventory

<Tabs>
  <Tab title="Legacy Inventory UI">
    If viewing inventory for a site that has [future inventory](/pages/future-inventory "Future Inventory") enabled as well as segmentation, the Future On Hand, Future Available, and Future Allocated levels will be displayed at the tag level while the parent record displays the sum of inventory levels across all tags.

    1. Expand a parent inventory record to view its tags, which will include a breakdown of each segment's Current, Future, and Total (the sum of Current and Future) inventory levels if that product uses future inventory.
    2. Click the **Future Inventory Dates** link on an individual segment. This will display a pop-up with more details about the inventory levels that are expected for that segment until the selected date.  <img src="https://mintcdn.com/kibocommerce-59e68a4a/lNdWuidiFHcqMZvX/img/future-inventory-link.png?fit=max&auto=format&n=lNdWuidiFHcqMZvX&q=85&s=2002c7bb47b783f7372b437189bb843b" alt="An inventory record expanded to show the Future Inventory Dates link" width="1865" height="217" data-path="img/future-inventory-link.png" />
    3. Select a date using the drop down **Select a date to retrieve future inventory**. This should be a value between the current date and the future date limit as configured in site settings per site.
           <Frame>
             <img src="https://mintcdn.com/kibocommerce-59e68a4a/5B5Dqyuwxe3Ogson/images/futureinventorypersitesettingdate.png?fit=max&auto=format&n=5B5Dqyuwxe3Ogson&q=85&s=c498c8621e27a23d6151ad44849f3ce0" alt="Futureinventorypersitesettingdate" width="1588" height="472" data-path="images/futureinventorypersitesettingdate.png" />
           </Frame>
  </Tab>

  <Tab title="Supply Demand UI">
    In the new UI, segmented [future inventory](/pages/future-inventory) is viewed from the Future Inventory page or Future Tab on Main Inventory Page rather than from a popup on the main inventory table.

    **Option 1 — From the main Inventory page**

    <Note>
      **Note:** The **Future tab** inside the View/Edit drawer is only visible when you have searched using a future date range filter (via Advanced Filter). Run your search with a future date range first, then open the drawer to access this tab.
    </Note>

    1. Go to **Main > Orders > Inventory**.
    2. Search for the product-location. In **Advanced Filter**, set a **Future Date Range**.
    3. Click **View** or **Edit** on a row to open the drawer, then select the **Future tab**.
    4. The Future tab shows Future On Hand, Future Available, and Future Allocated for this product-location, broken down by tag..

    <Frame>
      <img src="https://mintcdn.com/kibocommerce-59e68a4a/zyPGId2tNMortFFy/images/Taginfo-FutureInventory-MainInventoryPage.png?fit=max&auto=format&n=zyPGId2tNMortFFy&q=85&s=e0f65c0c79c5c4ca16e2583408b1e20a" alt="Taginfo Future Inventory Main Inventory Page" width="1862" height="748" data-path="images/Taginfo-FutureInventory-MainInventoryPage.png" />
    </Frame>

    **Option 2 — From the Future Inventory page**

    1. Go to **Main > Orders > Inventory > Future Inventory**.
    2. Search by UPC, Location, or Future Date Range to find the records you need.
    3. Click **View** on an Future Incoming Record. Tags Info for that Future Inventory Record is visible on the View Drawer.

    <Frame>
      <img src="https://mintcdn.com/kibocommerce-59e68a4a/zyPGId2tNMortFFy/images/ViewTags-FutureInventoryPage.png?fit=max&auto=format&n=zyPGId2tNMortFFy&q=85&s=38f5cf5c55a881d7a28b67e15c5daa91" alt="View Tags Future Inventory Page" width="1905" height="796" data-path="images/ViewTags-FutureInventoryPage.png" />
    </Frame>
  </Tab>
</Tabs>

## API Responses

You can also view tagged inventory segments when [retrieving inventory data from the API](/api-reference/inventory/get-inventory-post), such as in this example response:

```text theme={null}
[
    {
        "locationName": "Main Warehouse",
        "locationCode": "homebase",
        "tenantID": 31545,
        "onHand": 150,
        "available": 148,
        "allocated": 2,
        "pending": 0,
        "upc": "AD1001",
        "blockAssignment": false,
        "ltd": 0,
        "floor": 0,
        "safetyStock": 0,
        "distance": 0,
        "directShip": true,
        "transferEnabled": true,
        "pickup": true,
        "countryCode": "US",
        "taggedInventory": [
            {
                "onHand": 100,
                "available": 100,
                "allocated": 0,
                "pending": 0,
                "tags": {
                    "Channel": "Warehouse"
                },
                "futureInventory": null
            },
            {
                "onHand": 50,
                "available": 48,
                "allocated": 2,
                "pending": 0,
                "tags": {
                    "Channel": "Target"
                },
                "futureInventory": null
            }
        ]
    }
]
```
