Skip to main content
Add-on licensing issues typically occur when the connection between your Dashboard and MainWP’s licensing server is interrupted. The solution usually involves deactivating and reactivating the add-on, then re-entering your API key.

What You’ll Learn

  • Fix add-on license activation failures
  • Resolve missing add-on updates
  • Troubleshoot add-on update failures
  • Refresh your license when MainWP Pro add-ons ask you to upgrade

Prerequisites

  • MainWP Dashboard with add-ons installed
  • Valid MainWP API key(s) for your add-ons
  • Admin access to your Dashboard site

Add-on License Activation Fails

If your API key doesn’t activate an add-on:
1

Go to Plugins page

Navigate to WP Admin > Plugins.
2

Find the add-on

Locate the add-on that won’t activate.
3

Deactivate the add-on

Click Deactivate under the add-on.
4

Reactivate the add-on

Click Activate to reactivate it.
5

Go to Add-ons page

Navigate to MainWP > Add-ons.
6

Enter API key

Try to activate your API key again.

If Activation Still Fails


Add-on Updates Not Detected

Add-ons must be activated with your API key to receive automatic updates.
1

Verify license activation

Go to MainWP > Add-ons and confirm your add-ons show as activated.
2

If not activated, enter API key

Enter your API key to activate the add-on.
3

If already activated, deactivate the add-on

Go to WP Admin > Plugins, find the add-on, and click Deactivate.
4

Reactivate the add-on

Click Activate to reactivate it.
5

Re-enter API key

Go to MainWP > Add-ons and enter your API key again.
6

Check for updates

Go back to WP Admin > Plugins, find the add-on, and click the Check for Updates Now link in the add-on description.

Add-on Update Fails

If an add-on shows an available update but won’t install, reset the add-on activation and license connection before retrying the update:
1

Go to Plugins page

Navigate to WP Admin > Plugins.
2

Find the add-on

Locate the add-on that won’t update.
3

Deactivate the add-on

Click Deactivate under the add-on.
4

Reactivate the add-on

Click Activate to reactivate it.
5

Go to Add-ons page

Navigate to MainWP > Add-ons.
6

Activate the license

Activate the license for the add-on again.
7

Return to Plugins page

Go back to WP Admin > Plugins.
8

Try updating again

Attempt the update again.

If Update Still Fails


Add-ons Page Asks You to Upgrade to MainWP Pro

MainWP Dashboard saves your plan when it checks your license. If the saved plan is out of date, the Add-ons page or the Install Add-ons dialog can offer Upgrade to Pro even though you already have MainWP Pro. In MainWP Dashboard 6.4.1 and later, refresh your license to update the saved plan.
1

Open the Add-ons page

Go to MainWP > Add-ons.
2

Click Refresh License

Click Refresh License next to Already on MainWP Pro? or MainWP Pro includes all MainWP add-ons. The button also appears in the Install Add-ons dialog.
3

Check the result

MainWP re-checks your saved license key and reloads the page with your current plan. If the refresh fails, MainWP shows Could not refresh your license. Please try again. or the error returned by the license server.
Refresh License appears only when your license key is saved with Remember Key and you are an administrator who can manage add-ons. If you don’t see it, enter your API key again on the Add-ons page with Remember Key enabled. If the license server rejects the key, MainWP clears the saved plan. Verify the key in your MainWP account, then enter it again.

Check Your License Status

You can verify your add-on licenses and subscription status:
  1. Log in to MainWP.com
  2. Go to My Account > API Keys
  3. Check which API keys are active and where they’re being used
  4. Verify your subscription is active

Self-Check Checklist

  • Add-on is installed and activated as a plugin
  • API key entered on MainWP > Add-ons page
  • Add-on shows “Activated” status
  • Updates detected after clicking “Check for Updates Now”
  • Updates install successfully