Updating PeepSo: Common Issues and Troubleshooting

Updating a free plugin is a very straightforward action in WordPress, but adding the paid add-ons into the mix can sometimes cause unnecessary headaches. In this blog post, I will touch every common mishap or issue you may face when updating paid add-ons and by the end of it, offer you plenty of useful information to take away. It will be a long read so grab a cup of coffee or your favorite tea, sit back, and let’s begin.


Free PeepSo Foundation plugin uses three number versioning logic (eg: 2.7.1) where the first number is Major version number, the second is build number, and the third is patch number. Paid add-ons also follow this convention and will always have the same version as the free Foundation plugin.

This is necessary to prevent versioning confusion that would inevitably occur if every paid add-on was to have its own, separate version number. Just imagine the mess we would end up if Photos plugin version 1.4.7 is only compatible with PeepSo 1.5.2 and Videos plugin version 2.1.5 is only compatible with PeepSo 2.6.3; it would be a nightmare to follow, maintain, and it would be hard for everyone.

Hence we applied the simple solution. Every paid add-on version is only compatible with free Foundation plugin of the same version.

Gecko Theme is slightly different but follows the same principle, although it uses four (4) numbers version schema.
For instance, Gecko Theme version is only compatible with PeepSo 2.7.1
The fourth number in Gecko Theme version is just a patch number. First three numbers should always be the same as the PeepSo version you are currently using.

Update Sources

  • Free Foundation plugin is updated through built-in WordPress update mechanisms. The update files are stored and retrieved from the WordPress plugin repository.
  • Paid add-ons and Gecko Theme are updated through mechanisms on PeepSo website. The update files are stored and retrieved from the PeepSo website.

Version Mismatch Lock

Having two separate update sources allows for making a very common mistake of updating Free Foundation plugin to the next available version, while leaving paid add-ons to linger in the previous version installed on the site. If this is the case, you will see the error as shown in the screenshot below:

Free Foundation plugin is updated to version 2.7.1 while paid add-ons remain on version 2.7.0

What this error tries to convey is that paid add-ons are not on the same version as Free Foundation plugin and they have entered the so called “version mismatch”. Plugins (and Gecko Theme, if applicable) in version mismatch will still be installed and enabled on the site, but most of their functionality will cease to work. In simple terms, you won’t be able to use them. Their configuration will not show on the backend, and features will not be available on the frontend.

Paid Add-on Updates Are Not Available

Sometimes you won’t be able to immediately see updates for paid add-ons. Because we use two different update sources, a short disparity will happen until WordPress update mechanics sync up. Usually, free Foundation plugin will be available immediately, however paid add-on updates can take up to several hours to show up. If this is the case, the simplest possible solution is to just wait until all updates for paid add-ons are available.

If updates for paid add-ons do not show after 12 hours, here is what you can try. Install and activate the Transients Manager Plugin. Transients are API that allow developers to store timely information in the database, and sometimes they can get stuck.

Navigate to your WP Admin -> Tools -> Transients and press the button “Delete All Transients”. Have no worries. WordPress will immediately generate new transients so you can never really see the list of transients being empty. With newly generated transients, navigate to WP Admin -> Dashboard -> Updates and press the button “Check Again”. Updates for paid add-ons should now be available.

If updates are still not available, there are several possible reasons why this might happen

  1. Your license has expired – Go to My Licenses page and see if your license is still active
  2. Licensed domain is not correct – Go to My Licenses page and click the “Manage Sites” link. Make sure that Site URL information matches the domain where you are attempting to make the update.
  3. License number is wrong – Compare the license number in WP Admin -> PeepSo -> Configuration with the one at My Licenses page.
  4. If the first three options have been utilized to no avail, contact our support and provide as many details as possible explaining what you have tried and what the outcome was.

Can’t Wait! Need Updates Now!

If your license is active, there is a simple, but relatively time consuming solution which can be done in less than 20 minutes. You can actually update all plugins manually. Before continuing, make sure you have the full working backup of the site.

After you have created the backup of the site and made absolutely sure that the backup is working, go to My Downloads page and download all PeepSo plugins again. Navigate to WP Admin -> PeepSo -> Configuration -> Advanced. Disable the following options if they aren’t already disabled, see screenshot below.

  • Delete Post and Comment data
  • Delete all data and settings
PeepSo options that needs to be disabled to prevent data loss if plugins are uninstalled

Disabling these two options will ensure that all your PeepSo data will be preserved even if you completely uninstall and remove plugins – which we are about to do.

Go to WP Admin -> Plugins and deactivate all PeepSo plugins, then delete them. Now install all PeepSo plugins back and activate them. You should now have completely updated PeepSo paid add-ons.


Manual update method can not be used to update Gecko Theme.

Changing and deleting the theme to reinstall it again will confuse WordPress and it will behave like the Theme is freshly installed, with all custom settings (or worse – CSS overrides) reverted to default.

How To Manually Update Gecko Theme

The only manual method of updating Themes in WordPress ecosystem is by replacing the files through FTP. You can download the theme, unzip the downloaded packages and then replace the files through FTP client. However, we don’t advise you to do this without the proper site backup, nor without having solid knowledge of what you’re doing. In any case, it is always a better and safer option to contact our support so we can investigate what went wrong with the update.

Don’t have the Bundle but you would like to have access to all current and future plugins hassle-free?

Check our offer!


Basic Bundle

Normally $129



Choose license option
Buy now

Get instant access to 5 premium PeepSo plugins & Gecko Theme.

  • No signup fees
  • 1 year of free updates
  • 30 days of Monday-Friday Technical Support
  • Our ❤
Ultimate Bundle

Normally $299



Choose license option
Buy now

Our most popular option. All access pass, including all 18 plugins & Gecko Theme and future plugins.

  • No signup fees
  • 1 year of free updates
  • 1 year of 24/7 * Technical Support
  • 1 year access to future plugins (if any)
  • Early Access Program
  • Our ❤❤❤
Ultimate – 5 Years

Normally: $899


/5 years

Choose license option
Buy now

Everything Ultimate Bundle has to offer and more. Pay for 3 years, get 2 years for free.

  • No signup fees
  • 5 years of free updates
  • 5 years of 24/7 * Technical Support
  • 5 years access to future plugins (if any)
  • Early Access Program
  • Our ❤❤❤❤
Ultimate – Monthly

Normally $59



Choose license option
Buy now

Not ready to handle a whole year in advance? Not a problem! We got your back.

  • $50 signup fee
  • Free updates with active license
  • Monday-Friday Technical Support with active license
  • Access to future plugins with active license
  • Early Access Program
  • Our ❤❤

Brought to you by PeepSo Team Siniša Krišan
I am experienced in various social networks and platforms. Among other things, I’m the guy you turn to for figuring out the feature’s details and resolving issues. I hail from Novi Sad, Serbia. My journey with Open Source had taken me across the globe to Bali, Indonesia, where I had spent several years working & evolving with the base PeepSo Team. I was involved with planning and development of very early versions of PeepSo and helped pushing the product forward. Although I tend to engage full workaholic mode, I am essentially a laid back person. I’m also a hardcore gamer and I enjoy playing video games with my girlfriend whenever I catch precious little spare time. I enjoy traveling and learning about new cultures and surroundings.

Reactions & comments

Join Our Community!
Join us to discuss PeepSo's features, connect with the development team and give suggestions.


@peepso_user_16279(Larry Backstrom)
Can you make a PeepSo Foundation pull for licensed users come from the PeepSo repository instead of WP to keep all plugins synced? If you did so, the WP PeepSo Foundation could or should lag by a period of time, say a week or more later. It could encourage a non-licensed user to become licensed.
January 27, 2020 8:46 pm
@peepso_user_13(Siniša Krišan)
@peepso_user_16279(Larry Backstrom) if we want to keep presence on WP directory, then we can't 🙁
January 28, 2020 6:15 am