diff --git a/doc/api_assets/style.css b/doc/api_assets/style.css
index c23e486ef80b82..d314f3d990631b 100644
--- a/doc/api_assets/style.css
+++ b/doc/api_assets/style.css
@@ -373,6 +373,11 @@ p {
   padding-bottom: 2rem;
 }
 
+/* prevent the module-level sticky stability header from overlapping the section headers when clicked */
+#apicontent:has(> .api_stability) a {
+  scroll-margin-top: 50px;
+}
+
 table {
   border-collapse: collapse;
   margin: 0 0 1.5rem;
@@ -837,6 +842,9 @@ kbd {
   .api_stability {
     top: 0;
   }
+  #apicontent a {
+    scroll-margin-top: 0;
+  }
 }
 
 @media not screen, (max-height: 1000px) {