diff --git a/doc/source/user_guide/timeseries.rst b/doc/source/user_guide/timeseries.rst
index b31249e1cf7c1a..eaecc0f590e063 100644
--- a/doc/source/user_guide/timeseries.rst
+++ b/doc/source/user_guide/timeseries.rst
@@ -1317,9 +1317,9 @@ frequencies. We will refer to these aliases as *period aliases*.
     "B", "business day frequency"
     "D", "calendar day frequency"
     "W", "weekly frequency"
-    "M", "monthly frequency"
-    "Q", "quarterly frequency"
-    "Y", "yearly frequency"
+    "ME", "monthly frequency"
+    "QE", "quarterly frequency"
+    "YE", "yearly frequency"
     "h", "hourly frequency"
     "min", "minutely frequency"
     "s", "secondly frequency"
@@ -1332,6 +1332,8 @@ frequencies. We will refer to these aliases as *period aliases*.
    Aliases ``H``, ``T``, ``S``, ``L``, ``U``, and ``N`` are deprecated in favour of the aliases
    ``h``, ``min``, ``s``, ``ms``, ``us``, and ``ns``.
 
+   Aliases ``Y``, ``M``, and ``Q`` are deprecated in favour of the aliases ``YE``, ``ME``, ``QE``.
+
 
 Combining aliases
 ~~~~~~~~~~~~~~~~~