Item
A versatile component that you can use to display any content.
Basic Item
A simple item with title and description.
<article class="item" data-variant="outline">
<section>
<h3>Basic Item</h3>
<p>A simple item with title and description.</p>
</section>
<aside>
<button class="btn-sm-outline">Action</button>
</aside>
</article>
Usage
Use .item on a semantic element such as <article> or <a>. Use .item-group when listing multiple items.
HTML
<article class="item" data-variant="outline">
<section>
<h3>Basic Item</h3>
<p>A simple item with title and description.</p>
</section>
<aside>
<button class="btn-sm-outline">Action</button>
</aside>
</article>
HTML structure
The component has the following HTML structure:
<article class="item">or<a class="item">- The item root. Use
data-variant="outline|muted"anddata-size="sm|xs"when needed.<figure>Optional- Media: icon, avatar, or image.
<section>- Primary content. Headings and paragraphs are styled automatically.
<h2>,<h3>, or<h4>- The item title.
<p>Optional- The item description.
<aside>Optional- Actions or trailing metadata.
<header>,<footer>Optional- Full-width item regions.
<div class="item-group" role="list">Optional- Groups related items. Use
role="listitem"on child items when they are not native list items.
Examples
Variants
Default Variant
Transparent border for quiet item rows.
Outline Variant
Outlined style with a visible border.
Muted Variant
Subdued appearance for secondary content.
<div class="item-group" role="list">
<article class="item" role="listitem">
<section>
<h3>Default Variant</h3>
<p>Transparent border for quiet item rows.</p>
</section>
<aside><button class="btn-sm-outline">Open</button></aside>
</article>
<article class="item" data-variant="outline" role="listitem">
<section>
<h3>Outline Variant</h3>
<p>Outlined style with a visible border.</p>
</section>
<aside><button class="btn-sm-outline">Open</button></aside>
</article>
<article class="item" data-variant="muted" role="listitem">
<section>
<h3>Muted Variant</h3>
<p>Subdued appearance for secondary content.</p>
</section>
<aside><button class="btn-sm-outline">Open</button></aside>
</article>
</div>
Size
Default
Default item size.
Small
Small item size.
Extra Small
Extra small item size.
<div class="item-group" role="list">
<article class="item" data-variant="outline" role="listitem">
<section><h3>Default</h3><p>Default item size.</p></section>
</article>
<article class="item" data-variant="outline" data-size="sm" role="listitem">
<section><h3>Small</h3><p>Small item size.</p></section>
</article>
<article class="item" data-variant="outline" data-size="xs" role="listitem">
<section><h3>Extra Small</h3><p>Extra small item size.</p></section>
</article>
</div>
Icon
Security Alert
New login detected from an unknown device.
<article class="item" data-variant="outline">
<figure>
<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M20 13c0 5-3.5 7.5-7.66 8.95a1 1 0 0 1-.67-.01C7.5 20.5 4 18 4 13V6a1 1 0 0 1 1-1c2 0 4.5-1.2 6.24-2.72a1.17 1.17 0 0 1 1.52 0C14.51 3.81 17 5 19 5a1 1 0 0 1 1 1z" /><path d="M12 8v4" /><path d="M12 16h.01" /></svg>
</figure>
<section>
<h3>Security Alert</h3>
<p>New login detected from an unknown device.</p>
</section>
<aside><button class="btn-sm-outline">Review</button></aside>
</article>
Avatar
hunvreus
Last seen 5 months ago.
<article class="item" data-variant="outline">
<figure>
<img src="https://github.com/hunvreus.png" alt="hunvreus">
</figure>
<section>
<h3>hunvreus</h3>
<p>Last seen 5 months ago.</p>
</section>
<aside>
<button class="btn-icon-outline rounded-full"><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M5 12h14" /><path d="M12 5v14" /></svg></button>
</aside>
</article>
Image
<a href="#" class="item" data-variant="outline">
<figure>
<img src="https://avatar.vercel.sh/example_1" alt="Midnight City Lights">
</figure>
<section>
<h3>Midnight City Lights</h3>
<p>Neon Dreams</p>
</section>
<section>
<p>3:45</p>
</section>
</a>
Group

hunvreus
hunvreus@gmail.com

shadcn
shadcn@vercel.com
<div class="item-group" role="list">
<article class="item" role="listitem">
<figure><img src="https://github.com/hunvreus.png" alt="hunvreus"></figure>
<section><h3>hunvreus</h3><p>hunvreus@gmail.com</p></section>
<aside><button class="btn-icon-outline rounded-full"><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M5 12h14" /><path d="M12 5v14" /></svg></button></aside>
</article>
<hr role="separator">
<article class="item" role="listitem">
<figure><img src="https://github.com/shadcn.png" alt="shadcn"></figure>
<section><h3>shadcn</h3><p>shadcn@vercel.com</p></section>
<aside><button class="btn-icon-outline rounded-full"><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M5 12h14" /><path d="M12 5v14" /></svg></button></aside>
</article>
</div>
Header
v0-1.5-sm
ModelEveryday tasks and UI generation.
<article class="item" data-variant="outline">
<header>
<h3>v0-1.5-sm</h3>
<span class="badge-outline">Model</span>
</header>
<figure>
<img src="https://avatar.vercel.sh/v0-1.5-sm" alt="v0-1.5-sm">
</figure>
<section>
<p>Everyday tasks and UI generation.</p>
</section>
</article>
Link
<a href="#" class="item">
<section>
<h3>Visit our documentation</h3>
<p>Learn how to get started with our components.</p>
</section>
<aside><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="m9 18 6-6-6-6" /></svg></aside>
</a>
RTL
تنبيه أمني
تم اكتشاف تسجيل دخول من جهاز غير معروف.
<article class="item" data-variant="outline" dir="rtl">
<figure><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M20 13c0 5-3.5 7.5-7.66 8.95a1 1 0 0 1-.67-.01C7.5 20.5 4 18 4 13V6a1 1 0 0 1 1-1c2 0 4.5-1.2 6.24-2.72a1.17 1.17 0 0 1 1.52 0C14.51 3.81 17 5 19 5a1 1 0 0 1 1 1z" /><path d="M12 8v4" /><path d="M12 16h.01" /></svg></figure>
<section>
<h3>تنبيه أمني</h3>
<p>تم اكتشاف تسجيل دخول من جهاز غير معروف.</p>
</section>
<aside><button class="btn-sm-outline">مراجعة</button></aside>
</article>