From 2e5394246fafcc1a41b43fb75c24c47a1b95620c Mon Sep 17 00:00:00 2001
From: J0J0 Todos <jojo@peek-a-boo.at>
Date: Fri, 4 Nov 2022 17:51:27 +0100
Subject: [PATCH] Docs for #4708

---
 docs/plugins/index.rst    |  2 ++
 docs/reference/config.rst | 26 ++++++++++++++++++++++++++
 2 files changed, 28 insertions(+)

diff --git a/docs/plugins/index.rst b/docs/plugins/index.rst
index ea13d2feb..4256ad690 100644
--- a/docs/plugins/index.rst
+++ b/docs/plugins/index.rst
@@ -129,6 +129,8 @@ following to your configuration::
    web
    zero
 
+.. _autotagger_extensions:
+
 Autotagger Extensions
 ---------------------
 
diff --git a/docs/reference/config.rst b/docs/reference/config.rst
index b6fa8fea6..f162c6762 100644
--- a/docs/reference/config.rst
+++ b/docs/reference/config.rst
@@ -842,6 +842,32 @@ release and the release-group on MusicBrainz, separated by "; " and sorted by
 the total number of votes.
 Default: ``no``
 
+.. _musicbrainz.external_ids:
+
+external_ids
+~~~~~~~~~~~~
+
+Set any of the ``external_ids`` options to ``yes`` to enable the MusicBrainz
+importer to look for links to related metadata sources. If such a link is
+available the release ID will be extracted from the URL provided and imported
+to the beets library.
+
+    musicbrainz:
+        external_ids:
+            discogs: yes
+            spotify: yes
+            bandcamp: yes
+            beatport: yes
+            deezer: yes
+
+
+The library fields of the corresponding :ref:`autotagger_extensions` are used
+to save the data (``discogs_albumid``, ``bandcamp_album_id``,
+``spotify_album_id``, ``beatport_album_id``, ``deezer_album_id``). On
+re-imports existing data will be overwritten.
+
+The default of all options is ``no``.
+
 .. _match-config:
 
 Autotagger Matching Options