Enabling XML-RPC blocking

Overview

XML-RPC (XML remote procedure call) blocking protects your website by refusing requests to its xmlrpc.php file, and DreamHost enables it by default on all fully hosted websites. You can enable or disable XML-RPC blocking for your website from the DreamHost panel. This article explains what XML-RPC is, why blocking is enabled by default, and when and how to disable it.

Background

XML-RPC is a WordPress feature that lets apps and services connect to your website through the xmlrpc.php file. Most websites no longer need it, but attackers commonly use it to guess passwords and to overload websites with unwanted traffic. DreamHost applies the block at the web server level (Apache and nginx), not inside WordPress, so XML-RPC blocking applies to all fully hosted websites, not only WordPress sites. However, it only has an effect on websites that have an xmlrpc.php file, which are mainly WordPress websites.

How do I enable or disable XML-RPC blocking in the panel?

To enable or disable XML-RPC blocking for a website:

  1. Navigate to the Manage Websites page.

  2. Click the Manage button to open Website settings, which allows you to modify various configurations for your site.

    • If in Grid view, click the Manage button at the bottom of the website box.

    • If in List view, click the Manage button at the far right of your domain name.

  3. Click the Security tab.

  4. In the Website Security section, click the toggle to the right of Block XML-RPC to enable or disable it.

  5. Click the Save Changes button.

The Block XML-RPC option prevents requests to your website's xmlrpc.php file from reaching your website. With this enabled, DreamHost blocks the most common attacks that target XML-RPC. The rest of your website continues to work normally.

Disabling XML-RPC blocking exposes your website to password-guessing attacks and unwanted traffic through xmlrpc.php. Only disable it if an app or service you use requires XML-RPC.

How does XML-RPC blocking work at DreamHost?

The following sections explain what XML-RPC is, what this option blocks, and when you may need to disable it.

What is XML-RPC?

XML-RPC is a feature built into WordPress. It lets other apps and services connect to your website and perform actions without logging into your WordPress dashboard. In the past, it was used to publish posts from desktop or mobile apps and to send and receive pingbacks, which are notifications that another website linked to your post.

Today, WordPress uses a newer and more secure feature called the REST API for most of these tasks. As a result, most websites no longer need XML-RPC.

Why is XML-RPC blocking enabled by default?

Attackers know that most WordPress websites have an xmlrpc.php file, and they commonly use it to:

  • Guess your passwords — XML-RPC lets an attacker try hundreds of passwords in a single request, which is much faster than guessing through the regular login page.

  • Overload your website — Large volumes of XML-RPC requests can slow down or crash your website.

What is blocked when this option is enabled?

When XML-RPC blocking is enabled, any request to xmlrpc.php is refused with a 403 Forbidden response at the web server level, before it reaches your website.

What happensEnabled (default)Disabled
Visitors browsing your websiteWorksWorks
Logging into your WordPress dashboardWorksWorks
Apps and services that use XML-RPCBlockedWorks
Pingbacks from other websitesBlockedWorks
Attacks through xmlrpc.phpBlockedNot blocked

When should I disable XML-RPC blocking?

Only disable XML-RPC blocking if an app, plugin, or service you use requires XML-RPC to connect to your website. For example, a remote publishing tool may stop working, and its documentation may say it uses XML-RPC.

If you disable it, DreamHost recommends that you:

  • Use a strong, unique password for every WordPress user.

  • Keep WordPress, your themes, and your plugins up to date.

  • Enable XML-RPC blocking again if you stop using the app or service that needed it.

Which websites have this option?

The Block XML-RPC option is available for websites that are fully hosted with DreamHost. It is not available for parked domains or domains set up as a redirect.

FAQs

Does XML-RPC blocking apply only to WordPress websites?

No. DreamHost applies the block at the web server level (Apache and nginx), so it applies to all fully hosted websites, not only WordPress sites. However, if your website doesn’t have an xmlrpc.php file, enabling or disabling this option makes no difference.

Will XML-RPC blocking affect my visitors or my WordPress login?

No. Visitors can still browse your website, and you can still log in to your WordPress dashboard. XML-RPC blocking only refuses requests to the xmlrpc.php file.

See also

This form is only for article feedback. If you require assistance, please contact support. Do not include passwords, account numbers, or other private account details.

Did this article answer your questions?

Article last updated PST.

Still not finding what you're looking for?