Managing Licenses
View, monitor, and revalidate your premium extension licenses from the Licenses panel.
TL;DR
Go to Admin → Marketplace → Licenses. The table lists all installed premium licenses with their status, expiry, and registered domain. Click Revalidate to re-check a specific license against pubvana.net immediately. Invalid licenses trigger a non-dismissable admin warning banner.
Details
The Licenses Table
The marketplace_licenses table stores one row per installed premium extension:
| Column | Description |
|---|---|
product_name | Display name of the extension |
product_slug | Extension slug identifier |
item_type | theme, plugin, or widget |
license_key | The license key (displayed masked in the UI) |
registered_domain | The domain the license was validated against |
is_subscription | Whether this is a recurring subscription license |
expires_at | License expiry date (null for perpetual licenses) |
subscription_renews_at | Next renewal date for subscription licenses |
license_valid | valid, invalid, or unchecked |
license_last_checked | Timestamp of the most recent validation check |
installed_version | The version installed on this site |
License Statuses
- valid — the license was successfully validated against pubvana.net. The extension is fully active.
- invalid — validation failed: the key may be expired, revoked, transferred to another domain, or never valid. A non-dismissable warning banner is displayed in the admin panel.
- unchecked — the license has not been validated yet (e.g., just installed, or validation check has never run).
Automatic Revalidation
MarketplaceService::checkAndRevalidateIfDue() runs on each admin page load. It checks whether any license's license_last_checked is older than 7 days. If so, it silently re-validates those licenses in the background by contacting pubvana.net. This ensures licenses are kept current without manual intervention.
You can also run revalidation manually from the CLI:
php spark marketplace:revalidateThis revalidates all licenses regardless of when they were last checked.
Manual Revalidation
Click the Revalidate button next to any license row in the admin UI to immediately re-check that specific license against pubvana.net. Useful after:
- Renewing an expired subscription
- Transferring a license to a new domain
- Resolving a billing issue
Subscription Licenses
Subscription licenses show a Renews date in addition to the expiry date. Pubvana does not automatically charge renewals — that happens on pubvana.net. After a successful renewal on pubvana.net, click Revalidate to pick up the new expiry date.
When a subscription expires and is not renewed, the license status changes to invalid on the next validation check and the admin warning banner appears.