diff --git a/packages/clay-drop-down/docs/drop-down.mdx b/packages/clay-drop-down/docs/drop-down.mdx
index 60e4d2bb86..d0c2938f59 100644
--- a/packages/clay-drop-down/docs/drop-down.mdx
+++ b/packages/clay-drop-down/docs/drop-down.mdx
@@ -24,7 +24,9 @@ import {
- [Value](#value)
- [Without Trigger](#without-trigger)
- [Variants](#variants)
+ - [Icon](#icon)
- [With Items](#with-items)
+ - [Customizable Trigger Icon](#customizable-trigger-icon)
- [Cascading Menu](#cascading-menu)
- [Drilldown](#drilldown)
- [Caveats](#caveats)
@@ -249,12 +251,22 @@ const Menu = ({children, hasLeftSymbols, hasRightSymbols}) => {
Clay provides other ways to use the Clay component, which we call high-level components, which are designed to do a specific high-level behavior different from compositing that allow different possibilities, are less flexible.
+### Icon
+
+By default, a caret icon (▼) is displayed alongside the button text to indicate the dropdown functionality. This visually indicates a dropdown menu and improve user understanding.
+
+The caret icon can be removed by passing `null` to the `triggerIcon` prop.
+
### With Items
Allows you to create a simple DropDown, through its API you are able to create a Menu with groups of checkboxes and radios, links, buttons, search, caption, etc.
+#### Customizable Trigger Icon
+
+When using `DropDownWithItems`, you can customize the icon on the dropdown button via the `triggerIcon` prop.
+
#### Cascading Menu
`DropDownWithItems` allows the possibility to create a contextual menu, the nature of the API allows the creation of more cascade menus but the **Lexicon specification recommends using only one level** and using `DropDownWithDrilldown` component.
diff --git a/packages/clay-management-toolbar/docs/index.js b/packages/clay-management-toolbar/docs/index.js
index d3dd31dad5..562dd90148 100644
--- a/packages/clay-management-toolbar/docs/index.js
+++ b/packages/clay-management-toolbar/docs/index.js
@@ -221,12 +221,6 @@ const ManagementToolbarCode = `const Component = () => {
{'Filter and Order'}
-
-
{
}
+ triggerIcon="caret-bottom"
/>
@@ -332,6 +327,7 @@ const ManagementToolbarCode = `const Component = () => {
/>
}
+ triggerIcon="caret-double-l"
/>
diff --git a/packages/clay-management-toolbar/stories/ManagementToolbar.stories.tsx b/packages/clay-management-toolbar/stories/ManagementToolbar.stories.tsx
index ee2249319b..de340ca762 100644
--- a/packages/clay-management-toolbar/stories/ManagementToolbar.stories.tsx
+++ b/packages/clay-management-toolbar/stories/ManagementToolbar.stories.tsx
@@ -73,17 +73,13 @@ export const Default = () => {
Filter and Order
-
-
}
+ triggerIcon="caret-bottom"
/>
@@ -168,6 +164,7 @@ export const Default = () => {
/>
}
+ triggerIcon="caret-double-l"
/>