> For the complete documentation index, see [llms.txt](https://docs.bulkdelivery.pro/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.bulkdelivery.pro/products/add-on-products.md).

# Add-On Products

Sell shovels, tarps & other extras right alongside bulk material, offered only where they make sense

*Your customer just ordered 8 yards of mulch... do they have a pitchfork? A tarp for the driveway? Add-ons let you offer the right extras at exactly the right moment, without cluttering up the delivery booking flow.*

An **Add-on** is a product sold by the item (*each*) rather than by volume or weight. Add-ons ride along with a delivery or pick up of bulk material: no extra delivery fee, no separate delivery date. Your driver or loader simply loads them with the order.

## Create an Add-on

From **Products**, click "Create Product," enter the **Product Name**, then choose the **Product Type**:

* **Bulk Material**: sold by volume or weight, for delivery or pick up.
* **Add-on**: sold by the item (shovels, tarps, etc.) and offered alongside bulk material.

{% hint style="warning" %}
**Product Type can't be changed once the product is created.** Each size of an add-on is its own product. For example, "Tarp (6x8)" and "Tarp (12x16)" are two separate add-ons.
{% endhint %}

Add-on products have most of the same settings as bulk materials ([Images](https://docs.bulkdelivery.pro/products/products.md#images), [Description](https://docs.bulkdelivery.pro/products/products.md), [Checkout Disclaimers](https://docs.bulkdelivery.pro/products/products.md#checkout-disclaimers), [Associated Vendors](https://docs.bulkdelivery.pro/products/products.md#associated-vendors), [Sales Tax Code](https://docs.bulkdelivery.pro/products/products.md#sales-tax-code), In-Stock status, etc.). The Sales Unit, Weight/Volume conversion, and the Delivery/Pick Up price tables are replaced with two add-on panels, described below.

#### Add-on Price & Limits

* **Price (each)**: the price for one item. *Required*.
* **Max Per Load**: the most a customer can add to a single delivery or pick up. Leave blank for no limit.
* **Counts Toward Load** *(optional)*: for heavy or bulky add-ons (a pallet of pavers, a bulk bag), enter the **Weight** (lb or kg) and/or **Volume** (ft³ or yd³) of *one* item so it counts toward the vehicle's load. Leave blank for light items like tarps or shovels.

#### Display Rules

Display Rules decide **which deliveries and pick ups an add-on is offered with**. A tarp might make sense with every delivery, but a mulch fork only with mulch, and a wheelbarrow only on orders of 3+ yards.

**Show this add-on when any of these rules match:** click **Add Rule** to build a rule from up to three conditions:

| Condition       | Options                                                                                 |
| --------------- | --------------------------------------------------------------------------------------- |
| **Material**    | *Any material*, *Is one of these products*, or *Is in one of these categories*          |
| **Quantity**    | *At least*, *Less than*, or *Between* an amount (yd³, ft³, cord, lb, ton, kg, or tonne) |
| **Fulfillment** | *Delivery* or *Pick up*                                                                 |

**Never show it when any of these match:** click **Add Exclusion** to build a rule that *hides* the add-on, no matter what.

A live summary below the rules spells it out in plain English, for example:

> **Offered with:** Brown Mulch or Black Mulch, deliveries\
> **or** Anything in Soil, at least 3 yd³\
> **But never with:** pick ups

{% hint style="info" %}

### How rules are evaluated

* **Every** condition within a rule must match (AND).
* An add-on is offered if **any** rule matches (OR).
* **Exclusions always win.** If an exclusion matches, the add-on is hidden.
* **No rules = not offered.** A brand-new add-on won't show up anywhere until you add at least one rule. Start with *Any material* if you want it offered everywhere.
* Each rule can have only one condition of each type. Need "Delivery *or* Pick up"? Make two rules.
  {% endhint %}

An add-on is offered to customers only when it is **Published** (or Published - Hidden), has a price, is **In Stock**, and one of its Display Rules matches. Out of stock add-ons are always hidden from customers.

When more than one add-on is offered, the most specific come first: add-ons whose rule names the exact product, then the category, then "any material."

## What Customers See

#### In the Cart

Right below their items, customers see a **Need anything else?** box listing the add-ons offered with what's in their cart (4 at a time, with "Show N more"). They can tap a name or photo for a **Quick look** (large photo + full description), then tap **Add**.

* If the cart has more than one item that offers that add-on, BDP asks **"Add (add-on) to which item?"**
* Added add-ons appear inside the item's box with a **− / +** quantity stepper (capped at Max Per Load).
* Each item shows an **Add-On Products** price line, and the cart TOTAL notes **"Includes N add-ons"** under each delivery.
* Any [product disclaimers](https://docs.bulkdelivery.pro/products/products.md#checkout-disclaimers) on the add-on are added to checkout, following the delivery or pick up it's attached to.

If a customer changes their item (different material, quantity, or address) so that an add-on no longer matches its Display Rules, or it goes out of stock, BDP removes it and lets them know: *"Tarp (6x8) was removed from your cart: it isn't available with your items as they are now."*

{% hint style="info" %}
Add-ons are not offered on [Quote Only](https://docs.bulkdelivery.pro/settings/delivery-zones-and-pricing/quote-only-zones.md) requests. Once you send the quote and the customer opens the link, they land in the normal cart and add-ons are offered as usual.
{% endhint %}

#### On the Receipt & Order Page

Each add-on is listed under the item it came with (name, quantity, and price). Add-ons are charged as their own line items in Stripe, using the add-on's own Sales Tax Code.

#### In Text Messages

[Customer SMS Notifications](https://docs.bulkdelivery.pro/pro-tips/customer-sms-notifications.md) mention add-ons automatically: by name when there's one (*"...your order of 8 Yards - Brown Mulch **plus your Tarp (6x8)**"*), or by count when there are several (*"**plus your 3 add-on items**"*).

## Loading Add-ons

* **Delivery orders:** an amber pill on each [Driver Dashboard](https://docs.bulkdelivery.pro/delivery-orders/driver-dashboard.md#add-ons-to-load) card shows how many add-ons to load. On the delivery page, an **Add-Ons to Load** box lists each one, and the driver must tick off every add-on before marking the order "Delivering."
* **Pick up orders:** the [Loader Dashboard](https://docs.bulkdelivery.pro/pick-up-orders/loader-dashboard.md#add-ons) works the same way, and the loader must tick off every add-on before marking the order "Complete."

## Changing Add-ons on an Order

Admins can add, remove, or re-price add-ons from the **Add-ons** section of an order's line edit page. Suggested add-ons (those matching the Display Rules) are listed first, but any add-on can be chosen.

* Add-ons can only be changed while the delivery is **Draft** or **Scheduled** (before it's Assigned).
* Changes update the order's balance; BDP does *not* charge or refund automatically. Use the **Payment** / **Refund** tools on the order page to collect or refund the difference.
* Every change is recorded in the [Order Log](https://docs.bulkdelivery.pro/pro-tips/order-log.md).

## Selling Add-ons on Their Own

At the [POS Kiosk](https://docs.bulkdelivery.pro/pick-up-orders/pos-kiosk.md), add-ons can also be sold by themselves, for example a contractor who just needs a new shovel. These become their own pick up line (*"2 each"*) and go to the [Loader Dashboard](https://docs.bulkdelivery.pro/pick-up-orders/loader-dashboard.md) like any other pick up.

{% hint style="info" %}
Add-ons don't have their own catalog page (yet). Online, they're offered only in the cart alongside bulk material.
{% endhint %}

## Reporting

[Export Orders](https://docs.bulkdelivery.pro/orders/orders.md#export-orders) and the [Sales Reporting API](https://docs.bulkdelivery.pro/api/sales-reporting-api.md) include **Add-Ons** (e.g. *"2 x Spade Shovel, 1 x Heavy Duty Tarp"*) and **Add-Ons Price** columns, and **Total Price** includes add-ons.
