diff --git a/docs/source/resources/define-metadata.rst b/docs/source/resources/define-metadata.rst
index ecb4515c17..e4b599c438 100644
--- a/docs/source/resources/define-metadata.rst
+++ b/docs/source/resources/define-metadata.rst
@@ -116,6 +116,18 @@ If an extracted archive contains only 1 folder at its top level, its contents
 will be moved 1 level up, so that the extracted package contents sit in the
 root of the work folder.
 
+You can also specify multiple URLs for the same source archive.
+They will be attempted in order, should one fail.
+
+.. code-block:: yaml
+
+   source:
+     url:
+       - https://archive.linux.duke.edu/cran/src/contrib/ggblanket_6.0.0.tar.gz
+       - https://archive.linux.duke.edu/cran/src/contrib/Archive/ggblanket/ggblanket_6.0.0.tar.gz
+     sha256: cd2181fe3d3365eaf36ff8bbbc90ea9d76c56d40e63386b4eefa0e3120ec6665
+
+
 Source from git
 ---------------