Skip to main content
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.

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.

The columns

Some columns only appear when the page needs them.

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

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.

Keep reading