From 8c29a6e491e32da38aa048ed4fe81213c213623d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Mike=20F=C3=A4hrmann?= <mike_faehrmann@web.de>
Date: Tue, 28 Sep 2021 22:59:37 +0200
Subject: [PATCH] add example for 'url-metadata' option (closes #1884)

---
 docs/configuration.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/docs/configuration.rst b/docs/configuration.rst
index 53c99aad..7a9e6ef0 100644
--- a/docs/configuration.rst
+++ b/docs/configuration.rst
@@ -524,6 +524,12 @@ Default
 Description
     Insert a file's download URL into its metadata dictionary as the given name.
 
+    For example, setting this option to ``"gdl_file_url"`` will cause a new
+    metadata field with name ``gdl_file_url`` to appear, which contains the
+    current file's download URL.
+    This can then be used in `filenames <extractor.*.filename_>`_,
+    with a ``metadata`` post processor, etc.
+
 
 extractor.*.category-transfer
 -----------------------------