diff --git a/doc/tags/macro.rst b/doc/tags/macro.rst
index 691a3c5aa..5d04f85cc 100644
--- a/doc/tags/macro.rst
+++ b/doc/tags/macro.rst
@@ -130,6 +130,9 @@ macros are available in all blocks and other macros defined in the current
 template, but they are not available in included templates or child templates;
 you need to explicitly re-import macros in each template.
 
+Imported macros are not available in the body of the ``embed`` tag. you need
+to explicitly re-import macros inside the tag.
+
 When calling ``import`` or ``from`` from a ``block`` tag, the imported macros
 are only defined in the current block and they override macros defined at the
 template level with the same names.