diff --git a/packages/ui/components/list/list.stories.mdx b/packages/ui/components/list/list.stories.mdx
index 805d7d95c2..a5cef93c14 100644
--- a/packages/ui/components/list/list.stories.mdx
+++ b/packages/ui/components/list/list.stories.mdx
@@ -10,20 +10,88 @@ import {
VariantRow,
} from "@calcom/storybook/components";
-import { List, ListItem } from "./List";
+import { List, ListItem, ListItemTitle, ListItemText } from "./List";
+
+export const listItems = [
+ { title: "Title 1", description: "Description 1" },
+ { title: "Title 2", description: "Description 2" },
+ { title: "Title 3", description: "Description 3" },
+];
-
+
## Definition
-Sums it up nicely.
+The List component is used to render an unordered list with default styling
+
+## Structure
+
+List takes an array of objects to display a list in the UI
+### List
+
+
+### ListItem
+
+
+
+
+
+ {listItems.map((item) => (
+
+ {item.title}
+ {item.description}
+
+ ))}
+
+
+
+
+ {listItems.map((item) => (
+
+ {item.title}
+ {item.description}
+
+ ))}
+
+
+
+
+ {listItems.map((item) => (
+
+ {item.title}
+ {item.description}
+
+ ))}
+
+
+
+
+