Item Card Group
A layout component for grouping item cards in list or grid arrangements with section headers and dividers.
Usage
Anatomy
Import the ItemCardGroup component and access all parts using dot notation.
import {ItemCardGroup} from "@heroui-pro/react";
<ItemCardGroup>
<ItemCardGroup.Header>
<ItemCardGroup.Title />
<ItemCardGroup.Description />
</ItemCardGroup.Header>
</ItemCardGroup>Grid
Grid Three Columns
Linked Accounts
List
Multiple Sections
Notification Preferences
Permission Levels
Pressable
Variants
Wallet List
With Header
CSS Classes
Base & Variant Classes
.item-card-group- Base group container with rounded corners.item-card-group--default- Default variant with surface background and shadow.item-card-group--secondary- Secondary variant with surface-secondary background.item-card-group--tertiary- Tertiary variant with surface-tertiary background.item-card-group--outline- Outline variant with border and transparent background.item-card-group--transparent- Transparent variant with no background, shadow, or rounded corners
Layout Classes
.item-card-group--list- Vertical stack layout with auto-dividers between cards.item-card-group--grid- Multi-column grid layout with spaced cards (column count via--item-card-group-columns)
Element Classes
.item-card-group__header- Optional section heading area.item-card-group__title- Section heading text.item-card-group__description- Section subtext
CSS Variables
--item-card-group-columns- Number of grid columns (default:2, set via thecolumnsprop)
API Reference
ItemCardGroup
The root component. Groups item cards with shared styling.
| Prop | Type | Default | Description |
|---|---|---|---|
layout | 'list' | 'grid' | 'list' | Layout mode |
variant | 'default' | 'secondary' | 'tertiary' | 'outline' | 'transparent' | 'default' | Visual style variant |
columns | 2 | 3 | 2 | Number of grid columns when layout is "grid" |
children | ReactNode | - | Item cards, separators, and headers |
Also supports all native div HTML attributes.
ItemCardGroup.Header
Optional section heading area.
| Prop | Type | Default | Description |
|---|---|---|---|
children | ReactNode | - | Title and description elements |
Also supports all native div HTML attributes.
ItemCardGroup.Title
Section heading rendered as an h3.
| Prop | Type | Default | Description |
|---|---|---|---|
children | ReactNode | - | Title text |
Also supports all native h3 HTML attributes.
ItemCardGroup.Description
Section subtext rendered as a p.
| Prop | Type | Default | Description |
|---|---|---|---|
children | ReactNode | - | Description text |
Also supports all native p HTML attributes.