Activate a POM AI license
This is the walkthrough of the License tab: what each control does, what each status line means, and how to tell a successful activation from a partial one.
Get the key
The key is issued with your POM AI subscription. To find it, sign in to account.pom.es and open My Account → Licenses & Downloads. The POM AI card shows the key masked; select Reveal key to display it in full, then Copy.
Only the account owner can reveal a key. If you are configuring a client's site, ask them to send it to you through a channel you both consider safe, and do not store it in a ticket or a shared document afterwards.
Open the License tab
In WordPress, go to:
Settings → POM AI → License
The tab requires administrator rights. On a multisite subsite it is the subsite's own administrators who manage it; on a multisite main site or in the network admin it is network administrators.
The panel heading tells you which license you are editing:
- POM AI license — this site's key, used for both services and updates.
- POM AI license for this site — a multisite subsite's own service key. A blue note reminds you that automatic updates are handled separately, from the network's main site.
If you see the second heading and expected the first, you are on a subsite. Read Configure POM AI on WordPress multisite before continuing.
Save and validate
- Paste the key into the field.
- Select Save and validate.
The button reads Replace and validate when a key is already stored. The behaviour is the same, with one useful guarantee: the new key is validated before it replaces the old one. A mistyped key produces an error and leaves the working key untouched.
Saving does three things in one request: it checks the key, it activates the current domain against the plan's capacity, and it stores the result.
Read the result
A notice appears at the top of the screen:
| Notice | Meaning |
|---|---|
| License validated. This domain is authorized. | Success. |
| The license could not be validated… | The key, the subscription or the domain was rejected. See Troubleshoot license and domain errors. |
| Paste a license key before saving. | The field was empty. |
| The license could not be stored. | The key was accepted but writing it locally failed. |
After a successful save the panel shows a summary line:
- License key — the masked key. This is the only form WordPress will ever display.
- Status — a green tick and the license status, or a red cross and an error code.
- Plan — the plan slug your subscription grants.
- Expires — the paid-through date.
- Domain — the normalized host that was authorized.
Check the Domain value against the site's real public host. A mismatch usually means the site was migrated or is being configured from an alternative hostname.
Confirm the credit balance
Above the license panel, POM AI shows Available AI credits in the license owner's account once a key is stored. It loads the balance from the account.
A valid license with a balance that never loads points at connectivity between your server and the account host rather than at the license itself. A valid license with a zero balance means the subscription has no credits available right now; see POM AI credits.
Revalidate
Revalidate re-checks the stored key without changing it. Use it after:
- renewing or changing a subscription;
- a domain change made from the account side;
- an account outage, to refresh the cached state.
A transient network failure during revalidation is ignored rather than recorded, so a temporary outage cannot mark a working license as invalid.
Unlink
Unlink asks for confirmation, then deactivates this domain on the account and removes the key from this site.
It is the correct step when retiring a site, moving to a different domain or handing a site to a different owner. If the account cannot be reached, the panel says so and deliberately keeps the local key, so you can retry rather than ending up with a site that has no key and a domain that is still occupying a slot.
Details are in Remove an authorized domain.
"Paste the license key again to reconnect"
If the panel shows this message in red, the key is still stored but can no longer be decrypted. This happens when the WordPress security salts in wp-config.php change — after a migration, a security incident response, or a host regenerating them.
Paste the key again and save. Nothing on the account side needs to change: the domain is still authorized, only the local copy became unreadable.
Verify the activation
An activation is complete when all four are true:
- the panel shows a masked key and a valid status;
- the Domain line matches the site's real host;
- the credit balance loads;
- one small AI operation completes and the balance changes.
Do not skip the fourth. Steps one to three prove the license; only the fourth proves the whole path from your server to the account service. Complete your first AI-assisted task gives a safe way to do it.