Addons
An Addon is an optional, supplementary feature or service that can be added on top of a rate plan. Addons allow you to offer modular extras — like premium support, additional storage, or advanced analytics — that customers can subscribe to alongside their base plan.
Addon vs Charge
| Concept | Billing Dimension | Example |
|---|---|---|
| Addon | Currency + billing frequency (recurring) | “Premium Support — $49/month” |
| Charge | Currency only (one-time) | “Setup Fee — $199” |
Addons are recurring and tied to a billing frequency; charges are one-time fees with no billing cycle.
Addon Hierarchy
Product
├── Rate Plan
│ ├── Rate Plan Prices
│ ├── Linked Addons ← attached to a specific rate plan
│ └── Linked Charges
└── Standalone Addons ← available across all rate plansAn addon can be linked to one or more rate plans (appears on the rate plan card) or exist as a standalone addon at the product level.
Managing Addons
Create an Addon
- On the product details page, scroll to the Addons & Charges section.
- Click Add Addon.
- Fill in the form:
General Information
| Field | Required | Description |
|---|---|---|
| External Name | No | Customer-facing name shown on pricing tables, invoices, quotes, and the self-serve portal. |
| Internal Name | Yes | Internal identifier used within BillHive. Must be unique within the product. |
| Addon Key | Yes | Unique API identifier. Auto-generated from the name in create mode. Read-only after creation. |
| Unit of Measurement | No | Specifies the unit for quantity-based pricing (e.g., seats, GB, API calls). |
| Description | No | Describes what the addon includes. |
Visibility
| Field | Default | Description |
|---|---|---|
| Visible in Self-Serve Portal | Off | When enabled, customers can view and add this addon via the hosted self-serve portal. |
- Click Create Addon.
Edit an Addon
- On the product details page, click the pencil icon on the addon card.
- The edit form opens with the same fields as creation (except Addon Key is read-only).
- Make changes and click Update Addon.
After saving, you are redirected back to the product details page.
Activate / Deactivate an Addon
- Use the status controls on the addon card or the addon details page.
- Only active addons are available for new subscriptions.
Delete an Addon
- Click the trash icon on the addon card.
- Confirm the deletion when prompted.
- Addons linked to active subscriptions cannot be deleted.
Addon Cards on Product Details
Each addon is displayed as a card in the Addons & Charges section showing:
- Addon name and status badge (Active / Inactive / Draft).
- “Linked” badge if the addon is attached to a rate plan.
- Price for the currently selected currency and billing frequency, or a Set Price button if no price exists.
- Description (truncated to two lines).
- Action buttons: Edit Addon, Add Pricing, Delete Price.
Linking Addons to Rate Plans
On a rate plan card, use the Link dropdown and select Link Addon to attach an existing addon. Linked addons appear on the rate plan card and are automatically included when a customer subscribes to that plan.