---
title: "Team / Person List Module for Sanity"
description: "Showcase your team, speakers, or advisors from reusable person documents, with photos, bios, and optional schema.org Person markup."
---

# Person list module

A grid of people, each with a photo, name, title, and bio, pulled from reusable person documents.

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

## Module fields

| Field | Type | Description |
| --- | --- | --- |
| `intro` | Portable Text | Heading and copy above the grid. |
| `people` | array of `person` references | Reusable person documents. See person fields below. |
| `columns` | number | Fixed column count on desktop. When empty, columns auto-fit at roughly 256px each. |
| `attributes` | `module-attributes` | Shared by every module: `uid` (HTML id for deep links), `hidden`, and `scopedCss`. |

## Person fields

| Field | Type | Description |
| --- | --- | --- |
| `name` | string | Full name. |
| `title` | string | Job title or role. |
| `content` | Portable Text | Short bio. |
| `image` | image | Photo, cropped square. |
| `enableSchema` | boolean | Outputs Person schema.org JSON-LD. Defaults to `false`. |

## Demo: Auto-fit grid

Four people in the default grid, since `columns` is empty.

### Mitchell Christ

Creator of SanityPress

[2026 Sanity Pioneer](/blog/sanitypress-earns-a-sanity-pioneer-spot)

![Mitchell Christ](https://cdn.sanity.io/images/cyu7k2r0/production/5d7307ff34caee9cc20fda9accac7c231c84f8da-1106x1106.png)

### Shohei Ohtani

MLB Player

![Shohei Ohtani](https://cdn.sanity.io/images/cyu7k2r0/production/287d6200007f63d4a8d81634600043c5306fd4eb-1023x1537.png)

### Max Verstappen

F1 Driver

![Max Verstappen](https://cdn.sanity.io/images/cyu7k2r0/production/dbcfa3c9e5388044e5addf30843c6a9d6feef0a3-1254x1254.png)

### Dwight Schrute

Assistant to the Regional Manager

![Dwight Schrute](https://cdn.sanity.io/images/cyu7k2r0/production/c1e6b55864c0836ea0598e5ecf8eb529741056fa-1254x1254.png)

Frequently Asked Questions

## Person list module FAQ

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

Use it for team pages, speaker lineups, advisors, or authors. People are reusable person documents, so a bio updated once is updated everywhere it appears.

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

In Sanity Studio, open the page, click Add item in its Modules field, and pick Person 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 Person list module?

Add person references with a name, title, short bio, and square photo, and set a fixed column count or let the grid auto-fit. Turn on enableSchema on a person to output Person schema.org JSON-LD, which helps search engines and AI assistants connect the person to your site.

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/person-list in the repo.

Previous module

![Logo list module](https://cdn.sanity.io/images/cyu7k2r0/production/1d682f8809ef7ee91d65db9d13379c515d7a103b-2560x416.png)

[Logo list module](/modules/logo-list)

Next module

![Prose module](https://cdn.sanity.io/images/cyu7k2r0/production/6017e56a767b7235da278ec20d5ebc7ea837a521-2546x1558.png)

[Prose module](/modules/prose)
