Help Center › Getting Started › Quick Start Guides › Catalog

Create Components

··

Last updated on Aug 29, 2026

Components are the line items you charge for alongside a product, whether that is a per-seat charge, metered usage, or a flat add-on. Which type you create decides how the charge behaves, so start by matching what you sell to a component type, then follow the steps for that type.

Quantity-Based On/Off Prepaid Usage Metered Usage

Component types and what each one suits

Component Type	Best for
Metered usage	Any usage-based items, billed in arrears
Prepaid usage	Any usage-based items that are advanced, and billed upfront
Quantity-based	Any recurring items with a quantity of 0, 1, 2+
Quantity-based One-time	Any non-recurring items with a quantity of 0, 1, 2+
On-off	Any recurring items with a quantity of 0 or 1

Summary - Create a quantity-based component (one-time or recurring)

Feature: Component
You Need: Access to your company's price book
Code: None
Difficulty: ◉◎◎◎◎

1. Create new component

Open the Products page and select the Components tab.

the Products page with arrows to the Components tab and the Create Component button

2. Select quantity-based component (one-time or recurring)

Choose whether the charge recurs each billing period or applies once.

the Create Component type chooser with arrows to the two Quantity Based options

3. Set component details

Name the component and set the identifiers, unit name and description that travel with it.

a Component Details form with name, API handle, accounting code, item category, unit name and description fields

Field	Description
Component Name	(Required) The name of your Component. This shows as a line item on your customer's invoices.
API Handle	(Optional) Developers can make API requests to create subscriptions that have components. They use the component's API handle in the API request.
Accounting Code	(Optional) A read-only field.
Item Category	(Optional) A read-only field.
Unit Name	(Required) A singular unit name. If you sell messages, enter "message" without the s.
Description	(Optional) A description of your Component. Shows on public signup pages and in the Billing Portal, and doesn't show on customer invoices.

4. Create a component pricing scheme

Choose how the price scales with the quantity a customer buys.

a Component Pricing panel with the Per Unit scheme selected, a price per unit and a tax-inclusive choice

Option	Description
Per Unit	Sets pricing to Per Unit. The component is charged at a single price per unit.
Volume Based	Sets pricing to Volume Based. This allows multiple price brackets. A customer who buys into a bracket is charged that bracket's price per unit.
Tiered	Sets pricing to Tiered. This allows multiple price brackets. A customer who buys into a bracket is charged that bracket's price per unit plus the previous bracket's price per unit.
Stairstep	Sets pricing to Stairstep. This allows multiple price brackets. A customer who buys into a bracket is charged a flat fee for that bracket.

5. Set up advanced options (optional)

Configure tax treatment, Billing Portal access, and how the charge appears on invoices.

$an Advanced Options panel covering taxes, billing portal updates, fractional quantities and custom proration$

Field	Description
Enable Taxes	Classifies the component as a Digital Service, a Physical Good, a custom tax code, or none. Taxes must be set up on the Site for this to work.
Billing Portal	When enabled, customers can edit this component in their Billing Portal, where applicable.
Fractional Quantities	Allows fractional quantities for the component.
Date Ranges on Invoices	Displays the date range on the invoice for this line item.
Proration Settings	Sets proration settings other than the default.