---
title: "Repeatable group"
description: "This article explains what the repeatable group is and how to configure it."
meta_title: "Repeatable group"
category: "fields"
audience: developers
lastUpdated: "2026-04-23T01:17:46.000Z"
---
A repeatable group is used to create a repeatable collection of fields. It can be used to create an image gallery, a list of products, a navigation list, and more.
Repeatable groups can be displayed using a loop.
**Next.js example:**
```tsx
{slice.primary.my_repeatable_group.map((item) => (
- {item.feature}
))}
```
**Nuxt example:**
```vue-html
```
**SvelteKit example:**
```svelte
{#each slice.primary.my_repeatable_group as item}
- {item.feature}
{/each}
```
> A repeatable group cannot contain another repeatable group.
# Add a repeatable group to a content model
Repeatable groups are added using the [Type Builder](https://prismic.io/docs/type-builder.md), a tool for building by hand, or the [Prismic CLI](https://prismic.io/docs/cli.md), a tool for AI agents.
* **Type Builder:**
> **Important**
>
> Type Builder is rolling out to new users. If you do not have access, use **Slice Machine**.
1. **Watch for changes**
In your local website project, start the Prismic CLI's `sync` command. The CLI will watch for changes in the Type Builder and pull them into your project.
```sh
npx prismic sync --watch
```
> **Tip**: You can pull Type Builder changes at any time using `npx prismic
> sync`.
2. **Add a repeatable group**
In the Type Builder, navigate to the slice, page type, or custom type you want to modify. Add a **repeatable group** and provide the following:
* **Label**: The label shown to content writers in the [Page Builder](https://prismic.io/docs/guides/page-builder.md). Use an easily understandable name.
* **API ID**: The property name in the Content API. Use a short, snake-cased name.
3. **Add fields**
For each field needed in the repeatable group, click the **Add a field** button and select a field. All field types are supported.
4. **(Optional) Make the repeatable group non-repeatable**
A repeatable group can be configured as non-repeatable, visually grouping fields in the Page Builder while preventing content writers from repeating them.
Open the repeatable group settings and uncheck the **Repeatable** setting.
You can now close the Prismic CLI `sync` command or add your next field.
* **Prismic CLI:**
> Your AI agent can perform these steps for you. See [Prismic with AI](https://prismic.io/docs/ai.md) for details.
1. **Add a repeatable group**
Use the `prismic field add group` command to add a repeatable group to a slice.
```sh
npx prismic field add group features --to-slice MySlice
```
Use `--to-type` to add the field to a page type or custom type instead.
```sh
npx prismic field add group features --to-type page
```
2. **Add fields**
Add a field inside the group by using dot notation for the field ID: `.`. The group must already exist.
```sh
npx prismic field add text features.description --to-slice MySlice
npx prismic field add image features.icon --to-slice MySlice
```
> Only one level of nesting is supported. A repeatable group cannot contain another repeatable group.
* **Slice Machine:**
1. **Open Slice Machine**
In your Prismic project, start Slice Machine to begin editing content models.
```sh
npx start-slicemachine --open
```
2. **Add a repeatable group**
In Slice Machine, navigate to the slice, page type, or custom type you want to modify. Add a **repeatable group**.
The **label** determines the label shown to content writers in the [Page Builder](https://prismic.io/docs/guides/page-builder.md). Use an easily understandable name.
The **API ID** determines the property name in the Content API. Use a short, snake-cased name.
3. **Add fields**
For each field needed in the repeatable group, click the **Add a field** button and select a field. All field types are supported.
4. **(Optional) Make the repeatable group non-repeatable**
A repeatable group can be configured as non-repeatable, visually grouping fields in the Page Builder while preventing content writers from repeating them.
Open the repeatable group settings and uncheck the **Repeatable** setting.
# Use repeatable groups
A repeatable group can be displayed using a loop.
This example uses a repeatable group named `my_repeatable_group` containing a text field named `feature`.
**Next.js example:**
```tsx
{slice.primary.my_repeatable_group.map((item) => (
- {item.feature}
))}
```
**Nuxt example:**
```vue-html
```
**SvelteKit example:**
```svelte
{#each slice.primary.my_repeatable_group as item}
- {item.feature}
{/each}
```
Repeatable groups that are [non-repeatable](#optional-make-the-repeatable-group-non-repeatable) should access their fields using `[0]`:
```ts
const group = slice.primary.my_repeatable_group[0];
```
# Check if a repeatable group has items
Use `isFilled.group()` from [`@prismicio/client`](https://prismic.io/docs/technical-reference/prismicio-client/v7.md) to check if a repeatable group has items.
```ts
import { isFilled } from "@prismicio/client";
if (isFilled.group(slice.primary.my_group)) {
// Do something if `my_group` has items.
}
```
[Learn more about `isFilled`](https://prismic.io/docs/technical-reference/prismicio-client/v7.md#isfilled)
# API response
Here is what a repeatable group looks like from the Content API:
```json
{
"example_repeatable_group": [
{
"description": "Carrot",
"price": 55
},
{
"description": "Apple",
"price": 60
}
]
}
```
The repeatable field's content is determined by its fields.
A non-repeatable group returns a single-element array.
```json
{
"example_repeatable_group": [
{
"description": "Carrot",
"price": 55
}
]
}
```