From 94ff7abe78a7fbba2ba142ec40181e5fe13ba68d Mon Sep 17 00:00:00 2001
From: Gabriel Dugny <gabriel.dugny@believe.com>
Date: Wed, 7 Jan 2026 14:22:19 +0100
Subject: [PATCH] fix(techdocs): Code block Copy To Clipboard button layout
 with latest mkdocs-material

Signed-off-by: Gabriel Dugny <gabriel.dugny@believe.com>
---
 .changeset/some-spiders-serve.md                         | 5 +++++
 .../techdocs/src/reader/transformers/copyToClipboard.tsx | 9 ++++++++-
 2 files changed, 13 insertions(+), 1 deletion(-)
 create mode 100644 .changeset/some-spiders-serve.md

diff --git a/.changeset/some-spiders-serve.md b/.changeset/some-spiders-serve.md
new file mode 100644
index 0000000000..0fb7f92ee5
--- /dev/null
+++ b/.changeset/some-spiders-serve.md
@@ -0,0 +1,5 @@
+---
+'@backstage/plugin-techdocs': patch
+---
+
+Code block "Copy to clipboard" button was not positioned correctly for docs built with `mkdocs-material>=9.7`
diff --git a/plugins/techdocs/src/reader/transformers/copyToClipboard.tsx b/plugins/techdocs/src/reader/transformers/copyToClipboard.tsx
index d34a05fa06..004995937e 100644
--- a/plugins/techdocs/src/reader/transformers/copyToClipboard.tsx
+++ b/plugins/techdocs/src/reader/transformers/copyToClipboard.tsx
@@ -67,7 +67,12 @@ const CopyToClipboardButton = ({ text }: CopyToClipboardButtonProps) => {
       leaveDelay={1000}
     >
       <IconButton
-        style={{ position: 'absolute' }}
+        style={{
+          position: 'absolute',
+          // top & right was removed from upstream .md-clipboard in mkdocs-material 9.7.0
+          top: '0.5rem',
+          right: '0.5rem',
+        }}
         className="md-clipboard md-icon"
         onClick={handleClick}
         aria-label="Copy to clipboard"
@@ -81,6 +86,8 @@ const CopyToClipboardButton = ({ text }: CopyToClipboardButtonProps) => {
 /**
  * Recreates copy-to-clipboard functionality attached to <code> snippets that
  * is native to mkdocs-material theme.
+ *
+ * Unlike native mkdocs-material theme, this is always enabled and does not respect the mkdocs's config `theme.features` `content.code.copy` setting.
  */
 export const copyToClipboard = (theme: Theme): Transformer => {
   return dom => {