diff --git a/docs/reference/config.rst b/docs/reference/config.rst
index 94ec61a72..aad9d4bdf 100644
--- a/docs/reference/config.rst
+++ b/docs/reference/config.rst
@@ -716,18 +716,6 @@ Default: ``{}`` (empty).
 MusicBrainz Options
 -------------------
 
-Default configuration::
-
-    musicbrainz:
-        enabled: yes
-        host: musicbrainz.org
-        https: no
-        ratelimit: 1
-        ratelimit_interval: 1.0
-        searchlimit: 5
-        extra_tags: []
-        genres: no
-
 .. _musicbrainz.enabled:
 
 enabled
@@ -739,16 +727,6 @@ process quicker.
 
 Default: ``yes``.
 
-.. _host:
-
-host
-~~~~
-
-The ``host`` key, of course, controls the Web server hostname (and port,
-optionally) that will be contacted by beets.
-
-Default: ``musicbrainz.org``
-
 You can instruct beets to use `your own MusicBrainz database`_ instead of
 the `main server`_. Use the ``host``, ``https`` and ``ratelimit`` options
 under a ``musicbrainz:`` header, like so::
@@ -758,27 +736,16 @@ under a ``musicbrainz:`` header, like so::
         https: no
         ratelimit: 100
 
-.. _https:
-
-https
-~~~~~
-
+The ``host`` key, of course, controls the Web server hostname (and port,
+optionally) that will be contacted by beets (default: musicbrainz.org).
 The ``https`` key makes the client use HTTPS instead of HTTP. This setting applies
-only to custom servers. The official MusicBrainz server always uses HTTPS.
+only to custom servers. The official MusicBrainz server always uses HTTPS. (Default: no.)
 The server must have search indices enabled (see `Building search indexes`_).
 
-Default: ``no``
-
-.. _ratelimit and ratelimit_interval:
-
-ratelimit and ratelimit_interval
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-``ratelimit`` many requests will be sent per ``ratelimit_interval`` by the Web service.
-**Do not change these settings** if you're using the main MusicBrainz
-server - on this public server, you're `limited`_ to one request per second.
-
-Default: ``1`` and ``1.0``
+The ``ratelimit`` option, an integer, controls the number of Web service requests
+per second (default: 1). **Do not change the rate limit setting** if you're
+using the main MusicBrainz server---on this public server, you're `limited`_
+to one request per second.
 
 .. _your own MusicBrainz database: https://musicbrainz.org/doc/MusicBrainz_Server/Setup
 .. _main server: https://musicbrainz.org/
@@ -824,7 +791,6 @@ Use MusicBrainz genre tags to populate (and replace if it's already set) the
 ``genre`` tag.  This will make it a list of all the genres tagged for the
 release and the release-group on MusicBrainz, separated by "; " and sorted by
 the total number of votes.
-
 Default: ``no``
 
 .. _match-config: