diff --git a/docs/examples/styles/text_opacity.css b/docs/examples/styles/text_opacity.css
new file mode 100644
index 000000000..882cc8acb
--- /dev/null
+++ b/docs/examples/styles/text_opacity.css
@@ -0,0 +1,25 @@
+#zero-opacity {
+    text-opacity: 0%;
+}
+
+#quarter-opacity {
+    text-opacity: 25%;
+}
+
+#half-opacity {
+    text-opacity: 50%;
+}
+
+#three-quarter-opacity {
+    text-opacity: 75%;
+}
+
+#full-opacity {
+    text-opacity: 100%;
+}
+
+Static {
+    height: 1fr;
+    text-align: center;
+    text-style: bold;
+}
diff --git a/docs/examples/styles/text_opacity.py b/docs/examples/styles/text_opacity.py
new file mode 100644
index 000000000..a2e9dcff2
--- /dev/null
+++ b/docs/examples/styles/text_opacity.py
@@ -0,0 +1,14 @@
+from textual.app import App
+from textual.widgets import Static
+
+
+class TextOpacityApp(App):
+    def compose(self):
+        yield Static("text-opacity: 0%", id="zero-opacity")
+        yield Static("text-opacity: 25%", id="quarter-opacity")
+        yield Static("text-opacity: 50%", id="half-opacity")
+        yield Static("text-opacity: 75%", id="three-quarter-opacity")
+        yield Static("text-opacity: 100%", id="full-opacity")
+
+
+app = TextOpacityApp(css_path="text_opacity.css")
diff --git a/docs/styles/text_opacity.md b/docs/styles/text_opacity.md
new file mode 100644
index 000000000..e69de29bb