Overview

Add-ons represent separately billable functionality that extends specific plans. As opposed to plans, customers can purchase multiple units of a specific add-on.

Add-ons are dependent on the life-cycle of the plan that they extend; that is, when a subscription expires, customers also lose access to the plan’s add-ons.

The functionality that’s included in each add-on is defined by a combination of features and their configuration (referred to as entitlements).

Due to the fact that add-ons extend the functionality of plans, when customers purchase a subscription that includes both plans and add-ons that are defined using the same configuration or metered features, the value of each feature that customers will be entitled to will be the sum of the entitlements of that specific feature. For example: if a customer has a subscription for a plan, and as part of that plan they’re entitled to X units of a specific feature. If they’ll also purchase an add-on with Y units of the same feature, the customer will be entitled to X + Y units as part of their subscription. Moreover, if the customers pays for a quantity of Q add-ons as part of their subscription, they’ll be entitled to X + Y * Q units of that feature.

Viewing the list of add-ons

To view the list of add-ons of a specific product:

  1. Select the relevant product from the Products sub-section of the Product Catalog.
  2. Scroll down to the Pricing > Add-ons section of the selected product.

πŸ“˜

Also see the product's "Modeling your pricing" section.


Viewing a flat list of all of the plans of all of the products is possible by selecting the Add-ons sub-section of the Product Catalog from the left navigation pane.

Creating add-ons

To add an add-on, click on the "+ Add" button under the Add-ons section of the selected product.
Enter the below details in the opened modal:

  1. Name - the name of the add-on.
  2. ID - will be auto-generated by Stigg. Use this ID to refer to the add-on in your application. To link an existing add-on, override the auto-generated value.
  3. Description (optional) - the add-on's description.

πŸ“˜

The values that are entered in the β€œName” and β€œDescription” fields will be leveraged by Stigg to render the customer-facing paywall and customer portal; therefore, it’s recommended to use customer-friendly texts.

Confirm the action by clicking on the "Create" button.

New add-ons are created as drafts. Add-ons must be published in order to be visible to customers and be included in subscriptions.

🚧

Before publishing an add-on, make sure to assign features to the add-on and define its pricing.

Assigning features to add-ons

The functionality that’s included in each add-on is defined by a combination of features and their configuration, referred to in Stigg as entitlements.

To add entitlements to an add-on, click on the "+ Add" button under the Entitlements section of the selected add-on.

Search for the features that you'd like to assign to the add-on and select them from the list.

Apply the relevant configuration for the selected features:

  1. Configuration features must be defined with the configuration value.
  2. Metered features can be defined with a limit or without one. Features with an incremental meter also need to be specified with the reset period (monthly, weekly, daily, or hourly), for example: to represent a feature with a limited number of API calls per month.

πŸ“˜

Boolean features don't require any additional configuration.

Confirm the action by clicking on the "Add" button.

Defining the add-on's price

The price that's defined in Stigg will be shown to customers in the paywalls that are rendered using Stigg's SDKs. When Stigg is integrated with a billing solution (for example: Stripe), subscriptions will be created in the billing solution using the price that was defined in Stigg.

  1. Click on the "Set" button under the Pricing section of the selected add-on.
  2. In the opened modal, enter the following information:
    1. Add-on type - paid or custom price.
    2. Define the billing periods - monthly, annually or both.
    3. Define the price in US dollar (USD) in each billing period.
  3. Click "Save changes".

πŸ“˜

Stigg supports paid add-ons and add-ons with a custom price (where the specific price is negotiated with each customer). Free add-ons are not currently supported.

Storing metadata

It's possible to store metadata on each add-on. The metadata can then be leveraged by the hosting application and third-party solutions via the Stigg SDKs, API and webhooks to implement custom functionality.

To store metadata on a specific add-on, under the "Metadata" section of selected add-on click on the "Add" (if there's no metadata) or "Edit" buttons.

Enter the relevant keys and values.

Click "Add" (if there was previously no metadata) or "Save changes" buttons to apply the changes.

Publishing add-ons

After defining the basic details, entitlements and pricing of draft add-ons, publish the add-on.

To do so, click on the "Publish" button in the add-on's header.

After the add-on is published, make sure to mark it as compatible with the relevant plans in order to allow customers to create subscriptions that include a combination of the plan with the compatible add-on.

Defining add-on compatibility with specific plans

Defining add-ons as "compatible" with specific plans represents the fact that the add-on can extend that plan. If an add-on is not compatible with a specific plan, it will not be possible to create a subscription that includes the plan and the incompatible add-on.

To mark an add-on as compatible with a specific plan:

  1. Select the relevant plan that you'd like to make the add-on compatible with from the Plans sub-section of the Product Catalog.
  2. If the plan was already published, first edit it.
  3. Under the Compatible Add-ons section click on "+ Add".
  4. Select the relevant add-ons in the opened modal.
  5. Confirm the action by clicking on the "Add" button.

πŸ“˜

When an add-on is compatible with a plan, all versions of that add-on will be compatible with that plan.

Editing published add-ons

Stigg's allows product managers and growth team members to make frequent and rapid changes to add-ons without requiring additional engineering changes.

Changes can be rolled out to both existing and new subscriptions (for example: when adding or removing an entitlement from an add-on), or only to new subscriptions (for example: when changing the add-on's price).

Stigg uses a versioning mechanism to support this functionality - every time an add-on is edited a new version is created. Changes to the add-on can be published or discarded.

To edit an add-on, click on the dotted menu icon of the relevant add-on, and select the "Edit" action.

Apply the relevant changes to the add-on.

πŸ“˜

Some properties of an add-on (for example: its ID), cannot be modified after the add-on is created.

Reviewing changes

To review the changes to the add-on since the last published add-on version, click on "review changes" or "Review & publish" in the add-on's header.

In the change review modal:

  1. Green backgrounds represent items that were added since the last published version.
  2. Orange backgrounds represent items that were updated since the last published version.
  3. Red backgrounds represent items that were removed since the last published version.

Publishing changes

πŸ“˜

Changes must first be reviewed before they can be published.

To publish changes, in the change review modal select the target audience to which the changes will be applied:

  1. New subscriptions - the changes will only affect subscriptions that are created after the new add-on version is published.
  2. Both existing and new subscriptions - in addition to (1), existing active subscriptions will be migrated to use the new add-on version.

When applying changes also to existing subscriptions, an acknowledgment of a series of disclaimers is required.

🚧

Default grandfathering of subscription pricing when rolling out pricing changes

Pricing changes are automatically published only to new subscriptions. Existing subscriptions can be migrated to the latest price manually using the Stigg UI or programmatically.


Discarding changes

To discard pending changes from an add-on, click on "Discard changes" in the add-on's header.

Confirm the action in the opened dialog.

Deleting add-ons

To delete an add-on, click on the dotted menu icon of the relevant add-on, and select the "Delete" action.

Confirm the action by clicking on the "Delete" button in the opened modal.