Define values for plans

An overview of the PlanGraph Plan Builder interface.

Overview

Through our Plan Builder interface, you're able to easily manage a table of your plans, features, and values.

When you enter the Plan Builder for the first time your first draft will be started which enables you to immediately begin making changes.

If you are returning to a published product you can click the "Edit product" button at the top right of your product to start a new draft.

What is a feature value?

A feature value represents the value of a specific feature for a given plan. We display these values as cells for a given feature and plan in our Plan Builder and in your embeds.

Types of feature values

PlanGraph currently offers four types of feature value: String, Include, Numeric, and Tiers.

String

A string value is used to represent text in the cell for this feature in a given plan.

Properties

Property

Description

Value

Arbitrary text input, also used as Display Value when one is not provided

Display Value

An optional display value to differentiate between UI and programmatic interfaces

Additional Cost

A dollar amount added to the base cost when included with a plan

Include

An include value enables you to represent the explicit inclusion or exclusion of a feature for a given plan as either a checkmark or an x.

Properties

Property

Description

Value

Included or Excluded

Additional Cost

A dollar amount added to the base cost when included with a plan

User-Configurable

When enabled, users will be shown a toggle that allows them to decided if the feature is included or excluded

Numeric

An integer value is used to represent a number in the cell for this feature in a given plan. The raw integer value can optionally be replaced with a friendlier display value in the UI.

Properties

Property

Description

Value

Arbitrary integer input, also used as Display Value when one is not provided

Display Value

An optional display value to differentiate between UI and programmatic interfaces

Additional Cost

A dollar amount added to the base cost when included with a plan

Tiers

Represent multiple tiers of pricing based on volume as a price table for this feature in a given plan.

Properties

Property

Description

Value

Arbitrary integer input,

Cost per unit

Per-unit cost to be displayed with this tier

Unit label

How to label the per-unit cost

Unit label plural

An optional manual pluralization of your unit label

Define your first feature value

Once you have at least one plan and feature you can define a feature value. When viewing the Plan Builder you can create a feature value through these steps:

  1. Click the cell that aligns with your desired plan and feature

  2. Choose a type (String, Include, Numeric, Tiers)

  3. Fill out the value's properties

  4. Click "Save changes" and your value will appear on the table

Once your change is published, the feature will be shown in your embeds and returned through the GraphQL API.

If you do not see the "Add new feature" button, you may first need to click the "Edit product" button at the top right of your product to start a new draft.

Remove a feature value

When viewing the Plan Builder you can remove a feature value through these steps:

  1. Click the value cell you wish to remove

  2. Click the "Show advanced options" link

  3. Click the "Remove feature value" button

Once your change is published, the feature value removed will no longer be shown for that plan and feature.