---
title: "Card List Module for Sanity + Next.js"
description: "A card grid or carousel for features, services, or use cases. Each card supports an image or icon, rich text, Custom HTML, and its own call-to-actions."
---

# Card list module

Display cards in a responsive grid or carousel. Each card can have an image or icon, rich text, Custom HTML, and its own call-to-actions.

[View source on GitHub](https://github.com/nuotsu/sanitypress/tree/main/src/modules/card-list) (schema + React component)

## Module fields

| Field | Type | Description |
| --- | --- | --- |
| `eyebrow` | string | Small label shown above the intro. |
| `intro` | Portable Text | Heading and copy, centered above the cards. |
| `cards` | array of `card` | The cards to display. See card fields below. |
| `ctas` | array of `cta` | Call-to-actions, centered below the cards. |
| `layout` | `grid` \| `carousel` | Defaults to `grid`. `carousel` scrolls horizontally with scroll buttons and markers. |
| `columns` | number | Fixed column count on desktop. When empty, columns auto-fit at roughly 256px each. Hidden when `layout` is `carousel`. |
| `attributes` | `module-attributes` | Shared by every module: `uid` (HTML id for deep links), `hidden`, and `scopedCss`. |

## Card fields

| Field | Type | Description |
| --- | --- | --- |
| `image` | image | Full-width image at the top of the card. Supports hotspot cropping. |
| `icon` | image | Small icon (48px tall) at the top of the card. Supports hotspot cropping. |
| `eyebrow` | string | Small label shown above the card content. |
| `content` | Portable Text | Card body. Supports rich text, inline images with alt text, and Custom HTML blocks. |
| `ctas` | array of `cta` | Call-to-actions at the bottom of the card. |

## Demo: Default grid

Cards auto-fit to the available width. Each card uses a different CTA theme.

### Card 1

Lorem ipsum dolor sit amet.

[Action](#)

### Card 2

Lorem ipsum dolor sit amet.

[Action outline](#)

### Card 3

Lorem ipsum dolor sit amet.

[Ghost](#)

## Demo: Custom HTML

Every visual below is a Custom HTML block placed in a card's content field: plain HTML and CSS, no images or JavaScript.

#### Generate them with AI

Ask your AI agent for a looping 4:3 HTML + CSS mockup, then paste the markup and styles into a Custom HTML block at the top of the card.

#### Theme-aware by default

Colors come from currentColor and var(--color-primary) via color-mix(), so each mockup follows your site's theme without edits.

#### Responsive, accessible motion

Container query units keep the 4:3 layout crisp at any card width, CSS @keyframes loop every 9 seconds, and prefers-reduced-motion freezes them on a key frame.

## Demo: Bento grid

Set `columns` to 4, then use the module's Scoped CSS to make individual cards span multiple rows or columns.

![](https://cdn.sanity.io/images/cyu7k2r0/production/6fd68531ff868075a33402a7c5cfc3cb99e51976-992x1200.jpg)

#### Feature 1

`grid-row: span 2;`

![](https://cdn.sanity.io/images/cyu7k2r0/production/7859825fe720fa88e131255530ba25bcf6a99278-1179x985.jpg)

#### Feature 2

#### Feature 3

`grid-column: span 2;`

#### Feature 4

`grid-column: span 2;`

![](https://cdn.sanity.io/images/cyu7k2r0/production/d985cde20b0601f7e4f5edf8597bdc5c1e9e02a2-1200x992.png)

#### Feature 5

Frequently Asked Questions

## Card list module FAQ

### When should I use the Card list module?

Use it for any set of parallel items: features, services, use cases, pricing tiers, or links to other pages. Each card can carry an image or icon, rich text, Custom HTML, and its own call-to-actions.

### How do I add the Card list module to a page?

In Sanity Studio, open the page, click Add item in its Modules field, and pick Card list. Fill in the fields, check it in the live Presentation preview, and publish. Modules can be reordered by dragging, and the same module can be used on any page as many times as you need.

### How do I customize the Card list module?

Switch layout between grid and carousel, set a fixed column count (or leave it empty to auto-fit cards at roughly 256px), and give each card an image, a 48px icon, an eyebrow, rich text content, and CTAs.

Every module also has a Scoped CSS field (plus a uid for deep links and a hidden toggle), so you can restyle one instance without touching the rest of the site. For bigger changes, edit the module's React component and schema in src/modules/card-list in the repo.

Previous module

![Callout module](https://cdn.sanity.io/images/cyu7k2r0/production/0c7dfd30dc428eb4dd22ab1c08eb19b954a99ecf-2560x468.png)

[Callout module](/modules/callout)

Next module

![Hero (cover) module](https://cdn.sanity.io/images/cyu7k2r0/production/f6135b63c7667275a7c06625af54290acce25c30-2122x1209.png)

[Hero (cover) module](/modules/hero-cover)
