Activate or Change a Paid License

Overview

Activate a paid Joomla Fediverse license when you need Personal or Pro features on a specific site. This unlocks plan-gated capabilities such as advanced publishing controls, domain policies, configuration transfer, and webhooks without leaving the normal Joomla administrator workflow.

You usually need this procedure after purchase, after moving from the Free tier to a paid tier, or when replacing one paid key with another. Joomla Fediverse uses LemonSqueezy to activate and validate the installation, so saving the key in the component options is the step that binds the paid plan to this site.

Before you begin

You need administrator permission to edit Components -> Fediverse -> Options.
You need the paid LemonSqueezy license key issued for this installation.
The site should already have a correct public base URL, because the installation binding should match the real external site.

Steps

Open Components -> Fediverse.
Click Options in the toolbar.
Open the License tab.
Paste the paid key into License Key.
- License Key - The LemonSqueezy key that identifies the purchased plan. Saving this value tells Joomla Fediverse to activate or validate the current installation against LemonSqueezy.
Click Save or Save & Close.
Return to the Fediverse dashboard and review the plan badge near the page heading.

Check your result

The dashboard badge changes from Free to the paid plan that belongs to the saved key.
Paid-only actions become available where appropriate, for example Configuration Transfer in the dashboard toolbar for Pro.
Reopening Components -> Fediverse -> Options keeps the saved license key in place.

Troubleshooting

The dashboard still shows `Free`

Likely cause: The key is invalid, expired, or belongs to a different plan than expected.
Solution: Reopen the License tab, confirm the entire key was pasted correctly, save again, and verify the key status in LemonSqueezy.

A Pro-only screen still shows an upgrade message

Likely cause: The site is running on Personal, the license is expired, or the page was opened before the new plan was saved.
Solution: Confirm the dashboard badge first, then reload the blocked screen. If the badge is not Pro, check the purchased plan and renewal status.

The key was saved on the wrong site

Likely cause: The license was activated in a staging or copied environment instead of the intended production site.
Solution: Remove the key from the wrong site, save once, and then activate it on the intended site. If the old binding still blocks activation, follow Recover a Paid License After Moving the Site.