Basic troubleshooting

If your site is not looking or behaving as expected, you need to follow some basic troubleshooting steps to figure out the problem.

Troubleshooting email issues

For issues with emails not being sent/received, please follow our troubleshooting guide.

Troubleshooting Plugin and Theme issues

Important Before making any changes, please create a full backup of the website. You can use an automated backup plugin such as Jetpack Backups or follow this guide.

Troubleshooting plugin issues

Suppose you noticed an issue, a broken functionality, a layout problem, or any other discrepancy between what our WP Job Manager plugin and its core add-ons should do and what’s going on on your site. Try disabling all of your plugins except WP Job Manager (and add-ons). Then try testing again to see if the issue persists.

If the issue gets resolved this way, start activating the plugins one by one and checking whether the problem is back after each activated plugin. Once you activate a plugin and the issue is back, you’ve found the culprit!

Make sure to reach out to the plugin support and report the issue so that they can troubleshoot it and fix it on their side.

Troubleshooting Theme issues

If that doesn’t help, you will need to do the same thing with your theme. Try switching the theme to one of the WordPress default themes (such as Twenty Twenty-Two) and see if the problem persists. If the problem goes away, you should reach out to the theme authors for assistance.

You can also check our guide for dealing with troublesome themes.

Troubleshooting on a Staging site

Quite often, it’s not easy to do the plugin and theme dance on your live site. You don’t want to confuse or lose customers while your site appears broken. In that case, creating a staging site for troubleshooting is the best solution. Many hosts provide a staging service, where you can do testing without affecting the live site. You can ask your host about this. If they don’t give you a staging site, you could try WP Staging or Duplicator:

Troubleshooting using the Health Check plugin

Troubleshooting allows you to have a clean WordPress session, where all plugins are disabled, and a default theme is used, but only for your user until you disable it or log out.

When utilizing the troubleshooting mode, your currently logged-in user is given a stripped-down version of WordPress, where all plugins are disabled and one of the default themes is activated.

It is important to note that this is only the case for your user, it does not affect any other site visitors, or users of your site, for them the theme will be the same, and all plugins will still be running as before.

This mode is essential when trying to identify the cause of an issue, as in most cases, any issue you have will be introduced by your theme or one of your plugins (or maybe even multiple plugins interacting poorly with each other).

When in troubleshooting mode you are able to verify if a problem still exists in a basic WordPress setup, thus helping us identify and fix a bug others may be encountering, or finding out which plugin or your theme is causing the problems so that you can report this to the plugin or theme authors.

For more details and step by step instructions please follow this Troubleshooting using the Health Check guide.

Deactivating Plugins or themes via an FTP client or cPanel

Sometimes, the problems caused by plugins can prevent you from accessing the plugins page or your site in general! If that’s the case, you can deactivate all plugins at once by renaming the wp-content/plugins folder to wp-content/plugins-old This action will deactivate all plugins, and you’ll be able to regain access to your site’s admin.

You can access the files and folders that make up your website via cPanel or an FTP client such as FileZilla.

If you need to deactivate the theme through FTP, you can follow the same procedure you did for the plugins. Navigate to the wp-content/theme folder and rename the active theme folder. You need to have at least one WordPress default theme installed for this to work!

Next Steps

Once you locate the problematic plugin or a theme, make sure to get in touch with their support team and notify them about the issue you experienced.

On the other side, if deactivating the plugins doesn’t fix the issue, and there’s still a problem with WP Job Manager’s functionality, please reach out to us on our official forum or via our support page for core add-ons.

Troubleshooting Documentation