diff --git a/README.rst b/README.rst
index caa6c056c4..63fcc0f18c 100644
--- a/README.rst
+++ b/README.rst
@@ -74,7 +74,12 @@ Install ``plone.restapi`` by adding it to your buildout.
 Python / Plone Compatibility
 ============================
 
-plone.restapi 8 and 9 require Python 3 and work with Plone 5.2 and Plone 6.x.
+plone.restapi 9 requires Python 3 and works with Plone 5.2 and Plone 6.x.
+
+plone.restapi 8 entered "maintenance" mode with the release of plone.restapi 9 (September 2023).
+It is not planned to backport any features to this version and we highly recommend to upgrade to plone.restapi 9.
+plone.restapi 8 will receive security releases (if they are any) for the next two years (until September 2025).
+After September 2025 it will be unsupported.
 
 Python versions that reached their `end-of-life <https://devguide.python.org/versions/>`_,
 including Python 3.6 and Python 3.7 are not supported any longer.
diff --git a/docs/source/upgrade-guide.md b/docs/source/upgrade-guide.md
index 8ea4a5f110..98c5455bcd 100644
--- a/docs/source/upgrade-guide.md
+++ b/docs/source/upgrade-guide.md
@@ -14,6 +14,10 @@ It explains the steps that are needed to upgrade to the latest version.
 
 ## Upgrading to `plone.restapi` 9.x
 
+`plone.restapi` 9.x dropped support for Python 3.7, which reached its `end-of-life <https://devguide.python.org/versions/>`_ in July 2023.
+
+Upgrading to `plone.restapi` 9.x might require minor changes to your code base that are described in this section. If you are using a recent version of Volto, there are no changes necessary.
+
 ### Link Integrity
 
 When calling the @linkintegrity endpoint in `plone.restapi` before 9.0.0, a content object with no link integrity breaches would return just an empty list in the response body: