From 72d2430aab0c3f703de4b98da5d11fc98bb3a0b2 Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Tue, 7 Jul 2026 23:56:44 +0200
Subject: [PATCH] DOC: Document ax.transData and ax.transAxes

closes #25220.
---
 doc/api/axes_api.rst         |  2 ++
 lib/matplotlib/axes/_base.py | 12 ++++++++++++
 2 files changed, 14 insertions(+)

diff --git a/doc/api/axes_api.rst b/doc/api/axes_api.rst
index 951af03a851b..2af17b1b619a 100644
--- a/doc/api/axes_api.rst
+++ b/doc/api/axes_api.rst
@@ -39,6 +39,8 @@ Attributes
    Axes.viewLim
    Axes.dataLim
    Axes.spines
+   Axes.transAxes
+   Axes.transData
 
 Plotting
 ========
diff --git a/lib/matplotlib/axes/_base.py b/lib/matplotlib/axes/_base.py
index 1a175b084316..80f1c81364a2 100644
--- a/lib/matplotlib/axes/_base.py
+++ b/lib/matplotlib/axes/_base.py
@@ -580,6 +580,18 @@ class _AxesBase(martist.Artist):
     data area boundaries.
     """
 
+    transData: mtransforms.Transform
+    """
+    The transformation from data coordinates to display coordinates.
+    See  :ref:`transforms_tutorial`.
+    """
+
+    transAxes: mtransforms.Transform
+    """
+    The transformation from axes coordinates to display coordinates.
+    See  :ref:`transforms_tutorial`.
+    """
+
     xaxis: maxis.XAxis
     """
     The `.XAxis` instance.