diff --git a/apps/design-system/content/docs/fragments/multi-select.mdx b/apps/design-system/content/docs/fragments/multi-select.mdx
index 73e09df3899..e20164f4593 100644
--- a/apps/design-system/content/docs/fragments/multi-select.mdx
+++ b/apps/design-system/content/docs/fragments/multi-select.mdx
@@ -60,16 +60,16 @@ creatable: `boolean`
-### Badge Limit
+### Badge limit
badgeLimit: `number` | `"wrap"`.
`badgeLimit` prop on the `MultiSelectorTrigger` component can be used to limit the number of badges displayed.
-### Badge Limit="wrap"
+### Wrapped badge limit
-`badgeLimit` prop can also be "wrap" to wrap the badges to the next line.
+Combine `badgeLimit` with `wrapBadges` to limit the number of badges and allow them to wrap onto additional lines. Use `badgeLimit="wrap"` to show and wrap every selected badge.
diff --git a/apps/design-system/registry/default/example/multi-select-badge-limit-wrap.tsx b/apps/design-system/registry/default/example/multi-select-badge-limit-wrap.tsx
index 7b1b8b283ad..fae3733b2ec 100644
--- a/apps/design-system/registry/default/example/multi-select-badge-limit-wrap.tsx
+++ b/apps/design-system/registry/default/example/multi-select-badge-limit-wrap.tsx
@@ -1,4 +1,6 @@
+import { Minus, Plus } from 'lucide-react'
import { useState } from 'react'
+import { Button } from 'ui'
import {
MultiSelector,
MultiSelectorContent,
@@ -15,30 +17,42 @@ export default function MultiSelectDemo() {
'Date',
'Elderberrie',
])
+ const [limit, setLimit] = useState(3)
return (
-
-
-
-
- Apple
- Banana
- Cherry
- Date
- Elderberrie
- Fig
- Grape
- Kiwi
- Mango
- Strawberry
-
-
-
+