Display Formats

Display Formats determine how a field value is rendered inside the editor and on the frontend. Some field types can be displayed in multiple ways depending on the type of data they contain and how you want the content to appear in your layout.

The available display formats are automatically adjusted based on the selected field type. Some formats are available in the free version, while additional formats and advanced layouts are unlocked in the PRO version.

Because display formats are built directly into the block system, fields can be styled and customized using native WordPress block controls without requiring custom template code.

Basic Format

This option is used for simple field rendering when no structured layout is required.

FormatSupported Field TypesDescription
TextAll text-returned fieldsDisplays the field value as plain or formatted text.
ButtonEmail, URL, File, Link, Page LinkDisplays supported link-based fields as a clickable button.
ImageImageDisplays the selected image field using standard image block styling options.

Content Loop

Content Loop formats allow you to render structured fields (Post Object, Relationship, Taxonomy, User) as dynamic layouts instead of plain text. The block creates a loop structure similar to the Query Loop, letting you insert additional ACF Field blocks inside to load fields from each post, term, or user individually. These formats are available in the PRO version only.

FormatSupported Field TypesDescription
Post List PROPost Object (multiple), RelationshipDisplays multiple selected posts in a vertical list. Available when the field allows multiple values.
Post Grid PROPost Object (multiple), RelationshipDisplays multiple selected posts in a multi-column grid layout. Available when the field allows multiple values.
Post Carousel PROPost Object (multiple), RelationshipDisplays multiple selected posts in a slider layout. Available when the field allows multiple values.
Single Post PROPost Object (single)Displays one selected post. Available when the field allows a single value.
Term List PROTaxonomy (multiple)Displays multiple selected terms in a vertical list. Available when the field allows multiple values.
Term Grid PROTaxonomy (multiple)Displays multiple selected terms in a multi-column grid layout. Available when the field allows multiple values.
Term Carousel PROTaxonomy (multiple)Displays multiple selected terms in a slider layout. Available when the field allows multiple values.
Single Term PROTaxonomy (single)Displays one selected term. Available when the field allows a single value.
User List PROUser (multiple)Displays multiple selected users in a vertical list. Available when the field allows multiple values.
User Grid PROUser (multiple)Displays multiple selected users in a multi-column grid layout. Available when the field allows multiple values.
User Carousel PROUser (multiple)Displays multiple selected users in a slider layout. Available when the field allows multiple values.
Single User PROUser (single)Displays one selected user. Available when the field allows a single value.

Repeater

Repeater formats allow you to render each row of a Repeater field as a structured layout. The block automatically creates a loop for every row, and you can insert ACF Sub-Field blocks inside to display sub fields individually. These formats are available in the PRO version only.

FormatDescription
List PRODisplays repeater rows in a vertical list layout.
Grid PRODisplays repeater rows in a multi-column grid layout.
Carousel PRODisplays repeater rows in a slider layout.
Accordion PRODisplays repeater rows as collapsible sections, where each row can be expanded or collapsed individually.
Tabs PRODisplays repeater rows as tabbed panels, allowing users to switch between rows using tab navigation.

Gallery

Gallery formats allow you to display images from a Gallery field using structured image layouts. Each image in the field becomes part of the selected layout. These formats are available in the PRO version only.

FormatDescription
Image Grid PRODisplays gallery images in a standard grid layout.
Image Carousel PRODisplays gallery images in a slider layout.
Masonry PRODisplays gallery images in a masonry-style layout with dynamic image heights.

Interactive Display

Displays content using interactive elements such as maps or on-demand embeds, allowing user interaction while improving performance by loading content only when needed.

FormatSupported Field TypesDescription
EmbedoEmbed, URLRenders oEmbed field content such as videos or external media embeds.
Embed Popup PROoEmbed, URLDisplays embedded content inside a popup triggered by user interaction. The embed is loaded only when opened, helping reduce initial page load and improve performance.
Map PROGoogle MapDisplays the selected location as an interactive map using the Google Maps API key configured in ACF, with support for markers and map customization.

Summary of Available Display Formats by Field Type

Field TypeFree VersionPro Version
TextTextText
Text AreaTextText
NumberTextText
RangeTextText
EmailText, ButtonText, Button
URLText, Button, EmbedText, Button, Embed, Embed Popup
PasswordTextText
ImageImageImage
FileButtonButton
WYSIWYG EditorTextText
oEmbedEmbedEmbed, Embed Popup
GalleryImage Grid, Image Carousel, Masonry
SelectTextText
CheckboxTextText
Radio ButtonTextText
Button GroupTextText
True / FalseTextText
LinkText, ButtonText, Button
Post ObjectTextText, Single Post, Post List, Post Grid, Post Carousel
Page LinkText, ButtonText, Button
RelationshipTextText, Post List, Post Grid, Post Carousel
TaxonomyTextText, Single Term, Term List, Term Grid, Term Carousel
UserTextText, Single User, User List, User Grid, User Carousel
Google MapsTextText, Map
Date PickerTextText
Date Time PickerTextText
Time PickerTextText
Color PickerTextText
Icon PickerIconIcon
RepeaterList, Grid, Carousel, Accordion, Tabs