The Term Carousel display format loops through each term referenced by an ACF Taxonomy field and renders them inside a swipeable Swiper.js carousel. Each term becomes its own block context, so any blocks inserted inside repeat per slide.
The carousel supports autoplay, responsive items-per-view, and an items-to-slide stride.
Supported Field Types
The Term Carousel display format supports the following field types (only when the field allows multiple values):
- Taxonomy (multi-select, checkbox)
Inner Blocks (Loop Item)
The loop item is the template rendered once per term referenced by the field — one card per carousel slide. Each term is exposed as block context (termId, taxonomy), so any term-aware block placed inside resolves against that term.
How to add blocks
- Click inside the loop item area. The block ships with a Term Name block as the default template (on WordPress 6.9+; older versions fall back to the plugin’s Term Name field block).
- Use the “+” inserter to add blocks. Common choices include:
- Term Name (WordPress 6.9+) or the plugin’s Term Name field block.
- ACF Sub-Field blocks (Text / Image / Button / Icon / etc.) targeting fields attached to the taxonomy. Their Field Source auto-scopes to the current term.
- Standard WordPress blocks (Group, Columns, Heading, Image, etc.) also work for layout.
Editing vs. previewing the carousel
By default the block stays in Edit mode, where only the first term’s loop item is editable and the remaining terms render as live previews. Use the Edit / Preview toolbar toggle to switch to Preview mode, which renders the actual Swiper carousel inside the editor.
Customization
Most of the layout’s appearance comes from the blocks you place inside each slide. The sidebar controls focus on the carousel’s behavior, sizing, and autoplay.
| Customization | Description | Note |
|---|---|---|
| Edit / Preview | Toolbar toggle that switches between editing the slide template and previewing the live carousel inside the editor. | Lives in the block toolbar. Only available when the layout is set to Carousel. |
| Items per slide | Number of cards visible at once per breakpoint (desktop / tablet / mobile). Range: 1–8. | |
| Autoplay | Automatically advances the carousel at a set interval. | |
| Delay | Seconds between automatic advances. Range: 1–10. | Only shown when Autoplay is enabled. |
| Pause on hover | Pauses autoplay while the cursor is over the carousel. | Only shown when Autoplay is enabled. |
| Items to slide | Number of cards advanced per autoplay tick or swipe. Bounded by Items per slide. | Lives in the Carousel Settings panel, with a per-breakpoint responsive control. Only shown when Autoplay is enabled. |
| Direction | Autoplay direction. Options: To Left, To Right. | Only shown when Autoplay is enabled. |
| Items Gap | Pixel spacing between adjacent slides. Range: 0–100. | Lives in the Dimensions panel under “Items Gap” (single horizontal gap). |
| Empty Message | Toggle (“Show message if empty”) plus fallback text shown when the field references no terms. | |
| Layout Variations | Switch the variation to render the same field as a list or grid instead of a carousel. | The List / Grid / Carousel toggles share the same underlying block — switching only changes the type attribute. |
The block also supports the following standard WordPress block controls: Block Alignment (wide, full), Margin, and Padding.