> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mainwp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshoot add-on licensing issues

> Troubleshoot MainWP add-on licensing issues including failed activation, updates not detected, and update failures. Deactivate and reactivate add-ons on the Plugins page, then re-enter API keys.

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

| Issue | Solution |
| - | - |
| API key invalid | Verify the key in your [MainWP account](https://mainwp.com/my-account/) |
| Key already in use | Deactivate from the other site first |
| Connection timeout | Check firewall isn't blocking mainwp.com |
| Subscription expired | Renew your subscription |

***

## 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

| Issue | Solution |
| - | - |
| License expired | Renew your subscription to receive updates |
| Server timeout | Increase PHP max\_execution\_time |
| Write permissions | Check wp-content/plugins folder permissions |
| Download failed | Verify mainwp.com is accessible from your server |

***

## 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](https://mainwp.com/my-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](https://mainwp.com/my-account/)
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

***

## Related Resources

* [Manage Add-ons](https://docs.mainwp.com/dashboard/overview/manage-extensions.md) - Add-on installation and management
* [Why Is My Add-ons Page Empty](https://docs.mainwp.com/troubleshooting/why-is-my-extensions-page-empty.md) - Missing add-ons
* [Resolve System Requirements](https://docs.mainwp.com/troubleshooting/resolve-system-requirement-issues.md) - Server configuration issues


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.