ACF Blocks is a WordPress plugin that provides 29 custom Gutenberg blocks built on Advanced Custom Fields (ACF). Every block uses ACF Block API v3 with block.json metadata, and field groups are registered automatically from JSON files. No manual ACF imports are needed.
The plugin is designed as a standalone package. Install it, activate it, and the blocks appear in your editor. Each block is self-contained with its own render template, styles, field definitions, and optional extra functionality.
What This Plugin Provides
- 29 production-ready blocks for content, products, media, navigation, and forms
- Automatic field group registration from JSON (no ACF admin imports)
- Conditional asset loading (CSS only loads when a block is used on the page)
- Block transforms between core WordPress blocks and ACF blocks
- Structured data (JSON-LD) output for FAQ, product review, star rating, and TOC blocks
- External image localization on post save
- A license system for automatic updates
Requirements
- WordPress 6.0 or higher
- PHP 7.4 or higher
- Advanced Custom Fields Pro 6.0+ or Secure Custom Fields (free)
If neither ACF Pro nor Secure Custom Fields is installed when the plugin is activated, the plugin will attempt to install and activate Secure Custom Fields from the WordPress.org repository automatically.
Plugin Constants
The plugin defines four constants on load:
ACF_BLOCKS_VERSION– Current plugin version (e.g.2.1.6)ACF_BLOCKS_PLUGIN_DIR– Absolute path to the plugin directoryACF_BLOCKS_PLUGIN_URL– URL to the plugin directoryACF_BLOCKS_PLUGIN_FILE– Absolute path to the main plugin file
License
GPL v2 or later.