diff --git a/CONSTRUCT.md b/CONSTRUCT.md
index f8ac744d5..5461004ea 100644
--- a/CONSTRUCT.md
+++ b/CONSTRUCT.md
@@ -133,6 +133,9 @@ be created.
 
 If all environments (`extra_envs` included) set `menu_packages` to an empty list,
 no UI options about shortcuts will be offered to the user.
+     
+Note: This option is not fully implemented when `micromamba` is used as 
+the `--conda-exe` binary. The only accepted value is an empty list (`[]`).
 
 ### `ignore_duplicate_files`
 
diff --git a/constructor/construct.py b/constructor/construct.py
index a853e1d0e..c7cf7fc72 100644
--- a/constructor/construct.py
+++ b/constructor/construct.py
@@ -90,6 +90,9 @@
 
 If all environments (`extra_envs` included) set `menu_packages` to an empty list,
 no UI options about shortcuts will be offered to the user.
+     
+Note: This option is not fully implemented when `micromamba` is used as 
+the `--conda-exe` binary. The only accepted value is an empty list (`[]`).
 '''),
 
     ('ignore_duplicate_files',  False, bool, '''
diff --git a/docs/source/construct-yaml.md b/docs/source/construct-yaml.md
index f8ac744d5..5461004ea 100644
--- a/docs/source/construct-yaml.md
+++ b/docs/source/construct-yaml.md
@@ -133,6 +133,9 @@ be created.
 
 If all environments (`extra_envs` included) set `menu_packages` to an empty list,
 no UI options about shortcuts will be offered to the user.
+     
+Note: This option is not fully implemented when `micromamba` is used as 
+the `--conda-exe` binary. The only accepted value is an empty list (`[]`).
 
 ### `ignore_duplicate_files`
 
diff --git a/docs/source/howto.md b/docs/source/howto.md
index 95fac9315..e900003ee 100644
--- a/docs/source/howto.md
+++ b/docs/source/howto.md
@@ -60,6 +60,11 @@ under `$PREFIX/Menu`, `conda` will process it to create the specified menu items
 This happens by default for _all packages_. If you only want this to happen for certain packages,
 use the [`menu_packages`](construct-yaml.md#menu_packages) key.
 
+Starting with `conda` 23.11, `menuinst 2.x` is supported, which means you can create shortcuts in all platforms (Linux, macOS and Windows). 
+The JSON document format is slightly different, so make sure to check the [menuinst documentation](https://conda.github.io/menuinst/). 
+Your installer will need to be created with `conda-standalone 23.11` or above.
+`micromamba` does not currently support `menuinst 2.x` style shortcuts (only `1.x` on Windows).
+
 To learn more about `menuinst`, visit [`conda/menuinst`](https://github.com/conda/menuinst).
 
 ## Find out the used constructor version