GalleonQL Manual
Changelog

Plans (Free / Pro) and licenses

This page covers the Free / Pro plan difference, Pro-only features, and how to apply or remove a license.

The in-app plan management modal is authoritative (design D55). Prices, the feature list, and purchase/cancel flows on screen are the latest user-facing source. This page is a public-manual summary; if anything conflicts, prefer the app UI.

Free vs Pro (overview)

Free Pro
Number of projects Unlimited Unlimited (same as Free)
Price $0 $9.99 / month or $99 / year (about 2 months free on yearly)
Pro-only features Core features except the table below Features in the table below

Prices are shown in the app after fetching live pricing. If the network is unavailable, the purchase button is disabled rather than guessing an amount.

Pro-only features (implemented)

Feature What it does Details
Request hooks After send, extract values into env vars and/or check status and body Request hooks
Subscription (WebSocket / SSE) Subscribe / send subscriptions Sending queries
Schema diff Diff confirmation gate on re-import Schema import
Third-party collection import Import Postman Collection (v2.1, GraphQL) Project export / import

On Free you can view request-hook rules and keep imported ones, but you cannot create, edit, toggle, or evaluate them on send (the Hooks tab shows a [Pro] badge while you are on Free).

Payment goes through Lemon Squeezy (online payment by credit card, etc.).

There is no project-count limit on either plan. Pricing is not based on how many projects you create.

Prerequisites

Managing your plan

All plan operations (upgrading to Pro, applying a license key, and canceling) are consolidated into a single plan management screen. You can open it from:

  • The project selector menu (top bar) → “Manage plan” in the footer.
  • Settings (⚙) → “Upgrade to Pro” (when unlicensed) or “License info” (when licensed).

The plan management screen is a single column.

While on Free (no license):

  1. A monthly / yearly toggle (yearly shows a “2 months free” style savings badge when applicable).
  2. Free and Pro cards with the live amount for the selected interval.
  3. A feature list (Pro-only features first, then features available on both plans).
  4. “Upgrade to Pro (amount)” and a license key field (for paste-and-apply if needed).

While on Pro (licensed):

  • Subscription status (active / cancelled grace), and
  • Care actions: “Deactivate license on this device” and “Cancel subscription” (gift licenses hide cancel).

Pricing is fetched online, so you cannot complete a purchase without a network connection.

Upgrading to Pro

Pro is a single plan (no quantity picker). Steps:

  1. Open plan management and choose monthly or yearly.
  2. Press “Upgrade to Pro (amount)”. Your default browser opens the Lemon Squeezy checkout page. In the app, the button becomes “Processing purchase…” and stays disabled.
  3. Complete payment in the browser. The app checks for completion every few seconds and applies the license automatically when it detects the purchase — usually without typing a license key.
  4. If you cancel before paying, or about 10 minutes pass without detection, you see “Purchase interrupted.” Paste the key from email or Lemon Squeezy into the license key field and press Apply.
  5. If the purchase actually completed after an interruption, restarting the app may still auto-apply the key once at the next startup.

While “Processing purchase…” is shown, the license key field stays usable — you can paste a key as soon as it arrives without waiting for auto-detection.

Applying a license key

The license key field is shown when you are unlicensed (including during an in-progress checkout). It is hidden once Pro is already applied.

  1. Paste the key into the License key field.
  2. Press Apply.
  3. On success, a registration-complete screen appears.
  4. Invalid, expired, or disabled keys show an error and leave you on Free.

Deactivating a license vs. canceling a subscription

Both give up paid access on this device’s timeline, but billing and timing differ. Do not confuse them.

Action What it does Plan on this device Billing
Deactivate license on this device Removes the license from this app (and may free the activation on Lemon Squeezy) Immediately Free Does not stop — the subscription keeps billing
Cancel subscription Cancels via the in-app API (no browser) Pro until the end of the paid period, then Free on a later startup Stops after you confirm cancel
  • Deactivate shows a confirmation. Other devices that use the same key are not removed automatically.
  • Cancel shows a confirmation with the period end date. After cancel, the status becomes cancelled and both danger actions are hidden during the grace period; wait for the period to end, or deactivate before cancel if you need Free immediately (billing still needs cancel separately if you want charges to stop).
  • Gift licenses have no subscription to cancel; only deactivate is available.

License check at startup

When a Pro license is registered, GalleonQL verifies the license online on every startup.

  • Valid (active, or cancelled but still within the paid period): Pro stays.
  • Lapsed (expired, revoked, paid period over): the app returns to Free and removes the key from this device. Projects are not locked — Free still has unlimited projects.
  • Offline startup: a previously valid license can be kept temporarily for up to 24 hours after the last successful online check, and only while still within its validity period. Past that, you return to Free.

Troubleshooting

Situation Likely cause What to do
Purchase button disabled / pricing unavailable Network or pricing API failure Check connectivity, press retry if shown, reopen plan management
“Purchase interrupted” after paying Auto-detect timed out or was cancelled Paste the key from email / Lemon Squeezy and Apply; or restart once for startup reclaim
Cancelled but still on Pro End-of-period grace Wait until the period ends and restart; or deactivate earlier if you need Free now (billing may continue until cancel)
Deactivated but still billed Deactivate does not stop Lemon Squeezy billing Use Cancel subscription while still licensed (before or after re-applying the key on a device that can cancel)
Pro features blocked after cancel grace ends Plan is Free again Upgrade to Pro again if you need those features

See also Key terms and the table of contents.