diff --git a/core/src/main/resources/lib/layout/dropdowns/custom.jelly b/core/src/main/resources/lib/layout/dropdowns/custom.jelly
index bf58f228f5..13b1a54c55 100644
--- a/core/src/main/resources/lib/layout/dropdowns/custom.jelly
+++ b/core/src/main/resources/lib/layout/dropdowns/custom.jelly
@@ -23,9 +23,9 @@ THE SOFTWARE.
 -->
 
 <?jelly escape-by-default='true'?>
-<j:jelly xmlns:j="jelly:core" xmlns:st="jelly:stapler" xmlns:l="/lib/layout" xmlns:d="jelly:define">
+<j:jelly xmlns:j="jelly:core" xmlns:st="jelly:stapler" xmlns:d="jelly:define">
     <st:documentation>
-
+        Allows for custom components inside of dropdowns
     </st:documentation>
 
     <template data-dropdown-type="CUSTOM">
diff --git a/core/src/main/resources/lib/layout/dropdowns/item.jelly b/core/src/main/resources/lib/layout/dropdowns/item.jelly
index 21b41cb133..bce5206f41 100644
--- a/core/src/main/resources/lib/layout/dropdowns/item.jelly
+++ b/core/src/main/resources/lib/layout/dropdowns/item.jelly
@@ -26,13 +26,16 @@ THE SOFTWARE.
 <j:jelly xmlns:j="jelly:core" xmlns:st="jelly:stapler" xmlns:l="/lib/layout">
     <st:documentation>
         <st:attribute name="icon">
-            Optional icon to be used for the button, defaults to three dots
+            Icon to be used for the menu item
         </st:attribute>
         <st:attribute name="text">
-            Optional text to be displayed on the button
+            Text to be displayed on the menu item
         </st:attribute>
         <st:attribute name="id">
-            Optional ID for the button
+            Optional ID for the menu item
+        </st:attribute>
+        <st:attribute name="href">
+            Optional HREF for the menu item
         </st:attribute>
     </st:documentation>
 
@@ -42,8 +45,8 @@ THE SOFTWARE.
 
     <template data-dropdown-type="ITEM"
               data-dropdown-id="${attrs.id}"
+              data-dropdown-icon="${icon}"
               data-dropdown-text="${attrs.text}"
               data-dropdown-href="${attrs.href}"
-              data-dropdown-icon="${icon}"
     />
 </j:jelly>
diff --git a/core/src/main/resources/lib/layout/dropdowns/separator.jelly b/core/src/main/resources/lib/layout/dropdowns/separator.jelly
index 9437997653..8b94084933 100644
--- a/core/src/main/resources/lib/layout/dropdowns/separator.jelly
+++ b/core/src/main/resources/lib/layout/dropdowns/separator.jelly
@@ -24,9 +24,5 @@ THE SOFTWARE.
 
 <?jelly escape-by-default='true'?>
 <j:jelly xmlns:j="jelly:core" xmlns:st="jelly:stapler">
-    <st:documentation>
-
-    </st:documentation>
-
     <template data-dropdown-type="SEPARATOR" />
 </j:jelly>
diff --git a/core/src/main/resources/lib/layout/dropdowns/submenu.jelly b/core/src/main/resources/lib/layout/dropdowns/submenu.jelly
index 4a1d9d9a1b..60acc5a07e 100644
--- a/core/src/main/resources/lib/layout/dropdowns/submenu.jelly
+++ b/core/src/main/resources/lib/layout/dropdowns/submenu.jelly
@@ -26,11 +26,13 @@ THE SOFTWARE.
 <j:jelly xmlns:j="jelly:core" xmlns:st="jelly:stapler" xmlns:d="jelly:define" xmlns:l="/lib/layout">
     <st:documentation>
         <st:attribute name="icon">
-            Optional icon to be used for the button, defaults to three dots
+            Icon to be used for the menu item
         </st:attribute>
         <st:attribute name="text">
-            Optional text to be displayed on the button
+            Text to be displayed on the menu item
         </st:attribute>
+
+        Displays the contents as a submenu to a menu item
     </st:documentation>
 
     <j:set var="icon">