List Group

Styled lists with items, badges, icons, active states, and actions.

Default

<div class="sui-list-group">
  <a href="#" class="sui-list-group-item">Dashboard</a>
  <a href="#" class="sui-list-group-item">Analytics</a>
  <a href="#" class="sui-list-group-item">Settings</a>
  <a href="#" class="sui-list-group-item">Help Center</a>
</div>

With Badges

<div class="sui-list-group sui-list-group-raised">
  <a href="#" class="sui-list-group-item">
    <div class="sui-list-group-content">Inbox</div>
    <span class="sui-list-group-action"><span class="sui-badge sui-badge-primary sui-badge-pill">12</span></span>
  </a>
  <a href="#" class="sui-list-group-item">
    <div class="sui-list-group-content">Drafts</div>
    <span class="sui-list-group-action"><span class="sui-badge sui-badge-pill">3</span></span>
  </a>
  <a href="#" class="sui-list-group-item">
    <div class="sui-list-group-content">Sent</div>
  </a>
  <a href="#" class="sui-list-group-item">
    <div class="sui-list-group-content">Spam</div>
    <span class="sui-list-group-action"><span class="sui-badge sui-badge-danger sui-badge-pill">7</span></span>
  </a>
</div>

With Descriptions

<div class="sui-list-group sui-list-group-raised">
  <a href="#" class="sui-list-group-item">
    <div class="sui-avatar sui-avatar-sm" style="background:var(--sui-primary);color:#fff;font-weight:600;flex-shrink:0;">SK</div>
    <div class="sui-list-group-content">
      <div class="sui-list-group-title">Sarah Kim</div>
      <div class="sui-list-group-desc">Hey, are we still on for the meeting?</div>
    </div>
    <span class="sui-list-group-action" style="font-size:11px;color:var(--sui-text-muted);">2m ago</span>
  </a>
  <a href="#" class="sui-list-group-item">
    <div class="sui-avatar sui-avatar-sm" style="background:var(--sui-success);color:#fff;font-weight:600;flex-shrink:0;">MR</div>
    <div class="sui-list-group-content">
      <div class="sui-list-group-title">Mike Ross</div>
      <div class="sui-list-group-desc">The new designs look great!</div>
    </div>
    <span class="sui-list-group-action" style="font-size:11px;color:var(--sui-text-muted);">1h ago</span>
  </a>
  <a href="#" class="sui-list-group-item">
    <div class="sui-avatar sui-avatar-sm" style="background:var(--sui-warning);color:#fff;font-weight:600;flex-shrink:0;">AL</div>
    <div class="sui-list-group-content">
      <div class="sui-list-group-title">Anna Lee</div>
      <div class="sui-list-group-desc">Can you review the PR when you get a chance?</div>
    </div>
    <span class="sui-list-group-action" style="font-size:11px;color:var(--sui-text-muted);">3h ago</span>
  </a>
</div>

With Icons

<div class="sui-list-group sui-list-group-raised">
  <a href="#" class="sui-list-group-item active">
    <svg class="sui-list-group-icon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M3 9l9-7 9 7v11a2 2 0 01-2 2H5a2 2 0 01-2-2z"/><polyline points="9 22 9 12 15 12 15 22"/></svg>
    <div class="sui-list-group-content">Home</div>
  </a>
  <a href="#" class="sui-list-group-item">
    <svg class="sui-list-group-icon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M22 19a2 2 0 01-2 2H4a2 2 0 01-2-2V5a2 2 0 012-2h5l2 3h9a2 2 0 012 2z"/></svg>
    <div class="sui-list-group-content">Projects</div>
  </a>
  <a href="#" class="sui-list-group-item">
    <svg class="sui-list-group-icon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><rect x="3" y="4" width="18" height="18" rx="2"/><line x1="16" y1="2" x2="16" y2="6"/><line x1="8" y1="2" x2="8" y2="6"/><line x1="3" y1="10" x2="21" y2="10"/></svg>
    <div class="sui-list-group-content">Calendar</div>
  </a>
  <a href="#" class="sui-list-group-item">
    <svg class="sui-list-group-icon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><circle cx="12" cy="12" r="3"/><path d="M12 1v4M12 19v4M4.22 4.22l2.83 2.83M16.95 16.95l2.83 2.83M1 12h4M19 12h4M4.22 19.78l2.83-2.83M16.95 7.05l2.83-2.83"/></svg>
    <div class="sui-list-group-content">Settings</div>
  </a>
</div>

Active & Disabled

<div class="sui-list-group sui-list-group-raised">
  <a href="#" class="sui-list-group-item active">Dashboard</a>
  <a href="#" class="sui-list-group-item">Analytics</a>
  <a href="#" class="sui-list-group-item disabled">Billing (coming soon)</a>
  <a href="#" class="sui-list-group-item">Settings</a>
</div>

With Submenus

Wrap a <button> item in a sui-dropdown sui-dropend for a flyout submenu; on phones it opens below.

<div class="sui-list-group sui-list-group-raised">
  <div class="sui-dropdown sui-dropend">
    <button type="button" class="sui-list-group-item sui-dropdown-toggle sui-dropdown-no-arrow" data-sui-dropdown aria-haspopup="true" aria-expanded="false">
      <span class="sui-list-group-content">General</span>
      <span class="sui-list-group-action" style="color:var(--sui-text-muted);">&#9654;</span>
    </button>
    <div class="sui-dropdown-menu" role="menu">
      <a class="sui-dropdown-item" role="menuitem" href="#">Language</a>
      <a class="sui-dropdown-item" role="menuitem" href="#">Timezone</a>
      <a class="sui-dropdown-item" role="menuitem" href="#">Theme</a>
    </div>
  </div>
  <a href="#" class="sui-list-group-item">
    <div class="sui-list-group-content">Notifications</div>
    <span class="sui-list-group-action"><span class="sui-badge sui-badge-danger sui-badge-pill">3</span></span>
  </a>
  <div class="sui-dropdown sui-dropend">
    <button type="button" class="sui-list-group-item sui-dropdown-toggle sui-dropdown-no-arrow" data-sui-dropdown aria-haspopup="true" aria-expanded="false">
      <span class="sui-list-group-content">Privacy</span>
      <span class="sui-list-group-action" style="color:var(--sui-text-muted);">&#9654;</span>
    </button>
    <div class="sui-dropdown-menu" role="menu">
      <a class="sui-dropdown-item" role="menuitem" href="#">Password</a>
      <a class="sui-dropdown-item" role="menuitem" href="#">Two-Factor Auth</a>
      <a class="sui-dropdown-item" role="menuitem" href="#">Sessions</a>
    </div>
  </div>
  <a href="#" class="sui-list-group-item" style="color:var(--sui-danger-text);">
    <div class="sui-list-group-content">Delete Account</div>
  </a>
</div>

Raised

<div class="sui-list-group sui-list-group-raised">
  <a href="#" class="sui-list-group-item">Overview</a>
  <a href="#" class="sui-list-group-item">Reports</a>
  <a href="#" class="sui-list-group-item">Exports</a>
</div>

Bordered

<div class="sui-list-group sui-list-group-bordered">
  <a href="#" class="sui-list-group-item">Profile</a>
  <a href="#" class="sui-list-group-item">Security</a>
  <a href="#" class="sui-list-group-item">Integrations</a>
</div>

Inset

<div class="sui-list-group sui-list-group-inset">
  <a href="#" class="sui-list-group-item">Account</a>
  <a href="#" class="sui-list-group-item">Appearance</a>
  <a href="#" class="sui-list-group-item">Language</a>
</div>

Flush

<div class="sui-card">
  <div class="sui-card-header">Recent Files</div>
  <div class="sui-list-group sui-list-group-flush">
    <a href="#" class="sui-list-group-item">Q3-report.pdf</a>
    <a href="#" class="sui-list-group-item">roadmap.xlsx</a>
    <a href="#" class="sui-list-group-item">brand-assets.zip</a>
  </div>
</div>

Delete this item?

This action cannot be undone. This will permanently delete the item and remove all associated data.