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

# How to add a consumable to every order of a listing

> Attach a consumable to a listing as a required add-on with a fixed quantity, so every new order of the listing carries it as its own line.

> [card] [Open in TWICE Admin](https://admin.twicecommerce.com/catalog/listings)
>
> catalog/listings

Attach a consumable to a listing as a required add-on, so every new order of that listing carries it as its own line: wash tablets with a carpet cleaner, a filter with a coffee machine, a towel set with a sauna booking. [Recommendations](https://www.twicecommerce.com/docs/catalog/listings/recommendations.md) explains each add-on setting.

## Prerequisites

> [!WARNING]
>
> **Required permissions:** **Create and edit listings** to attach the add-on (`catalog:listing:manage`). Every built-in role holds it, Member included. See [Users & Roles](https://www.twicecommerce.com/docs/settings/users-roles.md).

> [!NOTE]
>
> **Have ready before you start:**
>
> * **A listing for the consumable**, with **Only available as add-on** switched on and a **Purchase price** saved. Enter 0 as the price if you do not charge for it. See [Create an add-on listing](https://www.twicecommerce.com/docs/guides/catalog/create-an-addon-listing.md).
> * **How many go with the listing**, such as two tablets.

## The walkthrough

**1. Open the listing**

Select **Catalog** in the left sidebar. The **Listings** table opens. Search for the listing the consumable goes with in **Search all listings**, then click its row. The listing opens on its **General** tab.

![The Listings table under Catalog searched down to the parent listing, with Catalog, the search field and the listing's row highlighted](https://mintcdn.com/twicecommerce/XzdcmB1NxT-YAMjE/images/guide-add-a-consumable-to-every-order-01.webp?fit=max\&auto=format\&n=XzdcmB1NxT-YAMjE\&q=85\&s=56eff8aec0e4ca78b919e9823aed2712)

**2. Open Recommendations**

Click **Recommendations** in the tab row. The tab shows two cards: **Add-ons**, the listings offered with this one, and **Related listings**.

![The listing's Recommendations tab with the empty Add-ons card highlighted and Related listings below it](https://mintcdn.com/twicecommerce/XzdcmB1NxT-YAMjE/images/guide-add-a-consumable-to-every-order-02.webp?fit=max\&auto=format\&n=XzdcmB1NxT-YAMjE\&q=85\&s=77c18f852b9720adb579669d0c0c308e)

**3. Click Add**

Click **Add** at the top right of the **Add-ons** card. The **Add add-on** panel opens on the right, with a search box and a list of your listings.

![The Add add-on panel open on the right, with a search box and the account's listings under it](https://mintcdn.com/twicecommerce/XzdcmB1NxT-YAMjE/images/guide-add-a-consumable-to-every-order-03.webp?fit=max\&auto=format\&n=XzdcmB1NxT-YAMjE\&q=85\&s=43b05d185aaaba0858fa1440169ca29c)

**4. Pick the consumable**

Type the consumable's name in the search box at the top of the panel, then click it in the list. The panel changes to **Configure add-on**, with the consumable's name under the title.

![The Add add-on panel searched down to the consumable, with the search box and its row highlighted](https://mintcdn.com/twicecommerce/XzdcmB1NxT-YAMjE/images/guide-add-a-consumable-to-every-order-04.webp?fit=max\&auto=format\&n=XzdcmB1NxT-YAMjE\&q=85\&s=47480295ba7fccda8f33f94346e93132)

**5. Fix the quantity**

Open **Quantity mode** and choose **Fixed**, so the customer cannot change how many come with the listing. Enter that number in **Default quantity**.

![The Configure add-on panel with Quantity mode at Fixed and Default quantity at 2, both highlighted](https://mintcdn.com/twicecommerce/XzdcmB1NxT-YAMjE/images/guide-add-a-consumable-to-every-order-05.webp?fit=max\&auto=format\&n=XzdcmB1NxT-YAMjE\&q=85\&s=bade363c68f6f0b2ccc32c1d147fe8ab)

**6. Make it required**

Leave **Offer as** at **Buy**, which sells the consumable rather than booking it. Switch on **Required**. **"Customers cannot uncheck this add-on"** appears under the switch.

![The Configure add-on panel with Offer as at Buy, Required switched on and Customers cannot uncheck this add-on under it](https://mintcdn.com/twicecommerce/XzdcmB1NxT-YAMjE/images/guide-add-a-consumable-to-every-order-06.webp?fit=max\&auto=format\&n=XzdcmB1NxT-YAMjE\&q=85\&s=eb39d3d6f89b79445bd7be3c3e581c1e)

**7. Add it**

Click **Add** at the bottom of the panel. The panel closes, and the **Add-ons** table lists the consumable with **Fixed** under **Quantity mode**, **Yes** under **Required** and **Buy** under **Type**.

![The Add-ons table listing the consumable with Fixed, a quantity of 2, Yes under Required and Buy under Type](https://mintcdn.com/twicecommerce/XzdcmB1NxT-YAMjE/images/guide-add-a-consumable-to-every-order-07.webp?fit=max\&auto=format\&n=XzdcmB1NxT-YAMjE\&q=85\&s=5cde55febea450663503ab5582bcb81d)

## How do I know it worked?

* **The Add-ons table lists the consumable**, with **Required** at **Yes**.
* **The listing's page in your online store shows the consumable as included**, with a tick in place of a box to clear and no quantity to change.
* **A new order of the listing carries the consumable** as its own line on the order's **Summary** tab, reading **Add-on to** and the listing's name.
* **Staff adding the listing to an order in the admin** find the consumable ticked under **Add-ons**, and can clear it for an order that does not need it.

## Troubleshooting / common pitfalls

> [accordion] The consumable is missing from new orders
>
> The consumable listing has no **Purchase price**, so there is no price to add it at. Save one, 0 if you do not charge for it. See [Create an add-on listing](https://www.twicecommerce.com/docs/guides/catalog/create-an-addon-listing.md).

> [accordion] Customers cannot add the listing to the cart
>
> The consumable has a stock rule and has run out. A required add-on that cannot be supplied blocks the listing it is attached to. Add stock, or delete the rule on the consumable's **Fulfilment** tab. See [Fulfilment](https://www.twicecommerce.com/docs/catalog/listings/fulfillment.md).

> [accordion] Orders taken before the change do not have it
>
> **Required** applies when the listing is added to an order. Add the consumable to an existing order from its line items. See [Order Line Items](https://www.twicecommerce.com/docs/orders/order-tabs/line-items.md).

## Related articles

> [card] [Recommendations](https://www.twicecommerce.com/docs/catalog/listings/recommendations.md)
>
> Every add-on setting on the Recommendations tab, control by control.

> [card] [Create an add-on listing](https://www.twicecommerce.com/docs/guides/catalog/create-an-addon-listing.md)
>
> Build the consumable's own listing, its price and its add-on settings.

> [card] [Record a cost or income](https://www.twicecommerce.com/docs/guides/inventory/record-a-cost-or-income.md)
>
> Put what a consumable costs into a stock item's profitability, by hand.

> [card] [Order Line Items](https://www.twicecommerce.com/docs/orders/order-tabs/line-items.md)
>
> Add an add-on to an order that is already placed.


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