Having trouble with Jetpack or one of its features? If so, here are a few key steps that can help you solve the problem.
- Check if the error you received is listed on this page. If it is, follow the instructions there to solve the issue.
- Disable all other plugins, then try to connect or use Jetpack. If Jetpack then connects or works properly, turn your plugins back on one by one, until you see the error again. Note the plugin that caused this error and get in touch with us. Sometimes Jetpack and other plugins are incompatible. Let us know and we’ll see what we can do.
- If you have a display issue, or the plugin step above doesn’t help, activate one of the default WordPress themes, then try again. If your action starts working, it means that something in your theme is likely broken, and you should get in touch with your theme’s author. Be sure to let them know the troubleshooting steps that you’ve tried.
- 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 require your attention.
- Check your XMLRPC file. You can do this by going to your website URL and adding
/xmlrpc.phpto the end. 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 debugging steps.
- If you get a 404 error or “Not Found” message, contact your web host. They may have security in place that is blocking the XML-RPC file, which can cause issues with Jetpack.
- 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.
- Check the Known Issues list and make sure you aren’t using a plugin or theme listed there.
- 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.
- To verify your Jetpack connection, visit your website, copy the home URL, and paste it in the Jetpack Debugger. You will see the message “Everything looks great!” if all of the tests pass. If you get an error, try reconnecting Jetpack using these steps:
- Open the dashboard on your site and go to Jetpack > Dashboard > Connections > Manage Site Connection.
- Click the Disconnect button.
- Click Connect Jetpack button and continue through the connection process.
- Check the Jetpack Debugger for your site again. If there is still an error, contact support.
- If you get intermittent errors from the Jetpack Debugger, try ruling out site loading speed issues by using a tool such as WebPageTest.
If you still have trouble after trying the above, don’t hesitate to send us an email!