RepeaterKit – Repeater Fields for ACF

By Shubhadip Bhowmik

0+ active installationsVersion 1.0.0

Free, accessible, high-performance repeater field type for Advanced Custom Fields (ACF Free) and Secure Custom Fields (SCF).

Description

RepeaterKit is a lightweight, high-performance, and developer-friendly repeater field plugin designed specifically for the free version of Advanced Custom Fields (ACF Free) and Secure Custom Fields (SCF).

Need to build repeatable rows of content – like FAQs, customer reviews, team rosters, pricing tables, product specs, or feature lists – without paying for an expensive subscription? RepeaterKit brings full repeater capabilities straight to your free ACF or SCF setup with zero bloat and zero upsells.

🌟 Key Highlights

  • 100% Free & Open Source: Full repeater functionality for ACF Free and SCF without recurring costs.
  • Lightning-Fast Single-Meta Architecture: Unlike traditional repeaters that insert dozens of separate rows into your wp_postmeta database table, RepeaterKit stores all row data in a single clean, optimized record. Your database stays lean and queries run at peak speed.
  • Accessibility First (WCAG 2.2 AA): Engineered from the ground up for full keyboard accessibility and screen readers. Features ARIA landmarks, keyboard-operable row reordering, and live announcements via WordPress wp.a11y.speak.
  • Three Polished Layouts: Seamlessly switch between Table, Block, and Row layouts to fit any admin editing workflow.
  • 19+ Subfield Types: Mix and match text, images, media files, rich WYSIWYG editors, color pickers, date-time pickers, dropdowns, and checkboxes inside your repeaters.
  • One-Click JSON Import & Export: Instantly backup, copy, or migrate row data across staging and production sites.
  • Clean, Documented Template API: Use familiar, human-readable helper functions or query rows directly with native get_field().
  • Privacy-Respecting & Bloat-Free: Zero tracking, zero telemetry, zero external API calls, and no intrusive dashboard notices.

🎯 Common Use Cases

  • FAQ Accordions: Let editors add, reorder, and update questions and answers with rich text.
  • Customer Testimonials & Reviews: Capture client quotes, avatars, company names, and star ratings.
  • Team & Staff Directories: Manage employee cards with photos, job titles, bios, and social links.
  • Pricing & Comparison Tables: Build flexible pricing columns, feature checklists, and CTA buttons.
  • Product Specifications: Create key-value specification tables for eCommerce and portfolio items.
  • Project Timelines & Milestones: Detail step-by-step roadmaps, release notes, and case studies.

🧩 19+ Supported Subfield Types

RepeaterKit includes built-in support for all primary field types:

  • Text & Content: Text, Text Area, WYSIWYG Editor (TinyMCE), Number, Email, URL.
  • Choices & Selectors: Select (Dropdown), Checkbox, Radio Buttons, Button Group, True / False (Toggle).
  • Media & Attachments: Image (WordPress Media Library picker), File attachment.
  • Pickers & Controls: Date Picker, Time Picker, Date-Time Picker, Color Picker, Range Slider.
  • Links & Relationships: Custom URL / Link input.

🚀 Quick Start Guide

  1. Make sure Advanced Custom Fields (ACF Free 6.0+) or Secure Custom Fields (SCF) is installed and active.
  2. In your WordPress admin, navigate to ACF > Field Groups (or Custom Fields > Field Groups).
  3. Create a new field group (or edit an existing one), click + Add Field, and select RepeaterKit Repeater as the field type.
  4. Choose your preferred layout (Table, Block, or Row), set optional minimum or maximum row limits, and add your desired subfields in the Subfields Builder.
  5. Save the field group.
  6. Open any post or page where the field group is assigned to add, drag-and-drop reorder, duplicate, or remove rows.

💻 Developer Template API

RepeaterKit provides a modern, secure, and context-aware loop API modeled after classic WordPress conventions.

Example 1: Basic Template Loop

Outputting a list of repeatable items on your single template or page template:

<?php if ( repeaterkit_have_rows( 'faq_list' ) ) : ?>
    <div class="faq-accordion">
        <?php while ( repeaterkit_have_rows( 'faq_list' ) ) : repeaterkit_the_row(); ?>
            <div class="faq-item">
                <h3><?php repeaterkit_the_sub_field( 'question' ); ?></h3>
                <div class="faq-answer">
                    <?php repeaterkit_the_sub_field( 'answer', 'wysiwyg' ); ?>
                </div>
            </div>
        <?php endwhile; ?>
    </div>
<?php endif; ?>

Example 2: Getting Subfield Values with Conditional Logic

When you need to perform calculations, check conditions, or manipulate values before displaying:

<?php if ( repeaterkit_have_rows( 'team_members' ) ) : ?>
    <div class="team-grid">
        <?php while ( repeaterkit_have_rows( 'team_members' ) ) : repeaterkit_the_row(); ?>
            <?php
            $name     = repeaterkit_get_sub_field( 'name', 'Team Member' );
            $role     = repeaterkit_get_sub_field( 'role', '' );
            $image_id = repeaterkit_get_sub_field( 'photo' );
            $bio      = repeaterkit_get_sub_field( 'bio', '' );
            ?>
            <div class="team-card">
                <?php if ( $image_id ) : ?>
                    <?php echo wp_get_attachment_image( (int) $image_id, 'medium', false, array( 'class' => 'team-avatar' ) ); ?>
                <?php endif; ?>
                <h4><?php echo esc_html( $name ); ?></h4>
                <?php if ( $role ) : ?>
                    <span class="team-role"><?php echo esc_html( $role ); ?></span>
                <?php endif; ?>
                <?php if ( $bio ) : ?>
                    <p class="team-bio"><?php echo esc_html( $bio ); ?></p>
                <?php endif; ?>
            </div>
        <?php endwhile; ?>
    </div>
<?php endif; ?>

Example 3: Contextual Escaping with repeaterkit_the_sub_field()

repeaterkit_the_sub_field() accepts an optional second parameter to ensure proper escaping for your target context:

<?php // Escaping as safe HTML (default) ?>
<p><?php repeaterkit_the_sub_field( 'description', 'html' ); ?></p>

<?php // Escaping inside an HTML attribute ?>
<input type="text" value="<?php repeaterkit_the_sub_field( 'default_text', 'attr' ); ?>" />

<?php // Escaping as a clean URL ?>
<a href="<?php repeaterkit_the_sub_field( 'website_url', 'url' ); ?>">Visit Website</a>

<?php // Escaping rich WYSIWYG markup (wp_kses_post) ?>
<div class="rich-content"><?php repeaterkit_the_sub_field( 'long_bio', 'wysiwyg' ); ?></div>

Example 4: Row Counts and Indices

<?php if ( repeaterkit_have_rows( 'features' ) ) : ?>
    <p>Total Features: <?php echo esc_html( repeaterkit_get_row_count( 'features' ) ); ?></p>
    <ul>
        <?php while ( repeaterkit_have_rows( 'features' ) ) : repeaterkit_the_row(); ?>
            <li>
                <strong>#<?php echo esc_html( repeaterkit_get_row_index() ); ?>:</strong>
                <?php repeaterkit_the_sub_field( 'feature_name' ); ?>
            </li>
        <?php endwhile; ?>
    </ul>
<?php endif; ?>

Example 5: Native get_field() Direct Access

If you prefer working with raw arrays or passing data to REST APIs, JavaScript applications, or block themes:

<?php
$rows = get_field( 'pricing_packages' );
if ( ! empty( $rows ) && is_array( $rows ) ) {
    foreach ( $rows as $row ) {
        echo '<div class="package">';
        echo '<h3>' . esc_html( $row['package_name'] ?? '' ) . '</h3>';
        echo '<p>Price: $' . esc_html( $row['price'] ?? 0 ) . '</p>';
        echo '</div>';
    }
}
?>

📦 JSON Export and Import

RepeaterKit includes built-in per-field JSON export and import:
* Export: Click the Export JSON button in the repeater controls to instantly copy the field’s complete row structure and data to your clipboard.
* Import: Click Import JSON, paste your JSON payload, and RepeaterKit validates the schema, verifies nonces and user capabilities, sanitizes all inputs, and regenerates your rows cleanly.

⚖️ Trademark Disclaimer

RepeaterKit is an independent open-source plugin. It is not affiliated with, sponsored by, endorsed by, or in any way associated with Advanced Custom Fields (ACF), WP Engine, or WordPress.org. “ACF” and “Advanced Custom Fields” are registered trademarks of their respective owners.

Installation

Automatic Installation (Recommended)

  1. In your WordPress admin dashboard, go to Plugins > Add New Plugin.
  2. In the search bar, type RepeaterKit.
  3. Locate RepeaterKit – Repeater Fields for ACF and click Install Now.
  4. Once installed, click Activate.

Manual Installation

  1. Download repeaterkit.zip from WordPress.org.
  2. In your WordPress admin, go to Plugins > Add New Plugin > Upload Plugin.
  3. Choose the downloaded ZIP file and click Install Now.
  4. Activate the plugin through the Plugins menu.

Requirements

  • WordPress 6.2 or higher
  • PHP 7.4 or higher (fully compatible with PHP 8.0, 8.1, 8.2, 8.3+)
  • Advanced Custom Fields (Free) 6.0+ or Secure Custom Fields (SCF)

FAQ

Does RepeaterKit require ACF Pro?

No. RepeaterKit is specifically created to provide complete, robust repeater functionality using ACF Free or Secure Custom Fields (SCF). You do not need an ACF Pro subscription.

Does RepeaterKit work with Secure Custom Fields (SCF)?

Yes! RepeaterKit offers 100% full parity with both ACF Free and Secure Custom Fields (SCF). It automatically detects whichever engine is active on your site.

Why does RepeaterKit use a single-meta storage model?

ACF Pro creates one postmeta record per subfield per row, plus an additional meta key tracking the row count. For repeaters with 5 subfields and 20 rows, that represents over 100 separate database queries and database rows for a single post!

RepeaterKit stores all rows in a single structured JSON/serialized metadata record. This delivers dramatically faster database read/write speeds, keeps your database lean, and simplifies post exports.

Can I use native get_field() to access rows?

Yes. Standard get_field( 'your_repeater' ) returns an associative array of all rows with subfield names and formatted values.

What is the difference between have_rows() and repeaterkit_have_rows()?

Native have_rows() is hardcoded in ACF core to query ACF Pro’s multi-meta storage layout. To maintain high performance and prevent database collisions, RepeaterKit provides its own identical, optimized loop helper: repeaterkit_have_rows(), repeaterkit_the_row(), and repeaterkit_the_sub_field().

Are nested repeaters supported in version 1.0?

Nested repeaters (a repeater placed inside another repeater) are planned for an upcoming release. Version 1.0 focuses on rock-solid stability, maximum compatibility, and subfield breadth for single-level repeaters.

Can I reorder rows using drag and drop?

Yes! Every row can be reordered using drag-and-drop handles. In addition, every row includes dedicated Move Up, Move Down, and Duplicate Row buttons for keyboard accessibility.

Does RepeaterKit send any data to external servers?

No. RepeaterKit collects zero telemetry, has no tracking pixels, makes zero external HTTP requests, and includes no advertisements or upsell notices. All code runs 100% locally on your WordPress server.

What happens if I deactivate or delete RepeaterKit?

Your saved post data remains completely safe in your database. If you uninstall RepeaterKit through the WordPress admin screen, its cleanup script removes only internal transients and settings – user content and postmeta are never deleted.

Screenshots

Changelog

1.0.0

  • Initial public release on WordPress.org.
  • Integrated repeaterkit_repeater field type with Table, Block, and Row layouts.
  • Visual Subfield Builder supporting 19+ subfield types.
  • High-performance single-meta storage engine.
  • Full keyboard and screen reader accessibility (WCAG 2.2 AA).
  • Per-field JSON export and import tools.
  • Public template loop API (repeaterkit_have_rows, repeaterkit_the_row, repeaterkit_get_sub_field, repeaterkit_the_sub_field, repeaterkit_get_row_count, repeaterkit_get_row_index, repeaterkit_reset_rows).
  • Zero external network calls and 100% privacy compliance.