Title: Blocks for ACF Fields — Display Custom Fields in the Block Editor Author: gamaup Published: September 17, 2024 Last modified: April 15, 2026 --- Search plugins ![](https://ps.w.org/acf-field-blocks/assets/banner-772x250.jpg?rev=3441531) ![](https://ps.w.org/acf-field-blocks/assets/icon-256x256.png?rev=3153438) # Blocks for ACF Fields — Display Custom Fields in the Block Editor By [gamaup](https://profiles.wordpress.org/gamaup/) [Download](https://downloads.wordpress.org/plugin/acf-field-blocks.1.5.0.zip) * [Details](https://ssw.wordpress.org/plugins/acf-field-blocks/#description) * [Reviews](https://ssw.wordpress.org/plugins/acf-field-blocks/#reviews) * [Installation](https://ssw.wordpress.org/plugins/acf-field-blocks/#installation) * [Development](https://ssw.wordpress.org/plugins/acf-field-blocks/#developers) [Support](https://wordpress.org/support/plugin/acf-field-blocks/) ## Description Blocks for ACF Fields lets you effortlessly load and display **Advanced Custom Fields( ACF)** or **Secure Custom Fields (SCF)** inside the WordPress block editor using a single, flexible block. Whether you’re dealing with text, images, URLs, or complex field types, this plugin makes it simple — all without writing a single line of code. #### How to Use it Just create your custom fields with the ACF or SCF plugin, then open the WordPress block editor. Add the “ACF Field” block to your page or template, select the field you want to display from the dropdown, and you are done! Your custom field will now appear right inside the editor, exactly where you want it. Want to see it in action? Watch the short demo video below to learn how it works in real time. #### Features * **No Code Needed** – Display your ACF & SCF fields directly in the editor without building a custom block. * **One Block for All Fields** – Load almost any field type using just a single, versatile block. * **Smart Field Picker** – No need to type field names. Choose from a dropdown that automatically shows only the ACF & SCF fields available for the post, page, or template you’re editing. * **Flexible Output Control** – Style and format your field values directly in the editor, with output that always works correctly regardless of the field’s return setting. * **Supports Most ACF/SCF Field Types** – Including Text, Image, Post Object, Taxonomy, User, and more. * **Supports All Field Locations** – Works with post fields, options pages, term fields, and user fields. * **Full Site Editing Ready** – Fully compatible with the WordPress Site Editor for building custom templates and theme parts. * **Dynamic Layouts Ready** – Seamlessly works inside Query Loops and reusable patterns for dynamic layouts. In addition to choosing which field to display, you also have control over how it appears. Text-based fields (including multiple-value fields like Select or Checkbox) can be shown as plain text or formatted with typography options. Image fields can be displayed as actual images with the same styling options as core Image blocks. For URL-return fields (such as Link or Post Object), you can render them as clickable buttons that automatically match your theme’s design. With this flexibility, the plugin supports most commonly used field types right out of the box. Here’s the full list of supported fields: * Text * Text Area * Number * Range * Email * URL * Password * Image * File * WYSIWYG Editor * oEmbed * Select * Checkbox * Radio Button * Button Group * True/False * Link * Post Object * Page Link * Relationship * Taxonomy * User * Google Map * Icon Picker * Date Picker * Date Time Picker * Time Picker * Color Picker In addition to the wide variety of field types, you also have control over where your fields are sourced from. This makes it easy to connect content dynamically based on the template you’re editing. * **Post (any post type)** – Load fields attached to the post you’re currently editing, whether it’s a post, page, or any custom post type. * **Option** – Pull global option fields, perfect for site-wide settings like logos, contact info, or social links. * **User** – Display fields attached to a user profile. Available when editing author templates, making it easy to showcase author bios, avatars, or custom user data. * **Taxonomy** – Load fields attached to taxonomy terms. Available when editing term archive templates, ideal for creating custom category, tag, or taxonomy layouts. Full documentation and usage guides are available at: [https://www.acffieldblocks.com/documentation/](https://www.acffieldblocks.com/documentation/?utm_source=wordpress.org&utm_medium=wp%20plugins%20repository) ### PRO Version – Unlock Advanced Field Support Upgrade to the PRO version to extend your layouts even further with advanced field types. PRO not only adds support for complex field types but also introduces more advanced output options, giving you full control over how your content is displayed. **Additional supported field types in PRO:** * **Repeater** – Easily transform your repeater fields into repeatable content sections inside the block editor. Each sub field can be accessed and styled individually, giving you full flexibility to match your layout needs. Display them as lists, grids, carousels, accordions, or tabs. * **Gallery** – Display your gallery fields as an image grid, masonry layout, or interactive carousel. Fine-tune responsive layouts with options for different screen sizes, and choose whether images open in a lightbox or link to the full- size version for an engaging user experience. * **Group** – Easily access and display sub fields inside group fields, no matter how deeply nested. The PRO version doesn’t just add support for new field types, it also unlocks ** powerful new display options** for fields already supported in the free plugin. These options let you loop through related content and build dynamic layouts directly in the block editor. * **Post Object & Relationship** – Display these fields as dynamic post loops ( List, Grid, or Carousel), similar to the Query Loop block, with the added ability to load custom fields within each post. Also supports Single Post display. Perfect for creating related posts sections or featured post displays. * **Taxonomy** – Render taxonomy fields as term loops (List, Grid, or Carousel), with the ability to access and display custom fields attached to each term. Also supports Single Term display. Ideal for flexible category, tag, or custom taxonomy layouts. * **User** – Display user fields as user loops (List, Grid, or Carousel), complete with ability to show custom fields attached to each user. Also supports Single User display. Great for building user directories, contributor listings, or team layouts. * **Google Map** – Display ACF Google Maps fields with custom markers and styling. Perfect for location-based content like store locators, event venues, or property listings. * **Embed Popup** – Display an ACF oEmbed or URL field inside a lightbox popup. The embed is only loaded on click, keeping your pages fast while providing rich media experiences. **Block Visibility by ACF** Blocks for ACF Fields PRO lets you control **when a block is displayed**, based on the value of an ACF or SCF field. This makes it easy to build smarter layouts without relying on custom PHP conditions or theme logic. Because visibility is handled at the block level, this works seamlessly across the block editor, site editor, templates, and patterns. From simple field displays to advanced, dynamic layouts, Blocks for ACF Fields gives you full control over how your content appears in the block editor. Start with the free version, and unlock even more powerful options with PRO when you’re ready to take your layouts further. [Click here to learn more about PRO version](https://www.acffieldblocks.com/pro/?utm_source=wordpress.org&utm_medium=wp%20plugins%20repository&utm_campaign=BlocksforACFFields%20Pro%20Upgrade) ## Screenshots * [[ * Load Fields Inside a Query Block * [[ * Select Field to Load * [[ * Field Settings ## Installation #### Automatic installation Automatic installation is the easiest option as WordPress handles the file transfers itself and you don’t even need to leave your web browser. 1. Go to your WordPress Plugin installation menu (Dashboard > Plugins > Add New) 2. In the search field type Blocks for ACF Fields and press enter. 3. \”Install Now\” and then click \”Active\” #### Manual installation For Manual installation, you download our product from WordPress directory uploading it to your web-server via your FTP or CPanel application. 1. Download the plugin and unzip it 2. Using an FTP program or CPanel upload the unzipped plugin folder to your WordPress installation’s wp-content/plugins/ directory. 3. Activate the plugin from the Plugins menu (Dashboard > Plugins > Installed Plugins) within the WordPress admin. ## FAQ ### What are the requirements to use this plugin? You need to have WordPress version 6.5+ and Advanced Custom Fields plugin version 6.1.0 or newer. ### Do I need the pro version of Advanced Custom Fields? No, you can still use the free version of Advanced Custom Fields as long as it is version 6.1.0 or newer. ### Who is this plugin for? This plugin is built with developers in mind — perfect for those who want to save time without sacrificing flexibility. At the same time, it’s intuitive and easy enough for end users to use without technical knowledge. ### Which ACF field types are supported? This plugin supports most field types, including text, image, URL, true/false, select, date/time, and more. However, the following fields are not supported in the free version: Repeater, Group, Gallery, Google Maps, Icon, Flexible Content, and oEmbed. ### Can this plugin save or update ACF field values? No. This plugin is read-only — it’s designed solely to display ACF field values in the block editor. Creating or saving field data should be done through the ACF interface or other editing tools. ### Does this plugin support the Site Editor? Yes, of course. ## Reviews ![](https://secure.gravatar.com/avatar/807225c3ea3b68a06bf38e9eeb36b47654652b4ba16c8f1148036daa3e649d0b? s=60&d=retro&r=g) ### 󠀁[Best plugin to display ACF fields on templates](https://wordpress.org/support/topic/best-plugin-to-display-acf-fields-on-templates/)󠁿 [DeepBlue](https://profiles.wordpress.org/deepblue5/) April 19, 2026 Hi Best plugin to display ACF fields on templates / query loops Works great / fast/ native Good job ! ![](https://secure.gravatar.com/avatar/ec03163337bcb6c076307da14c1041345fef345cf3ffa7931a78d3ecdbc798c2? s=60&d=retro&r=g) ### 󠀁[Does the job](https://wordpress.org/support/topic/does-the-job-1082/)󠁿 [annafjmorris](https://profiles.wordpress.org/annafjmorris/) March 3, 2026 I wasted a load of time trying to get ACF displaying on the front end, not being a developer I couldn’t get it to display my content. This did actually work, I just put the block in the page theme. However it was a bit odd in how it worked, taking a second to load, and the url field would only output on button mode. I wasn’t totally convinced it was up the the job for the client I was assisting, so I ditched ACF and moved to a directory plugin.I think this plugin is great but a better solution would be for ACF to have some free blocks and stop being … annoying…. Good on you for making this plugin, thanks! ![](https://secure.gravatar.com/avatar/8978bbc1124d6b6aca87f23c619a9752ff61aabdda8853fa1cf010d369670996? s=60&d=retro&r=g) ### 󠀁[Very Handy](https://wordpress.org/support/topic/very-handy-323/)󠁿 [cultivatestillness](https://profiles.wordpress.org/cultivatestillness/) February 22, 2026 1 reply It’s really great being able to just add blocks to display my custom fields anywhere I want. Very convenient and helpful for setting up my custom layouts for pages. Combined with any duplicate page function, it is a real time saver. I wonder if ACF or Blocks for ACF Fields includes a duplication function? Never thought to check. Does it? ![](https://secure.gravatar.com/avatar/9b96666db29b6a806ea50ea4bc6195ff05f9a21bd9f88ec5e9eb2d1e9d5a565d? s=60&d=retro&r=g) ### 󠀁[One of my favorite plugins](https://wordpress.org/support/topic/one-of-my-favorite-plugins-52/)󠁿 [wholebiz](https://profiles.wordpress.org/wholebiz/) September 17, 2025 I developed my own themes for my two businesses from scratch using theme.json and FSE all the way. This plugin is awesome for that. Works perfectly with Gutenberg Blocks. ![](https://secure.gravatar.com/avatar/99adfd1167aac8c6304894f4381ce4de09c4a1376e6f5c3ff176e34cfb35fbbe? s=60&d=retro&r=g) ### 󠀁[Exactly what I needed](https://wordpress.org/support/topic/exactly-what-i-needed-1005/)󠁿 [pinewarbler](https://profiles.wordpress.org/pinewarbler/) September 3, 2025 Straightforward, easy to implement and exactly what I needed to add custom fields to my custom posts. No fuss, no muss. ![](https://secure.gravatar.com/avatar/759e5fdc281b292ba6adcb1c55076b1b9dd6399fcec24429f6c3ef6cacb99d5d? s=60&d=retro&r=g) ### 󠀁[My Site Does So Much More Now](https://wordpress.org/support/topic/my-site-does-so-much-more-now/)󠁿 [enscored](https://profiles.wordpress.org/enscored/) September 2, 2025 I’ve built a few basic websites in the past, basically storefronts for local businesses. But this one is creating events and different kinds of pages and the Blocks for ACF plugin has made it so much easier to get things to work and look the way I want them to. Highly recommend this plugin. [ Read all 9 reviews ](https://wordpress.org/support/plugin/acf-field-blocks/reviews/) ## Contributors & Developers “Blocks for ACF Fields — Display Custom Fields in the Block Editor” is open source software. The following people have contributed to this plugin. Contributors * [ gamaup ](https://profiles.wordpress.org/gamaup/) [Translate “Blocks for ACF Fields — Display Custom Fields in the Block Editor” into your language.](https://translate.wordpress.org/projects/wp-plugins/acf-field-blocks) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/acf-field-blocks/), check out the [SVN repository](https://plugins.svn.wordpress.org/acf-field-blocks/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/acf-field-blocks/) by [RSS](https://plugins.trac.wordpress.org/log/acf-field-blocks/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 1.5.0 _Apr 15th, 2026_ * [PRO Only] **NEW:** Embed Popup block — display oEmbed/URL fields in a lightbox popup that loads only on click * [PRO Only] **NEW:** Display Google Map fields as interactive maps with custom marker and styling * **NEW:** Display Google Map fields as text with multiple return format options( Address, Lat/Lng, State, Country, Post Code, etc.) * **NEW:** Display ACF Icon Picker fields as icons with customizable size, color, and alignment * **NEW:** Added info tooltip to “Display Field As” dropdown showing descriptions for each display option #### 1.4.4 _Mar 17th, 2026_ * **FIX:** Fixed PHP 8+ error when `get_the_content()` is called without a valid post object #### 1.4.3 _Mar 9th, 2026_ * **FIX:** Fixed PHP 8+ error when `get_the_content()` is called without a valid post object * **FIX:** Fixed WYSIWYG field output to properly apply ACF content filters instead of using `nl2br()` #### 1.4.2 _Mar 4th, 2026_ * **FIX:** Fixed ACF version check timing by moving initialization to `after_setup_theme` hook * [PRO Only] **FIX:** Fixed REST API validation errors when using block visibility controls on server-side rendered blocks by stripping visibility attributes from block render requests #### 1.4.1 _Feb 20th, 2026_ * [PRO Only] **FIX:** Grid style broken on frontend side #### 1.4.0 _Feb 19th, 2026_ * **NEW:** Display oEmbed and URL fields as embed * [PRO Only] **NEW:** Display Repeater fields as accordions * [PRO Only] **NEW:** Display Repeater fields as tabs #### 1.3.3 _Feb 6th, 2026_ * [PRO Only] **FIX:** Add reset post data after loads field as posts loop #### 1.3.2 _Feb 3rd, 2026_ * **UPDATE:** Add supports to load term custom field inside term query * [PRO Only] **UPDATE:** Removes option to load Post Object, Relationship, Taxonomy, User field as List/Grid/Carousel if multiple value is set to false #### 1.3.1 _Jan 17th, 2026_ * **UPDATE:** Previewed field values will now automatically update after the post is saved * **UPDATE:** ACF Field blocks displayed as text, button, or image now supports interactivity to allow being inserted inside Query Loop block with Reload full page is set to false #### 1.3.0 _Jan 2nd, 2026_ * [PRO Only] **NEW:** Control block visibility based on ACF/SCF values * **NEW:** Standardized block hook filters * **UPDATE:** Removed the “Open in new tab” and “Mark as nofollow” options from Email fields displayed as buttons * **UPDATE:** Renamed the “Link Text” option to “Button Text” when displaying fields as buttons * **FIX:** Field options were not showing on single templates for custom post types with dashes in their slugs #### 1.2.8 _Nov 20th, 2025_ * [PRO Only] **FIX:** Resolved an issue where ACF post loops did not load custom fields from the linked post type inside nested blocks #### 1.2.7 _Nov 8th, 2025_ * **FIX:** Resolved “sprintf is not defined” error on ACF Image fields * [PRO Only] **UPDATE:** Set a default item count when the value is empty for Post Object, Taxonomy, and User fields using grid layouts. The default count now follows the “Items per Row” setting for consistent grid output #### 1.2.6 _Oct 24th, 2025_ * [PRO Only] **FIX:** Allowed adding Content blocks inside the ACF Posts List block * [PRO Only] **FIX:** Prevented “acf-field-blocks/data” store from being registered multiple times * [PRO Only] **UPDATE:** Updated Freemius SDK to v2.12.2 #### 1.2.5 _Sep 15th, 2025_ * **NEW:** Options to select which value to display for User fields, including Display Name, User Email, User Login, User Nickname, and User URL * **NEW:** Options to select which value to display for Taxonomy fields, including Name, Slug, and Description #### 1.2.4 _Jul 6th, 2025_ * [PRO Only] **NEW:** Display Repeater fields as a carousel * [PRO Only] **NEW:** Display Post fields as a carousel * [PRO Only] **NEW:** Display Taxonomy fields as a carousel * [PRO Only] **NEW:** Display User fields as a carousel #### 1.2.3 _Jun 20th, 2025_ * [PRO Only] **NEW:** Display Gallery fields using a masonry layout * **UPDATE:** Added an upgrade notice when selecting unsupported field types * **UPDATE:** Added a review notice #### 1.2.2 _Jun 9th, 2025_ * **FIX:** Resolved an undefined `get_current_screen` call introduced in the previous update #### 1.2.1 _Jun 7th, 2025_ * **FIX:** Fixed broken styles on several admin pages #### 1.2.0 _May 12th, 2025_ * **PRO:** Initial PRO version release #### 1.1.4 _May 3rd, 2025_ * **FIX:** Fixed “Class Fields not found” error #### 1.1.3 _May 2nd, 2025_ * **FIX:** Fixed an error with ACF Image fields from the previous update #### 1.1.2 _May 1st, 2025_ * **FIX:** Hide ACF Button when the value is empty * **FIX:** Fixed an issue where ACF Button text was not loading correctly when using an alternative field option * **UPDATE:** Refactored several field helper functions #### 1.1.1 _Apr 23rd, 2025_ * **FIX:** Fixed an error when loading blocks in the Pattern Editor #### 1.1.0 _Apr 20th, 2025_ * **NEW:** Introduced a unified “ACF Field” block to load all field types; previously separated field-type blocks are now hidden from the inserter * **NEW:** Added hooks to filter field output * **UPDATE:** Added shadow support to the ACF Image block * **UPDATE:** Added UL and OL tag options to the ACF Text block, enabling list output for multi-value fields * **UPDATE:** Updated all editor components to prevent deprecation warnings * **UPDATE:** Removed the “Open in New Tab” option for linked Email fields * **FIX:** New lines were not rendered correctly in Textarea fields * **FIX:** Post Object and Relationship fields were not rendered correctly on the frontend * **FIX:** Date field values (Date, DateTime, Time) were not formatted according to the field’s date format settings #### 1.0.0 _Sep 17th, 2024_ * Initial release ## Meta * Version **1.5.0** * Last updated **4 days ago** * Active installations **1,000+** * WordPress version ** 6.5 or higher ** * Tested up to **7.0** * PHP version ** 7.4 or higher ** * Language * [English (US)](https://wordpress.org/plugins/acf-field-blocks/) * Tags * [acf](https://ssw.wordpress.org/plugins/tags/acf/)[acf block](https://ssw.wordpress.org/plugins/tags/acf-block/) [block](https://ssw.wordpress.org/plugins/tags/block/)[meta field](https://ssw.wordpress.org/plugins/tags/meta-field/) * [Advanced View](https://ssw.wordpress.org/plugins/acf-field-blocks/advanced/) ## Ratings 4.9 out of 5 stars. * [ 8 5-star reviews ](https://wordpress.org/support/plugin/acf-field-blocks/reviews/?filter=5) * [ 1 4-star review ](https://wordpress.org/support/plugin/acf-field-blocks/reviews/?filter=4) * [ 0 3-star reviews ](https://wordpress.org/support/plugin/acf-field-blocks/reviews/?filter=3) * [ 0 2-star reviews ](https://wordpress.org/support/plugin/acf-field-blocks/reviews/?filter=2) * [ 0 1-star reviews ](https://wordpress.org/support/plugin/acf-field-blocks/reviews/?filter=1) [Your review](https://wordpress.org/support/plugin/acf-field-blocks/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/acf-field-blocks/reviews/) ## Contributors * [ gamaup ](https://profiles.wordpress.org/gamaup/) ## Support Issues resolved in last two months: 4 out of 4 [View support forum](https://wordpress.org/support/plugin/acf-field-blocks/)