# Creating a Product Addon

https://docs.wisecp.com/de/creating-a-product-addon

Creating a Product Addon is where you build a purchasable add-on: its name, price, and checkout behavior. The same screen opens again when you edit one.

## Opening the Screen

From [Product Addons](https://docs.wisecp.com/en/product-addons), click **Create New Product Addon**. To change an existing addon, click its name in that list, or open its row menu and choose Edit.

Direct address (new addon): `{admin}/products/addons/add`

Direct address (existing addon): `{admin}/products/addons/edit?id={addon}`

## What Is on the Screen

When creating a new addon, a banner explains that once saved, you assign it to products from that product's Addons tab. A language strip sits above the form. Only your main language is required; open another tab to translate Name and Description. Below the strip is a single form. Once an addon has been saved at least once, two extra pieces appear. A Purchase Link shows the public address customers use to buy it on its own, and the options table lists the saved pricing options.

## Fields

### Identity and Grouping

- **Addon Name**: The name customers see at checkout, per language.
- **Addon Description**: A short explanation shown with the addon, per language.
- **Status**: Active or Inactive. Default: Active. An inactive addon stays out of new orders.
- **Related Product Group**: The product group this addon can be offered under. Required.
- **Addon Category**: Groups the addon both for the category filter on the list and on the client order screen. On the order configuration screen each category becomes its own tab; with a single category no tabs are shown. Required.
- **Requirements**: Any order requirements the client must fill in together with this addon. Only shown once at least one requirement exists in the system.
- **Define as a Product**: Sells an existing product as this addon instead of pricing it here. Default: None. Picking a product hides Option Type, the pricing options table, Sync with Product, Override Client Currency, and Exempt from Tax. The linked product's own settings take over instead.
- **Icon**: A font icon or an uploaded image shown next to the addon. Optional.
- **Sort Order**: Where the addon falls in listings, lowest first. Default: 0.

### Checkout Behavior

- **Required**: Forces clients to purchase this add-on. Default: off.
- **Sync with Product**: Matches the addon's price and billing period to the product's chosen cycle. Default: off. Suspending or cancelling the product always carries over to its addons whether this is on or off, and every addon is renewed on its own due date.
- **Multiple Purchase**: Lets each client buy this addon more than once. Default: off.
- **Offered Billing Cycles**: Only offers the addon when the product is bought on the cycles you check. Default: every cycle, when none are checked.
- **Include Free on First Purchase**: Bundles the addon at no charge for the first term, on cycles you pick. The client cannot remove it; renewals bill at the addon price. Default: off. Its Bundled Option sub-field chooses which option is bundled; Automatic uses the first offerable one.
- **Option Type**: How the addon appears during ordering: Dropdown, Radio Selection, Checkbox, or Quantity Input. Default: Dropdown. Quantity Input reveals Minimum Quantity Required, Maximum Quantity Allowed, and Step (defaults 0, 1000, and 1). Radio Selection and Checkbox reveal a Listing Template choice: Box List or Horizontal List. Default: Horizontal List. On the order page each optional addon starts collapsed; the customer opens it by clicking its title, which also shows the lowest price. Compulsory addons and pre-selected picks are shown open.

### Pricing Options

- **Options**: One or more purchasable price points. Each row holds a name and description per language, an icon, and a billing period. It also holds a price and enable switch per active currency. A Hidden switch and a gear icon map the option to a module's own configurable fields. Add Option appends a new row; the last remaining row cannot be removed, only cleared. Drag the handle on the left of a row to change its order.
- **Override Client Currency**: Charges the currency you defined for this addon instead of the client's own currency. Default: off.
- **Exempt from Tax**: No tax is calculated for this addon. Default: off.

## Tasks

### Create an Addon

Fill in a Name, then choose Related Product Group and Addon Category, both required. Set at least one price under Options, and click **Create**.

### Build Pricing Options

In the options table, name the option and pick its billing period. Turn on the currencies it should charge, and enter an amount for each. Click **Add Option** for another price point; at least one currency must stay enabled per option.

### Control When It Is Offered

Check specific cycles under Offered Billing Cycles to limit the addon to those product cycles. Leave every box unchecked to offer it always. Turn on Include Free on First Purchase to bundle it automatically on chosen cycles for the first term only.

### Sell an Existing Product as This Addon

Pick a product under Define as a Product instead of pricing options here. The pricing table and the currency, tax, and sync switches hide once you do, because the linked product supplies them.

## Things to Watch

> **An Active Option Locks Its Billing Period**
> 
> Once a pricing option has clients on it, its billing period cannot change and the option cannot be removed. Its name, description, and price stay editable.

> **Unchecked Cycle Boxes Mean Every Cycle**
> 
> Leaving Offered Billing Cycles or Free-Bundled Billing Cycles fully unchecked applies to all cycles; it does not turn the feature off.

## Required Privileges

- **Products > View**: Opens an existing addon in the same screen, but any save is rejected. Read-only in practice.
- **Products > Edit**: Opens the create screen and is required to save any addon, whether new or existing.
- **View Product Group or Edit Product Group**: Needed for the searchable picker under Define as a Product.

## Related Articles

- [Product Addons](https://docs.wisecp.com/en/product-addons)
- [Product Addon Configuration](https://docs.wisecp.com/en/product-addon-configuration)
- [Creating a Product Requirement](https://docs.wisecp.com/en/creating-a-product-requirement)
