diff --git a/docs/src/_static/Iris7_1_trim_100.png b/docs/src/_static/Iris7_1_trim_100.png
deleted file mode 100644
index 2f6f80eff9..0000000000
Binary files a/docs/src/_static/Iris7_1_trim_100.png and /dev/null differ
diff --git a/docs/src/_static/Iris7_1_trim_full.png b/docs/src/_static/Iris7_1_trim_full.png
deleted file mode 100644
index c381aa3a89..0000000000
Binary files a/docs/src/_static/Iris7_1_trim_full.png and /dev/null differ
diff --git a/docs/src/_static/README.md b/docs/src/_static/README.md
new file mode 100644
index 0000000000..b9f2877a30
--- /dev/null
+++ b/docs/src/_static/README.md
@@ -0,0 +1,31 @@
+# Iris logos
+
+[](iris-logo-title.svg)
+
+Code for generating the logos is at:
+[SciTools/marketing/iris/logo/generate_logo.py](https://github.com/SciTools/marketing/blob/master/iris/logo/generate_logo.py)
+
+See the docstring of the `generate_logo()` function for more information.
+
+## Why a scripted logo?
+
+SVG logos are ideal for source-controlled projects:
+
+* Low file size, with infinitely scaling quality
+* Universally recognised vector format, editable by many software packages
+* XML-style content = human-readable diff when changes are made
+
+But Iris' logo is difficult to reproduce/edit using an SVG editor alone:
+
+* Includes correctly projected, low resolution coastlines
+* Needs precise alignment of the 'visual centre' of the iris with the centres
+ of the Earth and the image
+
+An SVG image is simply XML format, so can be easily assembled automatically
+with a script, which can also be engineered to address the above problems.
+
+Further advantages of using a script:
+
+* Parameterised text, making it easy to standardise the logo across all Iris
+ packages
+* Can generate an animated GIF/SVG of a rotating Earth
diff --git a/docs/src/_static/favicon.ico b/docs/src/_static/favicon.ico
deleted file mode 100644
index 0e5f0492b4..0000000000
Binary files a/docs/src/_static/favicon.ico and /dev/null differ
diff --git a/docs/src/_static/iris-logo-title.png b/docs/src/_static/iris-logo-title.png
deleted file mode 100644
index e517aa7784..0000000000
Binary files a/docs/src/_static/iris-logo-title.png and /dev/null differ
diff --git a/docs/src/_static/iris-logo-title.svg b/docs/src/_static/iris-logo-title.svg
index 29b258d16f..5bc38bfbda 100644
--- a/docs/src/_static/iris-logo-title.svg
+++ b/docs/src/_static/iris-logo-title.svg
@@ -1,90 +1,107 @@
-
-
-
-
+
+
\ No newline at end of file
diff --git a/docs/src/_static/iris-logo.svg b/docs/src/_static/iris-logo.svg
new file mode 100644
index 0000000000..6c4bdb0e5a
--- /dev/null
+++ b/docs/src/_static/iris-logo.svg
@@ -0,0 +1,104 @@
+
+
+
+ Logo for the SciTools Iris project - https://github.com/SciTools/iris/
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/docs/src/conf.py b/docs/src/conf.py
index 348e7057fb..568f16c282 100644
--- a/docs/src/conf.py
+++ b/docs/src/conf.py
@@ -266,8 +266,8 @@ def _dotv(version):
# The theme to use for HTML and HTML Help pages. See the documentation for
# a list of builtin themes.
#
-html_logo = "_static/iris-logo-title.png"
-html_favicon = "_static/favicon.ico"
+html_logo = "_static/iris-logo-title.svg"
+html_favicon = "_static/iris-logo.svg"
html_theme = "pydata_sphinx_theme"
# See https://pydata-sphinx-theme.readthedocs.io/en/latest/user_guide/configuring.html#configure-the-search-bar-position