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

# Configure Inventory Tags

To use inventory segmentation, you need to enable them on your tenant and then configure your tags.

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

## Enable Inventory Tags

<Tabs>
  <Tab title="Legacy Inventory UI">
    Tags must be enabled and configured before inventory can be used in segments.

    1. Click **Inventory Settings** in the Inventory UI to access the inventory configurations. <img src="https://mintcdn.com/kibocommerce-59e68a4a/rEvXzvGZITa7EDMq/img/inventory-settings.png?fit=max&auto=format&n=rEvXzvGZITa7EDMq&q=85&s=bc80b210b70f5c57cbf691a9422f3662" alt="The Inventory navigation menu" width="570" height="369" data-path="img/inventory-settings.png" />
    2. Under the Inventory Tags section, click **Enable Inventory Tags** to toggle this functionality on. <img src="https://mintcdn.com/kibocommerce-59e68a4a/IIUyhCjtFT3x5IDQ/img/enable-inventory-tags.png?fit=max&auto=format&n=IIUyhCjtFT3x5IDQ&q=85&s=20f4e1800d9ce30751533f98092b35db" alt="Callout of the Enable Inventory Tags button of inventory settings" width="1429" height="480" data-path="img/enable-inventory-tags.png" />

    This will create an empty table where tags will be displayed once created.

    <img src="https://mintcdn.com/kibocommerce-59e68a4a/7XXCwOQjUsW_CZYB/img/tag-table.png?fit=max&auto=format&n=7XXCwOQjUsW_CZYB&q=85&s=b0b428decbe36ad0441dabd68f53c402" alt="The empty table created by enabling tags" width="1431" height="190" data-path="img/tag-table.png" />
  </Tab>

  <Tab title="Supply Demand UI">
    Tags must be enabled and configured before inventory can be used in segments.

    1. Click **Inventory Settings** in the Supply Demand Menu to access the inventory configurations.
           <Frame>
             <img src="https://mintcdn.com/kibocommerce-59e68a4a/ipmr2PwXcWtHbcK2/images/image-37.png?fit=max&auto=format&n=ipmr2PwXcWtHbcK2&q=85&s=0c7aea4a5f4b28215789f52532764748" alt="Inventory Settings on SupplyDemand UI Menu" width="1909" height="581" data-path="images/image-37.png" />
           </Frame>
    2. Under the Inventory Tags section, click **Enable Inventory Tags** to toggle this functionality on.
           <Frame>
             <img src="https://mintcdn.com/kibocommerce-59e68a4a/ipmr2PwXcWtHbcK2/images/image-38.png?fit=max&auto=format&n=ipmr2PwXcWtHbcK2&q=85&s=df6b249024bc39e4a01ab8da81752bc5" alt="Enable Inventory Tags New Supply Demand UI" width="1908" height="537" data-path="images/image-38.png" />
           </Frame>

    This will create an empty table where tags will be displayed once created.
  </Tab>
</Tabs>

## Create Inventory Tags

<Tabs>
  <Tab title="Legacy Inventory UI">
    You can create new tags by clicking **Create Inventory Tag**. A pop-up will appear with configuration settings. There is a default maximum limit of 3 tags per tenant and 6 tag values per tenant (across all tags).

    1. Enter a **Tag Name** (such as Channel). This name is sometimes referred to as a "tag category" in APIs or other resources.
    2. Enter a default **Tag Value** (such as Amazon). At least one value is required to be set, as if no tag is specified for an inventory item then it will use this first value instead.<br /><img src="https://mintcdn.com/kibocommerce-59e68a4a/wnwrN32AISYXOyk6/img/1718994645535.png?fit=max&auto=format&n=wnwrN32AISYXOyk6&q=85&s=b6c541b5d3b12095d3c15922ca57c62e" alt="The Create Tag Name module with name, value, and allocation percentage options" width="678" height="543" data-path="img/1718994645535.png" />
    3. If desired, set the **Inventory Allocation** percentage. This will determine how much of the total inventory is made available for this segment. In this example, 50% of the discrete total inventory will always be allocated for the Amazon sales channel. If you want to use discrete values for your inventory segmentation instead of a percentage, you must leave the Inventory Allocation % field blank. If you do set percentage values but want to switch to discrete values later, you must delete all tags and re-add them without percentages to view discrete inventory.
    4. Click **Add Tag Value** to create another option for this tag. All values that you add should be unique within their tag name.
    5. If an allocation percentage is specified for each value, then all of the percentages must add up to 100%.
       * In the below example, the first value is allocated at 50% so additional tags could be created with allocations of 20% and 30%. However, it is not required to set these percentages – if any are left blank, then validation will not be done for that tag value when inventory levels are refreshed. It will effectively accept any amount of inventory, as long as other values' percentage requirements are satisfied first.<img src="https://mintcdn.com/kibocommerce-59e68a4a/5p2bvmH14ykLzZaY/img/add-tag-value.png?fit=max&auto=format&n=5p2bvmH14ykLzZaY&q=85&s=592c2da59b29860b6adf7a07a6c24186" alt="Example of the Create Tag Name module with additional tag values being added" width="659" height="686" data-path="img/add-tag-value.png" />
    6. Click **Create** to save the tag.
  </Tab>

  <Tab title="Supply Demand UI">
    You can create new tags by clicking **Create Inventory Tag**. A Drawer will appear with configuration settings. There is a default maximum limit of 3 tags per tenant and 6 tag values per tenant (across all tags).

    1. Enter a **Tag Name** (such as Channel). This name is sometimes referred to as a "tag category" in APIs or other resources.
           <Frame>
             <img src="https://mintcdn.com/kibocommerce-59e68a4a/ipmr2PwXcWtHbcK2/images/image-39.png?fit=max&auto=format&n=ipmr2PwXcWtHbcK2&q=85&s=bf12fd808d0b43abf44123d6483d2c68" alt="Create Inventory Tags Supply Demand UI" width="1862" height="872" data-path="images/image-39.png" />
           </Frame>
    2. Enter a default **Tag Value** (such as Amazon). At least one value is required to be set, as if no tag is specified for an inventory item then it will use this first value instead
    3. If desired, set the **Inventory Allocation** percentage. This will determine how much of the total inventory is made available for this segment. In this example, 50% of the discrete total inventory will always be allocated for the Amazon sales channel. If you want to use discrete values for your inventory segmentation instead of a percentage, you must leave the Inventory Allocation % field blank. If you do set percentage values but want to switch to discrete values later, you must delete all tags and re-add them without percentages to view discrete inventory.
    4. Click **Add Tag Value** to create another option for this tag. All values that you add should be unique within their tag name.
    5. If an allocation percentage is specified for each value, then all of the percentages must add up to 100%.
       * In the below example, the first value is allocated at 50% so additional tags could be created with allocations of 20% and 30%. However, it is not required to set these percentages – if any are left blank, then validation will not be done for that tag value when inventory levels are refreshed. It will effectively accept any amount of inventory, as long as other values' percentage requirements are satisfied first.
             <Frame>
               <img src="https://mintcdn.com/kibocommerce-59e68a4a/ipmr2PwXcWtHbcK2/images/image-40.png?fit=max&auto=format&n=ipmr2PwXcWtHbcK2&q=85&s=7ae748ffb11aef31ca2430be73613119" alt="Allocation Percentage Supply Demand UI" width="577" height="858" data-path="images/image-40.png" />
             </Frame>
    6. Click **Save** to Create the tag.
  </Tab>
</Tabs>

## View and Update Tags

<Tabs>
  <Tab title="Legacy Inventory UI">
    Once set, the new tag is added to the Inventory Tags table. Click a tag in the table to expand its details and view the possible values and allocation percentages.

    You can use the dropdown menu shown below to **Edit** or **Delete** a tag instead. Editing will open the same pop-up as used for tag creation, allowing you to update all values, change the default value, and delete any non-default values.

    <img src="https://mintcdn.com/kibocommerce-59e68a4a/7XXCwOQjUsW_CZYB/img/tag-configurations.png?fit=max&auto=format&n=7XXCwOQjUsW_CZYB&q=85&s=1785871bb6bf670d28d448855d858e92" alt="Example of a populated Inventory Tags table in inventory settings" width="1432" height="382" data-path="img/tag-configurations.png" />

    Inventory should be periodically redistributed between your channels based on the allocation percentages. You can do this on-demand by calling the [Inventory Redistribution API](/pages/inventory-api-overview#inventory-redistribution "Inventory API Overview") with the UPCs and/or location codes you want to redistribute across. Asynchronous redistribution will then occur at the next Refresh or Adjust update to restore the appropriate amount of inventory to the designated channels.
  </Tab>

  <Tab title="Supply Demand UI">
    Once set, the new tag is added to the Inventory Tags table. Click the edit icon in the table to view and edit its details and view the possible values and allocation percentages.

    Editing will open the same Drawer as used for tag creation, allowing you to update all values, change the default value, and delete icon will allow to delete Tag.

    <Frame>
      <img src="https://mintcdn.com/kibocommerce-59e68a4a/ipmr2PwXcWtHbcK2/images/image-41.png?fit=max&auto=format&n=ipmr2PwXcWtHbcK2&q=85&s=ba6027dc8e5761db1341335246545146" alt="Edit & View Tags" width="1891" height="847" data-path="images/image-41.png" />
    </Frame>

    Inventory should be periodically redistributed between your channels based on the allocation percentages. You can do this on-demand by calling the [Inventory Redistribution API](/pages/inventory-api-overview#inventory-redistribution "Inventory API Overview") with the UPCs and/or location codes you want to redistribute across. Asynchronous redistribution will then occur at the next Refresh or Adjust update to restore the appropriate amount of inventory to the designated channels.
  </Tab>
</Tabs>
