diff --git a/packages/react/src/components/Button/Button.mdx b/packages/react/src/components/Button/Button.mdx
index c9b599fc6f50..f8f0e668b247 100644
--- a/packages/react/src/components/Button/Button.mdx
+++ b/packages/react/src/components/Button/Button.mdx
@@ -2,6 +2,7 @@ import { Story, Props, Source, Preview } from '@storybook/addon-docs/blocks';
import { withKnobs, boolean, select, text } from '@storybook/addon-knobs';
import * as stories from './Button-story.js';
import Button from '../Button';
+import ButtonSet from '../ButtonSet';
import { Add16, Delete16 } from '@carbon/icons-react';
# Button
@@ -45,6 +46,19 @@ buttons.
+## Set of Buttons
+
+You can wrap two `Button` elements in a `ButtonSet` when an action required by
+the user has more than one option. Always use a negative action button
+(secondary) paired with a positive action button (primary) in that order.
+Negative action buttons will be on the left. Positive action buttons should be
+on the right. When these two types buttons are paired in the correct order, they
+will automatically space themselves apart.
+
+
+
+
+
## Skeleton state
You can use the `ButtonSkeleton` component to render a skeleton variant of a
@@ -261,6 +275,23 @@ a position and will render the tooltip accordingly. Accepted options are `top`,
```
+### ButtonSet `stacked`
+
+By passing in `stacked` to the `ButtonSet` component, you can arrange your two
+`Button` elements vertically
+
+
+
+
+
+
+```jsx
+
+
+
+
+```
+
## References
- [MDN: ARIA button role](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Roles/button_role)