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

# Add Products and Custom Items to Purchase Orders in Eaglecart

> Add catalogue products, individual variants and custom items to an Eaglecart purchase order, and learn what each line shows, including supplier SKU, quantity, cost and notes.

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

[Inventory and warehouse](https://help.eaglecart.com/inventory-warehouse.md)

Add products and custom items

# Add products and custom items

A purchase order can hold products from your catalogue and custom items that aren't in your catalogue at all, such as packaging or a one-off part. Products are added with the shared product modal.

## Before you start

* Choose the **Region** first. Products belong to a region, and changing the region later clears the order's lines.
* Choose the **Destination**. The product modal shows stock at that location, so you're reading the right warehouse's numbers.

## Add catalogue products

1. On the purchase order, click **Add product**. The **Select products** window opens.
2. Search by name, SKU or barcode, or scan a barcode into the search field.
3. Tick the products or variants you want:
   * Tick a variant to add just that one, for example two sizes out of nine.
   * Tick the product itself to take all of its variants.
   * A product without variants is a single row.
4. Keep searching and ticking. Your picks stay ticked while you search for something else.
5. Click **Save**. Everything you ticked lands on the order in one go, and a message confirms how many were added.
6. Set the **Qty** and cost for each line.

See [How the product modal works](https://help.eaglecart.com/products/product-modal.md) for the controls it shares with every other page.

## Product modal in purchase orders

On a purchase order, the product modal follows purchasing rules rather than selling rules:

* **Every status:** you can select products that are **Active**, **Draft**, **Unlisted** or **Upcoming**.
* **No sales channel limit:** products don't need to be assigned to any sales channel.
* **Buy before you sell:** you can order a product before it's available for sale.
* **Variants one by one:** each variant appears as its own row to select.
* **Stock columns:** **Available** and the destination's location column appear where they apply.
* **No options:** product customization options aren't used when buying from a supplier.

### What else the modal shows on a purchase order

* **Stock at your destination:** the modal shows stock at the destination you chose, labelled with the location's name, for example **Available in sharjah**. It refreshes when you change the region or destination.
* **Products from every sales channel:** what you buy from a supplier has nothing to do with where you later sell it, so a purchase order isn't limited to one sales channel. A product doesn't need to be assigned to the online store, POS or Workshop to be ordered.
* **Products in any status:** you can order stock for a draft or upcoming product you haven't launched yet. That's often exactly why you're ordering it.
* **Costs come across,** because a purchase order is about what you pay.

> [!NOTE]
>
> Variants and options are different things. Variants, such as Black / M, are separately stocked versions of a product, and you can order them individually. Options, such as engraving text or a gift wrap add-on, aren't used on purchase orders. See [Understanding variants and options](https://help.eaglecart.com/products/understanding-variants-and-options.md).

## Add a custom item

Use **Add custom item** for anything not in your catalogue: a one-off part, packaging, a tooling charge or a sample.

1. Click **Add custom item**.
2. Give it a name, SKU, quantity and cost.
3. Decide whether to mark it as **New**:
   * **Marked as New:** the item is created as a real product in your catalogue when the order is placed. Use this for a product you'll sell or stock from now on.
   * **Not marked:** the item exists only on this purchase order. Use this for things like packaging or a sample you won't sell.

New items carry a **New** badge on the line.

## What's on each line

| Part | What it is |
| - | - |
| **Product** | The image and name, with the variant underneath, both linking to the product page. |
| **Supplier SKU** | The supplier's own code for this item, which may differ from your SKU. It's printed on the order so the supplier recognises what you're asking for. |
| **Qty** | The quantity you're ordering. Editable until the order ships. |
| **Cost** | What you pay per unit, in the order's currency. The gear icon opens the cost settings: the cost tax rate, and whether to use the product cost or a custom cost. |
| **Total** | Quantity × cost, plus tax. |
| **Add note** | A note for this line only: a finish, a spec sheet link, the supplier's own product code. |
| Remove | Takes the line off the order. |

See [Product costs, taxes and additional charges](https://help.eaglecart.com/inventory-warehouse/costs-taxes-and-charges.md) for the cost settings.

## When lines can change

* **Draft and Ordered:** add and remove lines, and change quantities and costs.
* **Shipped onwards:** the product list and quantities are locked. While the order is **Shipped**, costs, charges and dates stay editable. If fewer units arrive than you ordered, record that on the receiving screen rather than editing the order down. See [Partial deliveries, rejected items and over-receiving](https://help.eaglecart.com/inventory-warehouse/partial-deliveries-and-rejections.md).

## Example: restocking two jacket sizes plus packaging

You need more Yellow / M and Yellow / L jackets, plus 200 shipping bags:

1. Click **Add product**, search "jacket" and tick only **Yellow, M** and **Yellow, L**. Click **Save**.
2. Set **Qty** to 50 and 30.
3. Click **Add custom item**, name it "Shipping bags", enter quantity 200 and the cost, and leave it unmarked so it doesn't become a product.

## Troubleshooting

**A product doesn't appear in the product modal.** Check the region. Products belong to a region, and the modal shows the products available in the order's region, as the line at the top of the modal says. Also check the spelling or try the SKU.

**The stock figures in the modal look wrong.**
They're for the selected **Destination**. Change the destination if you're looking at the wrong location.

**I can't change a quantity.**
The order has been moved to **Shipped**. Revert it to **Ordered** if you need to change quantities before anything has been received.

## Related guides

* [How the product modal works](https://help.eaglecart.com/products/product-modal.md): search, variants and the columns.
* [Create a purchase order](https://help.eaglecart.com/inventory-warehouse/create-purchase-order.md): the rest of the order page.
* [Product costs, taxes and additional charges](https://help.eaglecart.com/inventory-warehouse/costs-taxes-and-charges.md): cost settings and charges.
* [Create a product](https://help.eaglecart.com/products/create-a-product.md): add a product to your catalogue first.


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