Hey there! If you’re using (or want to use) Jetpack on your self-hosted WordPress site and if you’re having trouble connecting Jetpack to WordPress.com then this post is for you!
Note: This post was originally written on July 13, 2017 and moved here (to thecuriousengineer.com) from my old blog on 7 September 2020.
I work as a Happiness Engineer at Automattic (the company behind WordPress.com) and I’m going to share some tips on how you can troubleshoot the issue before reaching out to the Jetpack support team.
These tips may not necessarily solve your issue but it will surely help you to provide more details to the support team, which in turn will help them to solve the issue faster!
1. Check the Jetpack Debugger
If there’s something wrong with the Jetpack connection, if you’re unable to connect, the very first thing you can do is check the Jetpack debugger located here.
It’ll let you know the status of your site’s Jetpack connection (all good/not good).
2. Check xmlrpc.php
Jetpack needs this file to connect to WordPress.com! You have to make two checks here (and both of those should work).
This page should return the following message:
XML-RPC server accepts POST requests only.
The message should look exactly the same (without any spaces or line breaks). You can check an example of working xmlrpc.php file on the Jetpack site here.
You must run the following command in the terminal (by replacing the jetpack.com site with your site’s domain name):
curl -A "Jetpack by WordPress.com" -is -H 'Content-Type: text/xml' --data '<?xml version="1.0"?><methodCall><methodName>demo.sayHello</methodName><params></params></methodCall>' 'https://jetpack.com/xmlrpc.php' && echo
And it must return something like this:
<?xml version="1.0" encoding="UTF-8"?> <methodResponse> <params> <param> <value> <string>Hello!</string> </value> </param> </params> </methodResponse>
These two tests indicate your site’s
xmlrpc.php is correctly setup, if the results of both the tests match the results in this post.
If something is off with your
xmlrpc.php, I’d suggest you to contact your host (instead of contacting Jetpack support).
3. Reinstall and Reconnect Jetpack
Sometimes turning things off and on actually helps to fix them. So try this out and see if things work:
- Go to Jetpack > Dashboard
- Scroll down to connections and disconnect Jetpack
- Go to Plugins and deactivate+delete Jetpack
- Now go to Plugins > Add new and search for Jetpack
- Install it, activate it and attempt to connect again
- If the connection doesn’t work, check other points in this post (esp the #4th one).
4. Plugin Conflict
Sometimes other plugins create a conflict with Jetpack and that blocks jetpack from connecting to WordPress.com. To eliminate the possibility of a plugin conflict, just deactivate all the plugins and then reinstall Jetpack (point #3).
5. Theme Issue
If you’re using a theme which is not well-coded, then the theme could be creating issues with Jetpack’s connection. So if you’ve any doubt over your theme, just switch to one of the default WordPress themes (like twenty seventeen) and see if that helps!
6. Site Speed
Your site must load within the first 5-10 seconds (mostly 5 secs) for the Jetpack connection to work correctly. And you can check your site’s speed and overall performance at:
7. SSL Certificate
If you’re using an SSL Certificate for your site then you should check it’s grade at
It should be A or A+ and you shouldn’t see any errors here. The most common error here is that the
certificate is self-signed.
If you’re seeing any errors in the SSL test, you should report this directly to your host as they’re the only ones who can fix these issues!
8. WordPress Issues
If you delete Jetpack from your site and you still continue to see errors or problems on your site then those errors are mostly related to your site’s WordPress installation or any other plugins that you might’ve installed on the site.
In this case (when you’re sure that the issue is not related to Jetpack), you should reach out to WordPress.org support forums on this address:
If none of the above works or if you’ve any questions related to Jetpack, please feel free to contact Jetpack’s support staff by clicking here 🙂