Skip to main content
Getting StartedVersion: 2021-07-28

How to Update Your Pricing

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).
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​

ItemAllowed changes
Business modelSwitch between Free, Freemium and Paid (see section 9)
New plansAdd, edit, delete
Live plansRename, duplicate, deprecate, delete (only with 0 subscribers)
New billing metersAdd, edit, delete
Live billing metersRename, deprecate
Free trialTurn 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.

PolicyWhat It MeansSubscriber Experience
Keep on current plan (No expiry)Subscribers stay on the plan at their current price, indefinitelyNo notification is sent; nothing changes for them
End after 30 day notice (Notify 30 days)Subscribers are asked to switch to an available planNotified 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:

ChangeWhat Happens
Free → FreemiumAdd at least one paid plan alongside the free plan
Free → PaidAdd at least one paid plan. Existing free users keep their free access
Freemium → FreeYour live paid plans must be deprecated with a policy. New installers aren't charged
Freemium → PaidFree plans are kept for existing users (no expiry) and no longer offered to new installers
Paid → FreeYour live paid plans must be deprecated with a policy. New installers aren't charged
Paid → FreemiumAdd 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 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: