Documentation
Overview
Blocks for ACF Fields is a WordPress plugin that lets you display Advanced Custom Fields (ACF) and Secure Custom Fields (SCF) directly inside the Block Editor using a single, flexible block.
Instead of creating custom blocks, writing PHP, or manually referencing field names, you simply add the ACF Field block and select the field you want to display from a smart dropdown. The plugin automatically detects which fields are available based on the post, template, or context you’re editing, making it fast and error-free to work with custom fields.
The plugin is designed to be read-only. It focuses purely on rendering field values in the editor and on the front end, while field creation and data management remain fully handled by ACF or SCF.
Minimum Requirements
| PHP Version | 7.4 |
| WordPress Version | 6.5 |
| ACF/SCF Version | 6.1.0 |
How to Use Blocks for ACF Fields
Create a field group and assign it to a location
Simply configure the field group using ACF’s default location rules for posts, users, terms, or options pages. The fields will be recognized automatically by the block editor, with no need for extra block registration.
Insert the “ACF Field” block in the editor
While editing a page or template, add the ready-to-use block that already supports all field types. No need to create a custom block, build a template file, or write PHP to register anything.
Select the field to display
Pick the field from a filtered list that only shows the fields available for the current page or template. No need to type field names manually or guess which fields belong to the content.
Style the output visually
Apply styling options directly in the editor while the block automatically handles any field return format setting. No need to enqueue CSS, write custom styles, or manage separate frontend and backend asset files.
Supported Field Sources
Field Sources define where the ACF field value is loaded from, depending on the context of the editor or template you are working in.
| Current Post | This source loads field values that are saved against the current post being rendered, including posts, pages, and any custom post type. In ACF, these fields are created using location rules such as Post Type, Post, or Page. This option is available in the block editor when editing a post, page, or single post template in the Site Editor, and also when the block is placed inside a Query Loop, where it will load field values from each post in the loop. |
| Option | This source loads field values from ACF Options Pages, which are stored globally and are not linked to any specific post or entity. In ACF, these fields are registered with the Options Page location rule. This option is available in the block editor in all contexts, including posts, pages, templates, and loop blocks, making it suitable for displaying site-wide settings such as logos, contact information, or other global values. |
| Current Term | This source loads field values attached to the currently queried taxonomy term, such as a category, tag, or custom taxonomy. In ACF, these fields are created using the Taxonomy Term location rule. This option is available in the block editor when editing taxonomy archive templates in the Site Editor, and also when the block is placed inside a Term Loop, where it will load field values from each term in the loop. |
| Current User | This source loads field values attached to the currently queried user. In ACF, these fields are created using the User Form location rule. This option is available in the block editor when editing author templates in the Site Editor, allowing you to display author details such as biographies, avatars, or other custom user metadata. |
Supported Field Types
Available Display Formats
Basic Format
This option is used for simple field rendering when no structured layout is required.
| Format | Supported Field Types | Description |
|---|---|---|
| Text | Text, Text Area, Number, Range, Email, URL, Password, WYSIWYG, Select, Checkbox, Radio, Button Group, True/False, Link, Post Object, Page Link, Relationship, Taxonomy, User, Date, Date Time, Time Color | Displays the field value as plain or formatted text. |
| Button | Email, URL, File, Link, Page Link | Displays supported link-based fields as a clickable button. |
| Image | Image | Displays the selected image field using standard image block styling options. |
| Embed | oEmbed, URL | Renders oEmbed field content such as videos or external media embeds. |
Content Loop
PRO
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.
| Format | Supported Field Types | Description |
|---|---|---|
| List | Post Object, Relationship, Taxonomy, User | Displays multiple selected items in a vertical list. Available when the field allows multiple values. |
| Grid | Post Object, Relationship, Taxonomy, User | Displays multiple selected items in a multi-column grid layout. Available when the field allows multiple values. |
| Carousel | Post Object, Relationship, Taxonomy, User | Displays multiple selected items in a slider layout. Available when the field allows multiple values. |
| Single Post | Post Object | Displays one selected Post Object. Available when the field allows a single value. |
| Single Term | Taxonomy | Displays one selected taxonomy term. Available when the field allows a single value. |
| Single User | User | Displays one selected user. Available when the field allows a single value. |
Repeater
PRO
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.
| Format | Description |
|---|---|
| List | Displays repeater rows in a vertical list layout. |
| Grid | Displays repeater rows in a multi-column grid layout. |
| Carousel | Displays repeater rows in a slider layout. |
| Accordion | Displays repeater rows as collapsible sections, where each row can be expanded or collapsed individually. |
| Tabs | Displays repeater rows as tabbed panels, allowing users to switch between rows using tab navigation. |
Gallery
PRO
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.
| Format | Description |
|---|---|
| Image Grid | Displays gallery images in a standard grid layout. |
| Image Carousel | Displays gallery images in a slider layout. |
| Masonry | Displays gallery images in a masonry-style layout with dynamic image heights. |
Support & Pre-Purchase Questions
If you have any issues, need guidance, or want to share feedback, feel free to reach out directly to us via email: support@acffieldblocks.com