When I try to add a self-hosted site, I get an “The site at this address is not a WordPress site” error message. What do I do?

This error typically means that the WordPress app is not able to connect to your self-hosted site, either because the site URL is incorrect or because something is blocking the app from connecting using XML-RPC.

Here are some troubleshooting steps to try if you see this message:

  1. Ensure that you’ve typed in the URL correctly.
  2. If the URL is correct, make sure XML-RPC services are enabled on the site.
  3. Verify that xmlrpc.php is functioning properly by following steps 4-6
  4. Locate your RSD meta tag by viewing-source on your site. It will look similar to this:
<link title="RSD" href="http://www.mysite.com/xmlrpc.php?rsd" rel="EditURI" type="application/rsd+xml" />
  1. Next, follow the link, http://example.com/xmlrpc.php?rsd, and make sure it resolved to an XML file. Locate the WordPress API item: http://example.com/xmlrpc.php.
  2. Lastly, load that apiLink value into your browser. If everything is setup correctly, you should see this message: “XML-RPC server accepts POST requests only.”
  3. Go to the W3C Markup Validator and type in the URL of your WordPress site.
  4. If you get a response such as “… one or more bytes that I cannot interpret as UTF-8,” that is most likely what is causing the app to have trouble with your site.
  5. Switch your site to the default theme, deactivate any plugins, and try again, to help pin down where the problem is. If everything works, enable your theme and try again. If everything still works, reactivate each plugin one at a time reconnecting each time, until you find the one that is causing the breakage.
  6. Turn on the Debug Mode to enable the extended log format, and check the log file.