diff --git a/CHANGES b/CHANGES
index c939f56345d..e5a29a31f01 100644
--- a/CHANGES
+++ b/CHANGES
@@ -79,6 +79,9 @@ Deprecated
Features added
--------------
+* #10444: html theme: Allow specifying multiple CSS files through the ``stylesheet``
+ setting in ``theme.conf`` or by setting ``html_style`` to an iterable of strings.
+
Bugs fixed
----------
diff --git a/doc/development/theming.rst b/doc/development/theming.rst
index fcbeb030a61..b46ba0362e6 100644
--- a/doc/development/theming.rst
+++ b/doc/development/theming.rst
@@ -56,10 +56,10 @@ Python :mod:`ConfigParser` module) and has the following structure:
want to also inherit the stylesheet, include it via CSS' ``@import`` in your
own.
-* The **stylesheet** setting gives the name of a CSS file which will be
- referenced in the HTML header. If you need more than one CSS file, either
- include one from the other via CSS' ``@import``, or use a custom HTML template
- that adds ```` tags as necessary. Setting the
+* The **stylesheet** setting gives a list of CSS filenames separated commas which
+ will be referenced in the HTML header. You can also use CSS' ``@import``
+ technique to include one from the other, or use a custom HTML template that
+ adds ```` tags as necessary. Setting the
:confval:`html_style` config value will override this setting.
* The **pygments_style** setting gives the name of a Pygments style to use for
@@ -82,6 +82,9 @@ Python :mod:`ConfigParser` module) and has the following structure:
.. versionadded:: 1.7
sidebar settings
+.. versionchanged:: 5.1
+
+ The stylesheet setting accepts multiple CSS filenames
.. _distribute-your-theme:
diff --git a/doc/templating.rst b/doc/templating.rst
index e174adbec78..27f56eb4499 100644
--- a/doc/templating.rst
+++ b/doc/templating.rst
@@ -392,11 +392,29 @@ in the future.
.. versionadded:: 5.0.2
+.. data:: styles
+
+ A list of the names of the main stylesheets as given by the theme or
+ :confval:`html_style`.
+
+ .. versionadded:: 5.1
+
.. data:: style
The name of the main stylesheet, as given by the theme or
:confval:`html_style`.
+ .. versionchanged:: 5.1
+
+ The theme or :confval:`html_style` are now able to specify multiple
+ stylesheets, the ``style`` key returns the last stylesheet when more than
+ one is specified.
+
+ .. deprecated:: 5.1
+
+ Use the :data:`styles` key instead, as there is no longer a single main
+ stylesheet. The ``style`` key will be removed in Sphinx 7.0.
+
.. data:: title
The title of the current document, as used in the ``