MediaGrabber Pro

Licenses

License keys, activation limits, and managing connected sites.

The Licenses page is where customers manage the keys that unlock your plugin. This guide is written for customers, but the mechanics apply to anyone integrating the SDK.

Key format

Every license key looks like LK-{YEAR}-{A4}-{B4} — for example LK-2025-H7KQ-3MNR. Keys are:

  • Globally unique — no two keys are ever the same
  • Case-insensitive when validated
  • Permanent — each key is issued once and never changes

License types

TypeBehavior
subscriptionBacked by an active recurring subscription. Lapses if the subscription ends.
lifetimePermanent. Never expires.
trialTime-limited; expires automatically.
complimentaryGranted manually (review copies, NFR licenses).

Activation limits

Each license has a maxActivations cap that controls how many installs can use it at once:

ValueMeaning
nullUnlimited activations
1Single-site (typical Starter plan)
5Multi-site (typical Pro plan)

When an install tries to activate beyond the cap, it receives an ACTIVATION_LIMIT error. The customer must free a slot first.

Managing connected sites

Open the Connections page (or expand a license on the Licenses page) to see every active install — its label, domain, and last-seen time.

Find the site

Locate the activation you want to remove in the list.

Remove it

Click Remove. The slot is freed immediately and that install will fail its next validation.

Keys are permanent

Each customer is issued a single, unique, permanent license key. There is no "regenerate" action — a key never changes for the life of the license.

If a key is compromised, contact support. Recovery is handled by revoking the license and issuing a new one — not by rotating the key in place.

Status lifecycle

issued → active → expired   (subscription lapses / trial ends)
                → suspended  (temporary, admin action)
                → revoked    (permanent: abuse, refund, admin decision)
StatusPlugin behavior
ActiveFully valid; can activate and meter usage.
ExpiredKeeps running but receives no updates/support.
SuspendedTemporarily blocked.
RevokedPermanently invalid.

For developers

The full activation/validation API is covered in the SDK section:

On this page

Licenses | MediaGrabber Pro