Skip to content
Birdhouse

Configure Addons

Add-ons are optional extras users can add to their plan — for example, glass coverage for household insurance. Each add-on appears as a toggleable card. When selected, the pricing system calculates the additional cost.

Steps

Section titled “Steps”
  1. Open your Quote-Page in Strapi
  2. In the content section, add an addons component
  3. For each add-on, add an entry to the addonItems array with:
Field Purpose Example
addonKey Unique key sent to the pricing engine. Must match what the pricing team configured. BROKEN_GLASS_COVERAGE
title Display name Broken glass
description Short explanation Covers repair and replacement of glass items
icon Icon image (optional) — set src (URL) and alt (alt text)
availablePlans Restrict to specific plans (leave empty for all) ["BASIC", "EXTENDED"]
label Optional badge (see below) { "text": "Extended plan only", "variant": "warning" }
range Optional slider for numeric addon customization (see below)
  1. Save the Quote-Page

Slider add-ons

Section titled “Slider add-ons”

Some add-ons need a numeric value (e.g., bike coverage amount). Add a range sub-component to the addon item:

Field Purpose Example
optionKey Answer key for the slider value bikeInsuredSum
minimumValue Minimum value 1000
maximumValue Maximum value 3000
step Increment (leave empty for continuous)
defaultValue Initial value
sliderLabel Label on the slider track

When the user enables the addon, the slider appears and its value is sent to the pricing engine alongside the addon key.

Labels

Section titled “Labels”

Add a badge label to highlight add-ons:

Field Purpose
text Label text (e.g., "Extended plan only")
variant Visual style: primary, secondary, success, warning, error, info, neutral, or outline variants

How add-ons work at runtime

Section titled “How add-ons work at runtime”
  • Add-ons appear as selectable cards on the quote page
  • When a user selects an add-on, its addonKey is sent to the pricing engine
  • The Quote-Price calculation uses the key to adjust the premium
  • Selected add-ons are included in the checkout summary

See also

Section titled “See also”