Skip to main content

Open in TWICE Admin

catalog/listings
Build an add-on in two passes. Create the listing and set its Add-on Settings tab, then attach it from each parent listing that should offer it. Nothing appears at checkout until the second pass is done. Follow create and publish a listing for the tab-by-tab walkthrough every listing shares. Read on here for what is add-on specific.

Prerequisites

Required permissions: Create and edit listings, held from Member up, covers the listing and its Add-on Settings tab. Setting its price needs Set prices, which Manager, Admin and Owner hold.
Decide two things first.
  • Is it worth buying alone? A tube of sealant is. A damage waiver is not. That decides Only available as add-on.
  • Does its price depend on its parent? Delivery costs the same whatever is in the van. Insurance scales with the value covered. That decides the pricing mode.

The walkthrough

1

Create it as an ordinary listing

Create the add-on the way you create any listing, then price it on the Pricing tab. Choose a sales price for a fee or a consumable, and a booking price only if it is genuinely taken for a period.Name it as the customer reads it in a checkout list, next to the thing it attaches to. Write Damage waiver rather than Insurance product 2.
2

Leave the Stock items card empty when nothing physical backs it

Open the Fulfilment tab and add no rule to the Stock items card for delivery, insurance or a service fee. The card then reads “No stock items reserved or deducted when the listing is purchased”, and the listing stays sellable whatever your stock does.Read an empty rule list as the setting itself. There is no separate switch to find.Add a rule for a consumable. Sealant, wax and spare tubes run out, so they need a rule like any sales listing.
3

Hide it from browsing when it makes no sense alone

Turn on Only available as add-on under Add-on Settings → Visibility → Sales visibility. The listing is then hidden from storefront browsing and appears only as an add-on on other listings.Turn it on for a waiver or a cleaning fee. Leave it off for something a customer might come looking for, and note that a consumable often belongs in both places.Never unpublish the listing instead. An unpublished listing cannot be offered as an add-on either.
4

Choose how it is priced when attached

Set When sold as add-on under Add-on Settings → Pricing when sold as add-on:Enter a whole number from 1 to 200 in Percentage. It applies to the parent’s price per unit and rounds to the nearest minor unit, so a waiver at 10 % moves with the parent’s duration and quantity on its own.Build insurance this way. Look for no separate insurance feature, because there is none.
5

Attach it from the parent listing

Open the parent listing, select Recommendations, and use Add add-on on the Add-ons card, the one described as “items offered as add-ons to this listing”. Attachment happens here, never from the add-on itself.Expect to repeat this per parent. An add-on attached to one listing is offered on that listing only, and there is no catalog-wide add-on.Never make a listing its own add-on. The admin rejects it.
6

Set the per-attachment controls

Set these on each attachment, so the same add-on can behave differently on different parents:Use Required sparingly. A required add-on is a price increase the customer cannot decline, and it counts into the parent’s advertised starting price.
7

Attach it twice when it sells both ways

Add the same add-on to one parent twice when it should be bookable and buyable, once with Offer as set to Book and once to Buy. The pair is what the customer picks between.Expect a rejection on an exact repeat. The same add-on on the same parent with the same Offer as value is a duplicate.

How do I know it worked?

  • The add-on is absent from storefront browsing while Only available as add-on is on.
  • It appears on the parent listing’s page, among the add-ons a customer can pick.
  • A percentage-priced add-on moves with its parent. Price the parent for two days, then for a week, and watch the waiver follow.
  • A Required add-on cannot be unticked, and shows in the total from the start.

Troubleshooting / common pitfalls

Only available as add-on is off.What to do: turn it on from the add-on’s Add-on Settings tab. Do not unpublish the listing instead, because an unpublished listing cannot be offered as an add-on either.
The add-on is on its own price tables, which is one flat price whatever the parent costs.What to do: switch When sold as add-on to the percentage mode and set Percentage. It then follows the parent’s duration and quantity.
Two causes. Percentage was never filled in, so there is no figure to apply. Or the parent has no resolved price yet, which is normal on a booking parent before the customer picks dates.What to do: set Percentage on the add-on, then re-check the parent with dates chosen.
It is not attached to any parent. The Add-on Settings tab makes a listing able to be an add-on, and attaches it to nothing.What to do: open the parent’s Recommendations tab and add it there, once per parent.
The add-on listing was archived. An archived add-on drops out of every parent’s add-on rows, with no warning on the parents themselves.What to do: unarchive the add-on listing. Check the parents afterwards, since nothing on them recorded the absence.
It has a stock rule that matches nothing. A service has no stock items, so any rule at all filters everything out and leaves availability at zero.What to do: delete the rule and leave the Stock items card empty. That is what “nothing physical backs this” looks like.
Set it once, on the add-on listing. The price lives there, and every parent picks the new figure up.What to do: edit the add-on’s own price or its Percentage. Each attachment carries only quantity, offer mode, pre-selection, variant defaults and whether it is required.
The attachment is marked Required, or it is pre-selected with a default quantity.What to do: decide deliberately. Required is legitimate for a genuine mandatory fee, and a support ticket when it comes as a surprise.

Create a rental listing

The parent this might attach to, when it comes back.

Create a sales listing

The parent this might attach to, when it does not.

Add-ons

The Add-on Settings tab reference, field by field.

Recommendations

Where attachments and related listings are managed.