diff --git a/packages/components/src/icon/stories/index.story.tsx b/packages/components/src/icon/stories/index.story.tsx
index 7d61be8df7f3ce..d1eabf2e98b771 100644
--- a/packages/components/src/icon/stories/index.story.tsx
+++ b/packages/components/src/icon/stories/index.story.tsx
@@ -47,26 +47,68 @@ FillColor.args = {
...Default.args,
};
+/**
+ * When `icon` is a function, it will be passed the `size` prop and any other additional props.
+ */
export const WithAFunction = Template.bind( {} );
WithAFunction.args = {
...Default.args,
- icon: () => (
-
+ icon: ( { size }: { size?: number } ) => (
+
),
};
+WithAFunction.parameters = {
+ docs: {
+ source: {
+ code: `
+ (
+
+ ) }
+/>
+ `,
+ },
+ },
+};
-const MyIconComponent = () => (
-