# Basket Addons

These are assigned on a 1:1 basis against products. Examples include gift wrap, disposal services and other similar services.

Item Addons can be given prices, SKU codes and other important information.

### Setup

#### Details

<table border="1" id="bkmrk-field-purpose-code-e" style="border-collapse: collapse; width: 100%; border-width: 1px;"><colgroup><col style="width: 50.053%;"></col><col style="width: 50.053%;"></col></colgroup><thead><tr><td>Field</td><td>Purpose</td></tr></thead><tbody><tr><td>Type</td><td>*Choose from '[Item Addon](https://bookstack.iconography.co.uk/books/addons/page/item-addons "Item Addons")' or Basket Addon*</td></tr><tr><td>Name</td><td>*Enter the Name of your Addon - this will be displayed to the customer as a choice when completing a purchase*</td></tr><tr><td>Description</td><td>*This is intended to be a short description, which is displayed to the customer; this should be specific to this Addon*</td></tr><tr><td>Surcharge Price (inc VAT)

</td><td>*Enter the price of the surcharge (optional)*</td></tr><tr><td>Surcharge Cost Price (ex VAT)</td><td>*Enter the cost price of the surcharge (optional)*

*This is solely used for margin reporting, as it is not possible to order an Addon from a Supplier using the Purchase Order module*

</td></tr><tr><td>Surcharge Label</td><td>*Enter a label for the surcharge (optional)*

<p class="callout info">*The surcharge will display as a separate order line with this label*</p>

</td></tr><tr><td>VAT</td><td>*Select the VAT status of the surcharge - choose from:*

- *Standard*
- *Reduced*
- *Zero*
- *Exempt*

*VAT rates for Standard and Reduced are controlled via [Countries](https://bookstack.iconography.co.uk/books/countries "Site Settings")*

</td></tr><tr><td>Send to Staingard</td><td>See [Staingard ](https://bookstack.iconography.co.uk/books/integrations/page/staingard)for more information

</td></tr><tr><td>Live?</td><td>*Toggles whether the Addon is Live or not*</td></tr><tr><td>Allow Returns</td><td>*Select to allow returns (refunds/cancellations) of the Addon*</td></tr><tr><td>Allow Customer Note</td><td>*Select to allow the customer to enter a personalised message at checkout (ideal for gift labels)*</td></tr><tr><td>Customer Note Prompt</td><td>*The prompt that will show to the customer instructing them what to enter as the Customer Note*</td></tr></tbody></table>

#### Pricing Tiers

Pricing for the Group Addons are managed via tiers. The price of the Addon is based on the total value of items in the basket where the Customer has opted into the Addon.

##### Example

A customer has three items in their basket priced at £500, £250, and £125 respectively.  
Each item offers the ‘Insurance’ Addon as an optional extra.

The customer chooses to apply the Insurance Addon to Item 1 (£500) and Item 3 (£125), but not to Item 2.

Therefore, the total value of goods used to calculate the Addon price is:  
£500 + £125 = £625

##### Setup

<table border="1" id="bkmrk-field-purpose-code-t" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 50%;"></col><col style="width: 50%;"></col></colgroup><thead><tr><td>Field</td><td>Purpose</td></tr></thead><tbody><tr><td>Code</td><td>*The SKU code of that tier (each tier must have a unique code)*

<p class="callout info">*There may be limitations on the data in this field if an integration is required, e.g. [Staingard](https://bookstack.iconography.co.uk/books/integrations/page/staingard "Staingard").*</p>

</td></tr><tr><td>Basket Value</td><td>*The maximum basket value for that tier*</td></tr><tr><td>Price</td><td>*The price charged to the Customer for that tier*</td></tr><tr><td>Cost Price</td><td>*The cost price for that tier*</td></tr><tr><td>VAT</td><td>*Select the VAT status of the surcharge - choose from:*

- *Standard*
- *Reduced*
- *Zero*
- *Exempt*

*VAT rates for Standard and Reduced are controlled via [Countries](https://bookstack.iconography.co.uk/books/countries "Site Settings")*

</td></tr></tbody></table>

An example setup is below:

[![image.png](https://bookstack.iconography.co.uk/uploads/images/gallery/2025-10/scaled-1680-/hipimage.png)](https://bookstack.iconography.co.uk/uploads/images/gallery/2025-10/hipimage.png)

#### Assignment

Use the [Assignment Rules](https://bookstack.iconography.co.uk/books/addons/page/assignment-rules "Assignment Rules") to assign this Addon in bulk, or altatively manage this via individual [Products](https://bookstack.iconography.co.uk/books/categories/page/addons "Addons") or in bulk via [CSV import/export](https://bookstack.iconography.co.uk/books/import-export/page/product-data "Product Data").

### How it displays

#### eCommerce

When assigned to a product, the customer will be prompted to opt in. If there are multiple Addons from the same group (e.g. pink or blue giftwrap), a drop down will be shown. Otherwise, it will be a simple tickbox.

This will display near the add to basket button on the [Product Detail Page](https://bookstack.iconography.co.uk/books/product-detail-page "Product Detail Page").

The price will adapt based on previous selections, e.g. if a customer has already opted into the Addon for an item already in the basket, this will adjust the price on the current product, up to and including offering the Addon for free.

It will also display as an option at checkout. Pricing will dynamically change on all Products based on selection.

#### POS

It will also display as a pop up within the [POS](https://bookstack.iconography.co.uk/books/epos/page/adding-add-ons-to-a-sales-order-in-the-epos "POS").

The price will adapt based on previous selections, e.g. if a customer has already opted into the Addon for an item already in the order, this will adjust the price on the current product, up to and including offering the Addon for free.