diff --git a/ui/components/component-library/icon/README.mdx b/ui/components/component-library/icon/README.mdx
index 19596eb45..f0eae7879 100644
--- a/ui/components/component-library/icon/README.mdx
+++ b/ui/components/component-library/icon/README.mdx
@@ -27,7 +27,7 @@ Use the [IconSearch](/story/components-componentlibrary-icon--default-story) sto
```jsx
-import { Icon, ICON_NAMES } from '../../components/component-library';
+import { Icon, ICON_NAMES } from '../../component-library';
@@ -55,7 +55,7 @@ Possible sizes include:
```jsx
import { Size,TextVariant } from '../../../helpers/constants/design-system';
-import { Icon, ICON_NAMES } from '../../components/component-library';
+import { Icon, ICON_NAMES } from '../../component-library';
@@ -78,7 +78,7 @@ Use the `color` prop and the `COLORS` object from `./ui/helpers/constants/design
```jsx
import { IconColor } from '../../../helpers/constants/design-system';
-import { Icon, ICON_NAMES } from '../../components/component-library';
+import { Icon, ICON_NAMES } from '../../component-library';
@@ -87,14 +87,78 @@ import { Icon, ICON_NAMES } from '../../components/component-library';
-
+
-
+
+```
+
+### Layout & Spacing
+
+The `Icon` component accepts all [Box](/docs/components-ui-box--default-story#props) component props including `marginTop`, `marginRight`, ` marginBottom`, `marginLeft` which you can use directly to adjust the space between icons and other components like `Text`
+
+Some examples of `Icon` with `Text` using [Box](/docs/components-ui-box--default-story#props) component props
+
+
+
+```jsx
+import {
+ AlignItems,
+ DISPLAY,
+ IconColor,
+ FLEX_DIRECTION,
+ BorderColor,
+ BorderRadius,
+} from '../../../helpers/constants/design-system';
+
+import Box from '../../ui/box/box';
+
+import { ICON_NAMES, Icon, Text } from '../../component-library';
+
+
+
+
+ Always allow you to opt-out via Settings
+
+
+
+ 0x79fAaFe7B6D5DB5D8c63FE88DFF0AF1Fe53358db
+
+
+
+
+
+ Create account
+
+;
```
### Adding a new icon
diff --git a/ui/components/component-library/icon/icon.stories.js b/ui/components/component-library/icon/icon.stories.js
index 1df9197a4..031b98846 100644
--- a/ui/components/component-library/icon/icon.stories.js
+++ b/ui/components/component-library/icon/icon.stories.js
@@ -12,6 +12,7 @@ import {
BackgroundColor,
BorderColor,
Color,
+ BorderRadius,
} from '../../../helpers/constants/design-system';
import Box from '../../ui/box/box';
@@ -347,3 +348,48 @@ export const ColorStory = (args) => (
);
ColorStory.storyName = 'Color';
+
+export const LayoutAndSpacing = () => (
+
+
+
+ Always allow you to opt-out via Settings
+
+
+
+ 0x79fAaFe7B6D5DB5D8c63FE88DFF0AF1Fe53358db
+
+
+
+
+
+ Create account
+
+
+);