Configuration
Add-on settings
Section titled “Add-on settings”Open Add-ons → Manage add-ons → Build-a-Box Bundles → Settings.
| Setting | Default | Description |
|---|---|---|
| Enable | On | Turns box builders and box prices on or off without uninstalling. While off, box pages show as normal product pages and box lines already in carts get regular prices. |
| Add the box name to item names | On | Item lines show as “Product (Box name)” in the cart, orders, invoices and e-mails, so the customer and your packers see which items belong together. |
| Show the saving in the builder | On | Shows “You save” in the box tray when the box price is lower than the regular total. |
| Products per builder (maximum) | 120 | Upper limit of products one box page lists (4 to 500). |
| License key | empty | Your Kavio Labs license key or CS-Cart Marketplace license number. |
Open Marketing → Build-a-Box and click New box.
1. Box page
Section titled “1. Box page”Choose the product whose page shows the builder. Create a product for it first, for example “Movie Night Box” or “Build your snack box”, with a good image and a short text. Its own price is added once per box as a packaging fee: set it to 0 if you do not charge for the box. Its quantity counts boxes, so either give it enough stock (for example the number of physical gift boxes you have) or switch its inventory tracking off.
2. Box sizes and prices
Section titled “2. Box sizes and prices”Add one row per size:
| Price type | Example | What the customer pays |
|---|---|---|
| Fixed box price | 3 items, 29.99 | 29.99 for any 3 items |
| Percent off the items | 5 items, 15 | the regular total of the 5 chosen items minus 15% |
| Regular prices | 12 items | the regular total (a box without a discount) |
The box price is split over the item lines in proportion to their regular prices, to the cent. Item prices are the prices of the customer’s user group, without catalog promotions.
3. What goes in the box
Section titled “3. What goes in the box”- Products from these categories: with Include subcategories on, products of child categories count too. With two or more categories the builder shows a tab per category.
- Plus these products: hand-picked products, shown first in the order you entered.
- Never put these products in the box: exclusions.
Products with product options, disabled or hidden products and box pages of other boxes never appear. On Multi-Vendor only products of the box page’s vendor appear.
Rules and look
Section titled “Rules and look”| Option | Description |
|---|---|
| The same product may fill more than one slot | Off: each product once per box. |
| Maximum of one product per box | 0 = no limit. |
| Hide products that are out of stock | Off: they show greyed out. |
| Customers can add a gift message | A text field in the box tray (300 characters). |
| Sort by | Position (as entered), name, price, popularity or newest. |
| Products per row (desktop) | 3, 4 or 5. Tablets show 3, phones 2. |
Multi-Vendor
Section titled “Multi-Vendor”Vendors open Marketing → Build-a-Box in the vendor panel and manage boxes of their own products. A box only takes products of its vendor, so the whole box goes to one vendor suborder.
CS-Cart Ultimate
Section titled “CS-Cart Ultimate”A box belongs to the storefront of its box page product. Products available in that storefront can go into the box.
Look and colors
Section titled “Look and colors”The builder uses your theme fonts and buttons and its own neutral palette. To change the accent color, add to your theme CSS:
.kv-bab-builder { --kv-bab-accent: #0f766e; --kv-bab-accent-soft: rgba(15, 118, 110, .1); }