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

# How the Eaglecart Product Modal Works

> The Eaglecart product modal explained: search and scanning, variants and options, status labels, stock and location columns, prices, and how region, sales channel and status rules decide which products appear.

[Help Center](https://help.eaglecart.com/introduction.md)

[Products](https://help.eaglecart.com/products.md)

How the product modal works

# How the product modal works

The same product modal opens wherever the Eaglecart admin asks you to choose products: purchase orders, invoices, quotations, Workshop jobs and other product-selection windows. The controls work the same way everywhere. What changes is which products the page offers and which columns it shows.

## Search and scan

* **Type to search** by product name, SKU or barcode in the search box at the top.
* **Scan a barcode** into the search box. Most scanners type the code and press Enter, so the item is found the same way as typing its code. No setup is needed.
* **Search covers every eligible product,** not just the ones visible when the modal opens. Results load in pages as you scroll, so a large catalogue stays quick.
* **Search stays within the page's rules.** Every search uses the same region, sales channel and status rules as the first load, so you can't search your way to a product the page doesn't allow.

## Products and variants

* **Variants are nested** under their product, each with its own SKU, image, stock and price. Tick individual variants to take two sizes out of nine without taking the rest.
* **Tick the product itself** to take all of its variants.
* **A product with no variants** is a single row.
* **A variant without its own image** shows the product's main image, so no row is blank.

## Options

Where the page supports them, products with options show their selectors in the modal, with each choice's price and any rules, such as "choose at least 2". Pages that only need the product itself don't show options. See [Introduction to product options](https://help.eaglecart.com/products/introduction-to-options.md).

## Status indicators

Each product shows its status:

* **Active** products show no label. That's the normal case.
* **Draft**, **Unlisted** and **Upcoming** products carry a coloured label naming the status, so you can see straight away that a product isn't active.

Which statuses appear depends on the page. See [Product visibility, sales channels and regions](https://help.eaglecart.com/products/visibility-sales-channels-and-regions.md#status).

## The columns

Some columns only appear when the page needs them.

| Column | What it shows |
| - | - |
| **Available** | The stock available to sell. Unavailable stock, such as damaged units, isn't included. |
| **Available in \[location]** | Stock at one location, labelled with its name, for example **Available in Sharjah**. It appears when the page works with a specific location, such as a purchase order's destination. |
| Price | The selling price for the page's region, with that region's tax treatment, in the region's currency. |

## Prices, tax and currency

* **Region:** prices follow the region the modal is working in, with that region's tax treatment and currency.
* **Product tax override:** where a product has its own tax override, it's used instead of the region's rate.
* **Other currencies:** when the region isn't your store's default, figures are converted into the region's currency.

## Select and save

* **Your picks are kept as you search.** Search "shirt", tick three, search "cap", tick two, and all five come across.
* **Items already on your list show ticked,** so you can untick one without looking for it elsewhere.
* **The count** at the bottom shows how many items are selected, for example "5 items selected".
* **Save** adds everything in one go. **Cancel** closes the modal without changes.

## Why a product might not appear

The modal only shows products the current page allows. When a filter is in use, the modal says so.

### Sales channel

When a page works within a sales channel, such as Workshop, the modal shows only products assigned to that channel and names the channel at the top. If nothing matches, the message names the channel and links to your products. The usual cause is a product that was never added to that channel. Open the product and tick the channel under **Sales channels**.

### Region

When your store has more than one region, the modal names the region it's working in, for example "Only products available in United Arab Emirates are shown." Tick the region on the product under **Regions** to include it. When no region is set, products from every region appear and prices follow your default region.

### Status

Pages can limit which statuses appear. A page that sells to a customer may only offer some statuses, while a purchase order accepts all four.

## How different pages use the modal

Each page sets its own rules for region, sales channel and status:

* **Purchase orders:** every status, no sales channel limit, no options. See [Add products and custom items](https://help.eaglecart.com/inventory-warehouse/add-products-to-purchase-orders.md#product-modal-in-purchase-orders).
* **Quotations and invoices:** products for the document's region. See [Add products, custom items and discounts](https://help.eaglecart.com/finance/quotation-products-custom-items-and-discounts.md) and [Invoice products, prices and tax](https://help.eaglecart.com/finance/invoice-products-prices-and-tax.md).
* **Workshop jobs:** products assigned to the Workshop sales channel. See [Add products to a job](https://help.eaglecart.com/workshop/add-products-to-a-job.md).

The POS app has its own product catalogue rather than this modal, but it follows the same idea: only products assigned to the **Point of Sale (POS)** channel appear. See [Make products available in POS](https://help.eaglecart.com/pos/products-in-pos.md).

## Troubleshooting

**My product exists, but I can't select it in Workshop or POS.** It probably isn't assigned to that sales channel. Open the product, tick **Workshop** or **Point of Sale (POS)** under **Sales channels**, and save.

**The modal says no products are available in a region.** The products aren't set to sell in that region. Tick the region on each product under **Regions**.

**Available shows less than I have on the shelf.** Unavailable stock, such as damaged or quality-control units, isn't counted as available. See [Available and unavailable stock](https://help.eaglecart.com/inventory-warehouse/unavailable-stock.md).

## Keep reading

* [Product visibility, sales channels and regions](https://help.eaglecart.com/products/visibility-sales-channels-and-regions.md): assign products to channels and regions.
* [Add products and custom items](https://help.eaglecart.com/inventory-warehouse/add-products-to-purchase-orders.md): the modal on a purchase order.
* [Understanding variants and options](https://help.eaglecart.com/products/understanding-variants-and-options.md): the difference between the two.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.