diff --git a/docs/src/changelog/v0.29.md b/docs/src/changelog/v0.29.md
index 4e4e6036c9..70fc88c3ec 100644
--- a/docs/src/changelog/v0.29.md
+++ b/docs/src/changelog/v0.29.md
@@ -7,3 +7,16 @@
 Support for colored completion.
 
 ![](./v0.29/xonsh.png)
+
+## Macro (BREAKING CHANGE)
+
+`$_` prefix is now deprecated and needs to be replaced with `$carapace.`
+
+```
+$_color.HexColors
+$carapace.color.HexColors
+```
+
+```sh
+carapace _carapace macro color.HexColors ""
+```