diff --git a/beetsplug/fetchart.py b/beetsplug/fetchart.py
index 22e2be56c..6c7984845 100644
--- a/beetsplug/fetchart.py
+++ b/beetsplug/fetchart.py
@@ -762,7 +762,8 @@ class FetchArtPlugin(plugins.BeetsPlugin, RequestMixin):
         if 'remote_priority' in self.config:
             self._log.warning(
                 u'The `fetch_art.remote_priority` configuration option has '
-                u'been deprecated, see the documentation.')
+                u'been deprecated. Instead, place `filesystem` at the end of '
+                u'your `sources` list.')
             if self.config['remote_priority'].get(bool):
                 try:
                     sources_name.remove(u'filesystem')
diff --git a/docs/plugins/fetchart.rst b/docs/plugins/fetchart.rst
index 2812c7745..7856521a9 100644
--- a/docs/plugins/fetchart.rst
+++ b/docs/plugins/fetchart.rst
@@ -69,6 +69,14 @@ file. The available options are:
 Note: ``minwidth`` and ``enforce_ratio`` options require either `ImageMagick`_
 or `Pillow`_.
 
+.. note::
+
+    Previously, there was a `remote_priority` option to specify when to
+    look for art on the filesystem. This is
+    still respected, but a deprecation message will be shown until you
+    replace this configuration with the new `filesystem` value in the
+    `sources` array.
+
 .. _beets custom search engine: https://cse.google.com.au:443/cse/publicurl?cx=001442825323518660753:hrh5ch1gjzm
 .. _Pillow: https://github.com/python-pillow/Pillow
 .. _ImageMagick: http://www.imagemagick.org/