Troubleshooting Tips

Having trouble with Jetpack or one of its features? If so, here are a few key steps that can help you solve the problem:

1. Check if the error you received is listed on this page. If it is, follow the instructions there to fix the issue.
2. Disable all of your other plugins, then try to connect or use Jetpack. If Jetpack then works properly, activate your other plugins again one by one until you see the problem again, then note the plugin that caused the issue and get in touch with us. Sometimes Jetpack and other plugins aren’t compatible. Let us know and we’ll point you in the right direction.
3. If you have a display issue, or the plugin troubleshooting above doesn’t help, install and activate one of the default WordPress themes (such as Twenty Twenty), then try again. If Jetpack features start working normally, then it means that something in your other theme is likely broken or incompatible, and you should get in touch with that theme’s authors. Be sure to let them know the troubleshooting steps that you’ve already tried.
4. Check your site’s health status under Tools > Site Health. This page will run a number of different checks and provide important information about your WordPress configuration and any items that could require your attention.
5. Check your XML-RPC file. You can do this by typing out your website’s domain in your browser’s address bar and adding /xmlrpc.php to the end of the address. When it loads in your browser, you should see “XML-RPC server accepts POST requests only” on a line by itself.
   • If you see this message, but it is not on a line by itself, a theme or plugin may be displaying extra characters when it shouldn’t. See points 2 and 3 above for troubleshooting steps.
   • If you get a 404 error or “Not Found” message, contact your webhost. They may have security in place that is blocking the XML-RPC file, which can cause issues with Jetpack and other plugins.
   • The XML-RPC file may not be in the root folder of your WordPress install, in which case Jetpack will not work. Reinstalling the core of WordPress should replace it, or you can ask your host to do so.
6. Check the Known Issues list and make sure you aren’t using a plugin or theme listed there.
7. If you were using Development Mode, check your wp-config.php file and make sure that define('JETPACK_DEV_DEBUG', true); is no longer present.
8. To verify your Jetpack connection, visit your website, copy the URL from your browser’s address bar, and paste it in the Jetpack Debug. You will see the message “Everything looks great!” if all of the tests pass. If you get an error, try reconnecting Jetpack using these exact steps:
   1. Log into the wp-admin dashboard of your site and go to Jetpack > Dashboard > Connections > Manage Site Connection.
   2. Click the Disconnect button.
   3. Click Connect Jetpack button and continue through the process on screen.
   4. Check the Jetpack Debug for your site again. If there is still an error, contact support.
9. If you get intermittent errors from the Jetpack Debug (it works sometimes, but not all the time), try ruling out site loading speed issues by using a tool such as WebPageTest. If the performance of your site or server dips now and then, it could cause Jetpack to not be able to connect. If you find evidence of this happening, please present that to your webhost – since they have direct access to your site and server, they are the best first step to look into improving your site’s speed.

If you still have trouble after trying all of the above, please don’t hesitate to contact us!