Are you having trouble with Jetpack or one of its components? 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, you can follow the instructions there to solve the issue.
- Disable all other plugins, then try connecting or using Jetpack. If Jetpack starts connecting or working properly, turn your plugins back on one-by-one until you start seeing the error again. Then note the plugin that caused this error and get in touch with us. Sometimes Jetpack and other plugins are incompatible; just let us know and we’ll see what we can do.
- If you are having a display issue, or the plugin step above doesn’t help, try activating Twenty Fifteen or Twenty Sixteen (one of the default WordPress themes) as your theme. Then try again. If your action starts working, 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 have tried.
- Check your XMLRPC file. You can do this by going to your web site URL and adding “/xmlrpc.php” to the end (without the quotes). 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 is displaying extra characters when it shouldn’t. See points 2 and 3 above for debugging steps.
- If you get an 404 Error Not Found message, contact your web host. They may have security in place that is blocking XML-RPC.
- Do you use an SSL certificate on your site? Try adding the following to your site’s wp-config.php file:
define( 'JETPACK_SIGNATURE__HTTPS_PORT', 80 );
This works on hosts that have SSL terminate on a reverse proxy and the server itself is still listening on port 80 or something similar.
Alternatively, you could add this to your wp-config.php file (please not both!):
$_SERVER['SERVER_PORT'] = 443;
This sets the server port to 443 for the whole site.
- If your site can’t make outbound HTTPS requests (for example, because your server has old or missing root certificates) and you don’t have access to fix the problem, you can force Jetpack to connect to WordPress.com via regular HTTP by setting this variable in your wp-config.php:
define( 'JETPACK_CLIENT__HTTPS', 'NEVER' );
- 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.
If you still have trouble after trying the above, don’t hesitate to send us an email!