GT ACF Blocks Plugin
Premium Secure Custom Fields (SCF) & ACF Blocks for WordPress: A comprehensive collection of beautifully crafted, customizable ACF Pro blocks. Zero-config setup, automatic field registration, and lightning-fast performance.
Now with 28+ Blocks & Auto Updates
Premium ACF Blocks for WordPress
A comprehensive collection of customizable ACF Pro blocks. Zero-config setup, automatic field registration, and fast output.
Get it for Free View on GitHub
28+
Custom Blocks
0
Config Needed
100%
Open Source
Why Choose ACF Blocks
Built for developers, practical for everyone
Zero-config setup
Field groups auto-register from JSON. Activate and start building.
Conditional loading
CSS and JS load only when a block is on the page.
Modular architecture
Every block is isolated with its own template and config.
ACF Block v3
Built on current ACF Block API with block.json metadata.
Accessible defaults
Native HTML patterns keep keyboard and screen reader support intact.
Schema support
FAQ and review schema output for better SERP visibility.
Block Library
28+ Ready-to-use blocks
From content sections to e-commerce components.
Works in seconds
Upload, activate, and start building. No extra setup.
- Automatic field group registration
- No WP-CLI or imports needed
- Compatible with any theme
- Easy to extend with custom blocks

Requirements
- WordPress 6.0+
- PHP 7.4+
- Advanced Custom Fields Pro 6.0+ or Secure Custom Fields latest version. Automatically installs SCF if ACF Pro is not installed already.
Installation
- Download the plugin and upload to
wp-content/plugins/acf-blocks-plugin/ - Activate the plugin through the WordPress admin
- Ensure ACF Pro is installed and activated
- Start using blocks in the block editor!
No additional configuration required β field groups are automatically registered.
Available Blocks
Content Blocks
- Accordion Block (
acf/accordion) β Collapsible content with FAQ schema support (searchable by βFAQβ) - Testimonial Block (
acf/testimonial) β Customer testimonials with ratings - Hero Block (
acf/hero) β Hero section with headline, image, and CTA - CTA Block (
acf/cta) β Call-to-action with heading and button - Callout Block (
acf/callout) β Highlighted callout boxes - Opinion Box (
acf/opinion-box) β Editorial content with author
Product & E-Commerce
- Product Review (
acf/product-review) β Reviews with star ratings and schema - Product Cards (
acf/product-cards) β Product showcase cards - Product Box (
acf/product-box) β Single product display with CTA buttons - Coupon Code (
acf/cb-coupon-code) β Promotional code display with copy feature - Compare Block (
acf/compare) β Side-by-side comparisons - PL Block (
acf/pl-block) β Product lists with pricing
Media & Display
- Video Block (
acf/video) β Video embeds - Gallery Block (
acf/gallery) β Image galleries - Stats Block (
acf/stats) β Statistics display - Star Rating (
acf/star-rating) β Interactive ratings with AJAX submission
Navigation & Organization
- Tabs Block (
acf/tabs) β Tabbed content with multiple styles - Feature Grid (
acf/feature-grid) β Grid layout for features - Section Block (
acf/section-block) β Container wrapper with InnerBlocks - Post Display (
acf/post-display) β Custom post listings
Team & Forms
- Team Member (
acf/team-member) β Team member profiles - Email Form (
acf/email-form) β Email capture forms - Thread Builder (
acf/thread-builder) β Discussion thread layouts
Block Structure
Each block follows a consistent directory structure:
blocks/
block-name/
βββ block.json # Block metadata (required)
βββ block-name.php # Render template (required)
βββ block-data.json # ACF field group (auto-registered)
βββ block-name.css # Styles (conditionally loaded)
βββ extra.php # Additional hooks (optional)
Key Features
Automatic Field Group Registration
Field groups are defined in JSON files (block-data.json or similar) within each block folder. These are automatically registered with ACF Pro when the plugin loads β no need to import/export through the ACF admin.
Native HTML Accordions
The Accordion block uses native HTML <details> and <summary> elements instead of JavaScript-based solutions. This provides:
- Zero JavaScript required
- Native keyboard accessibility
- Built-in browser support
- Reduced page weight
Conditional Asset Loading
CSS files are only enqueued when their respective blocks are used on a page, reducing unnecessary asset loading for better performance.
Creating Custom Blocks
- Create a new directory in
blocks/:
mkdir blocks/my-block
- Create
block.json:
{
"apiVersion": 3,
"name": "acf/my-block",
"title": "My Block",
"description": "Description here",
"category": "common",
"icon": "admin-post",
"keywords": ["custom"],
"acf": {
"renderTemplate": "my-block.php",
"blockVersion": 3
},
"supports": {
"align": true,
"mode": true,
"jsx": true
}
}
- Create
block-data.jsonwith your ACF field group configuration. - Create
my-block.phprender template. - Optionally add
my-block.cssfor styles.
The block will be automatically registered on the next page load.
CSS Class Naming Convention
All blocks use the acf- prefix for CSS classes to avoid conflicts with other plugins and themes. For example:
.acf-accordionβ Accordion block container.acf-testimonial-blockβ Testimonial block container.acf-hero-blockβ Hero block container
This ensures styles are properly scoped and wonβt interfere with your themeβs styling.
Development
Enable debug mode for detailed error logging:
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
License
GPL v2 or later
Credits
Built for Advanced Custom Fields Pro and WordPress block editor.