We're constantly improving MemberMouse with enhancements and new features. As a result, you'll be notified about upgrading your MemberMouse software from time to time in order to take advantage of the latest features.


If you're installing MemberMouse for the first time, click here for step-by-step instructions on installing MemberMouse.


IMPORTANT: If you have a cache plugin activated on your WordPress site, make sure that your clear the cache following the MemberMouse upgrade. Read this article to learn more about using cache plugins with MemberMouse.



Upgrade Best Practices


Upgrading software on your live production can be a daunting prospect. However, we encourage you not to let that stand in your way of taking advantage of the new features and bug fixes incorporated in our releases. We do our best to ensure the upgrade process will go as smoothly as possible by doing rigorous internal and beta testing.


With that said, it's impossible for us to cover all possible environments where MemberMouse can run -- we all use different themes, plugins and run on different server environments which introduces a huge amount of variables -- so it's generally a good practice to go through the following steps when making changes to a production environment:


  1. If you have a staging site that mirrors your live site, we recommend installing the latest version of MemberMouse there and running through some of the essential features of your site to ensure there are no conflicts between MemberMouse and any other plugins you're running.

  2. Prior to upgrading your live site, make a backup of your site so if necessary, you can revert. If you need to, you can download a previous version of the MemberMouse plugin.

  3. Prior to upgrading, make sure to review the release notes in case action is required by you in association with the upgrade.


Upgrading MemberMouse to the Latest Version


  1. When a new version of MemberMouse is available, you'll see a notification bar at the top of your pages within the WordPress admin area. Click the Please update now link to go to the WordPress Plugins page.


    Note: If you don't see the upgrade notification and you are on an older version of MemberMouse, from the MemberMouse menu, click on General Settings, and then from the Manage Install menu, click on Repair Install. Following this, go to the MemberMouse dashboard, and you should see the upgrade notification. If you are still not seeing the notification, you can follow these instructions to manually upgrade.


  2. Once on the WordPress Plugins page, scroll down to the MemberMouse plugin, and you'll see a message that says there's a new version of the MemberMouse plugin available. Click the update now link to start the update process.



  3. On most servers, after clicking the update now link, the update process will start automatically. However, sometimes additional security is required by the server, and WordPress will ask for your FTP credentials. Just fill out the form and click Proceed.






  4. During the update process, there's a short period of time when the MemberMouse plugin will be unavailable while old files are being updated with new files. On most hosting platforms, the update process will complete within 5-20 seconds, but in some cases, if your server performance is slow, it could take up to 2 minutes to complete. Please be patient and let the update complete fully. You should see something similar to this when the update has completed successfully.




    IMPORTANT: Once the plugin has been successfully updated, you need to manually reactivate it by clicking the Activate Plugin link on the Install Plugin page or by returning to the WordPress Plugins page, scrolling down to the MemberMouse plugin and clicking Activate.

  5. Following a MemberMouse upgrade, you may see a notification bar with a message that says that MemberMouse can't use the cache.



    MemberMouse utilizes a directory on your server to cache files in order to increase performance. When this message displays, it means that MemberMouse can't write to that directory because of a permissions issue. To correct this and allow MemberMouse to utilize the cache directory, just click the Click here to correct this link. Depending on your server configuration, WordPress may ask you for your FTP credentials in order to proceed.

    NOTE: When attempting to activate the plugin, if you receive the error "There was a problem downloading all the libraries necessary for proper MemberMouse function. You will need to download and install a different version of the plugin", you will need to download a version of MemberMouse that includes these libraries upon install, along with making a change to the upload size limit on your site. Those steps can be found here: Installation Error - Problem downloading libraries.