# How to Update Your Pricing

Source: https://marketplace.gohighlevel.com/docs/2023-02-21/oauth/HowToUpdateYourPricing

This document explains how pricing versions and pricing updates work in the HighLevel Marketplace. It is meant for developers who sell their apps through HighLevel billing and want to add, change or retire plans and billing meters.

---

## 1. What Is Pricing Versioning?

Pricing versioning lets you change your app's pricing through a **draft** instead of editing live plans directly.

Each time you publish a draft, your pricing gets a new **version number** (Version 1, Version 2, …). Every version keeps a record of what changed, so you can always see how your pricing evolved.

Pricing versions are separate from app versions. Your app can be on `v1.2.0` while your pricing is on Version 4.

---

## 2. Purpose

Pricing versioning solves several longstanding issues:

- Live prices are never changed under existing subscribers.
- Developers can prepare pricing changes in a draft without affecting anyone.
- Existing subscribers are told in advance when a plan or billing meter they use is retired.
- Developers see exactly how many subscribers each change affects before publishing.
- Every published change is recorded in the pricing history.

---

## 3. Pricing System – How It Works

Your pricing page has two views:

- **Live** – The pricing installers see today. It can't be edited directly.
- **Draft** – A working copy where you make changes. Nothing reaches installers until you publish it.

### Plan and Billing Meter States

- **Live** – Available to new installers.
- **New** – Added in the current draft. Becomes live when you publish.
- **Deprecated** – No longer offered to new installers. Existing subscribers are handled by the policy you chose (see [section 6](#6-deprecation-policies)).

:::info
Deprecation can't be undone. A deprecated plan or billing meter can't be made live again. If you need it back, create a new one.
:::

### Pricing Limits

To keep pricing clear for installers, these limits apply:

- Maximum **6 active plans** per app
- Maximum **6 legacy (deprecated) plans** per app
- Up to **5 features** per plan
- Billing meter price up to **$200 per unit**, with up to 6 decimal places
- Free trial up to **90 days**
- One **live** billing meter per module. While a meter is in its 30-day notice period, the module can also have one deprecated meter.

When you reach 6 active plans, deprecate or delete a plan before adding another. When all 6 legacy slots are used, delete a legacy plan that has no subscribers before deprecating another plan.

---

## 4. Creating a Pricing Draft

To start a draft:

1. Open your app and go to the **Pricing** page
2. Click **Edit pricing**
3. A draft opens with a copy of your live pricing

:::info
Drafts aren't saved. If you refresh or leave the page, the draft is lost. Publish your changes in one sitting.
:::

### What You Can Change in a Draft

| Item | Allowed changes |
|------|-----------------|
| **Business model** | Switch between Free, Freemium and Paid (see [section 9](#9-changing-your-business-model)) |
| **New plans** | Add, edit, delete |
| **Live plans** | Rename, duplicate, deprecate, delete (only with 0 subscribers) |
| **New billing meters** | Add, edit, delete |
| **Live billing meters** | Rename, deprecate |
| **Free trial** | Turn on or off, change the number of days |

:::info
**Prices of live plans are locked.** You can't change the amount or charge type of a plan that has subscribers. To change a price, create a new plan (or **Duplicate** the existing one and edit the copy) and then deprecate the old plan.
:::

Free trial changes apply only to installs made after the change goes live. Existing installs keep their trial.

---

## 5. Publishing a Pricing Update

When your draft is ready, click **Publish**.

### Step 1 — Fix Any Errors

The publish dialog lists anything that blocks publishing, for example:

- A deprecated plan that has no policy chosen
- A deprecated plan with no subscribers, which must be deleted instead
- A Freemium app without both a free and a paid plan
- Two active plans with the same name

### Step 2 — Review What's Changing

The dialog groups every change against the live pricing:

- Business model and free trial
- Plans added, deleted or deprecated
- Billing meters added or deprecated
- Plan and billing meter renames

### Step 3 — Review Subscriber Impact

For every deprecated plan or billing meter, the dialog shows how many subscribers are affected and what will happen to them.

### Step 4 — Publish

Your pricing goes live immediately as the next version. You can see every published version in **Pricing history**.

:::info
**Apps that aren't live yet:** Before your app goes live, you **Save** pricing instead of publishing it. The saved pricing becomes **Version 1** when your app goes live.
:::

---

## 6. Deprecation Policies

When you deprecate a plan, choose how its existing subscribers are handled. The policy can't be changed after you publish.

| Policy | What It Means | Subscriber Experience |
|--------|---------------|-----------------------|
| **Keep on current plan** *(No expiry)* | Subscribers stay on the plan at their current price, indefinitely | No notification is sent; nothing changes for them |
| **End after 30 day notice** *(Notify 30 days)* | Subscribers are asked to switch to an available plan | Notified when the update is published, and reminded 30 days later |

In both cases, the plan is no longer offered to new installers.

:::info
**Billing meters always use the 30-day notice.** There's no "Keep on current plan" option for billing meters.
:::

Subscribers who bought a **one-time** plan have already paid for lifetime access, so they aren't notified when that plan is deprecated.

---

## 7. What Subscribers See

When you deprecate a plan or billing meter with a 30-day notice:

- Subscribers get an **email** and an **in-app notification** naming the plan or billing meter and the date the notice period ends.
- They can switch to one of your available plans at any time from their installed apps.
- 30 days later, they get a **reminder**.
- Subscribers aren't moved to another plan or uninstalled automatically.

### Notice Timing

- Deprecations you publish within **24 hours** of each other are sent as **one** notice, at the end of that 24-hour window.
- The 30-day notice period starts when the notice is sent, so every subscriber gets the full 30 days after they're told.
- If a subscriber is affected by several items, they get one message listing all of them.

---

## 8. Updating Billing Meter Prices

A live billing meter's price can't be edited. To change the price for a module:

1. Deprecate the live billing meter (30-day notice)
2. Add a new billing meter for the same module with the new price
3. Publish

What happens next:

- **New installs** (after you publish) are charged the new meter's price straight away.
- **Existing installs** keep the old price for 30 days, then move to the new meter.
- If you deprecate a meter without adding a replacement, usage for that module stops being charged after the 30 days.

Your app keeps reporting usage the same way. HighLevel picks the right meter for each install, even if your app still sends the old meter ID.

---

## 9. Changing Your Business Model

You can change your app's business model in a draft:

| Change | What Happens |
|--------|--------------|
| **Free → Freemium** | Add at least one paid plan alongside the free plan |
| **Free → Paid** | Add at least one paid plan. Existing free users keep their free access |
| **Freemium → Free** | Your live paid plans must be deprecated with a policy. New installers aren't charged |
| **Freemium → Paid** | Free plans are kept for existing users (no expiry) and no longer offered to new installers |
| **Paid → Free** | Your live paid plans must be deprecated with a policy. New installers aren't charged |
| **Paid → Freemium** | Add a free plan. Paid subscribers keep their plans |

Publishing is blocked until the required free and paid plans exist.

---

## 10. Switching from an External Payment Page

If your app collects payments on your own payment page, you can move it to HighLevel billing:

1. On the **Pricing** page, click **Switch to HighLevel billing**
2. Set up your plans, free trial and billing meters in the draft
3. Publish

Until you publish, your payment page keeps working. Installs that already paid on your page keep using the app, and their billing stays with you.

:::warning
This can't be undone. Once you publish, your app can't go back to an external payment page.
:::

:::info
External billing is a legacy option, available only to apps that were created before **June 17, 2026 (00:00 UTC)** and had external billing configured.

New apps, and apps that did not previously configure external billing, cannot use this option.
:::

See [**External Billing**](./Billing.md) for apps that already use one.

---

## 11. Things to Know

- **Agency resale price:** New plans get a default agency resale price of your price **+ 15%**. Plans created before this update keep their existing default. Agencies can still set their own resale price.
- **Plan names:** Renaming a plan doesn't change its price or terms. Subscribers see the new name.
- **Plan IDs:** Deprecating or renaming a plan doesn't change its ID.
- **Deleting plans:** You can only delete a plan or billing meter once it has no subscribers.

---

## Contact Us

If you have any questions or concerns:

- Email us: `marketplace@gohighlevel.com`
- Fill out the [**Marketplace Support Form**](https://developers.gohighlevel.com/support)
