Contact Form 7 – Repeatable Fields

By Felipe Elia

★ 4.3/5 (21 ratings)6,000+ active installationsVersion 3.0.0

Adds repeatable groups of fields to Contact Form 7.

Description

This plugin adds repeatable groups of fields to Contact Form 7.

Requires Contact Form 7 6.2.5 or newer.

Usage

Form tab

Wrap the desired fields with [field_group your_group_id_here][/field_group]. The shortcode accepts additional parameters, in WP shortcode format and in CF7 fields parameters format as well.

Example:

[field_group emails id="emails-groups" tabindex:1]
    <label>Your Email (required)[email* your-email]</label>
    [radio your-radio use_label_element default:1 "radio 1" "radio 2" "radio 3"]
    [select* your-menu include_blank "option1" "option 2"]
    [checkbox* your-checkbox "check 1" "check 2"]
[/field_group]

Mail tab

In the mail settings, wrap the fields with your group id. You can use the [group_index] tag to print the group index and an additional __<NUMBER> to print a field at a specific index.

Example:

The second email entered by the user was: [your-email__2]

These were the groups:
[emails]
GROUP #[group_index]
    Checkbox: [your-checkbox]
    E-mail: [your-email]
    Radio: [your-radio]
    Select: [your-menu]
[/emails]

Upgrading to 3.0.0

  • Requires WordPress 7.1+, PHP 8.3+, and Contact Form 7 6.2.5+.
  • Group events now use native DOM CustomEvents. Update integrations using jQuery event handlers; the plugin no longer loads jQuery. See the JavaScript events documentation for the event payloads and migration details.
  • The default buttons now read “Add group” and “Remove group”, and adding/removing a row moves keyboard focus. Existing button filters still work.
  • IDs inside repeated rows, including the first row, receive unique suffixes. Update CSS and JavaScript that target these IDs to use classes or field names, and keep label/ARIA references inside their row.
  • Group names accept only letters, numbers, underscores, and hyphens. Rename groups using other characters in both the form and mail templates.
  • The server accepts at most 50 rows per submitted group by default. Additional rows are not processed for validation or mail. This does not limit the frontend add button. If your form needs more rows, adjust the wpcf7_field_group_max_rows filter before upgrading.

Check out the Wiki

Contribute

You can contribute with code, issues and ideas at the GitHub repository.

If you like the plugin, a review is appreciated 🙂

FAQ

I have a problem with the plugin. Where can I get help?

If you have identified a bug or would like to suggest an enhancement, please refer to our GitHub repo. I do not provide support here at WordPress.org forums.

My question is not listed here. Can I search somewhere else?

Yes! Give a look at the Frequently Asked Questions section of our wiki.

Changelog

3.0.0 – 2026-11-16

Note that this version changes minimum required versions of:

Added:

  • Regression tests for the form reported in #65, both mail templates, and resubmission after a successful form reset. Props @suchitpatel0722 and @felipeelia.

Changed:

  • Added daily WordPress and Contact Form 7 compatibility checks with automated failure issues and tested-version pull requests, and limited WordPress.org readme and asset updates to releases. Props @felipeelia.
  • Updated contribution and release instructions, limited WordPress.org deployment to published releases that are not marked as prereleases, and simplified GitHub Actions version references. Props @felipeelia.
  • Improved repeatable group accessibility with descriptive button labels, predictable keyboard focus, unique row IDs and matching references, and mobile sizing. Props @felipeelia.
  • Removed the frontend jQuery dependency, migrated group events to native CustomEvents, and fixed exclusive checkbox choices affecting separate form instances. Props @felipeelia.
  • Updated compatibility with Contact Form 7 6.2.5+, fixed repeated-field validation, replaced Cypress end-to-end tests with Playwright and WordPress Playground, and updated PHP development tools and GitHub Actions. Props @felipeelia.
  • Updated npm development dependencies, migrated JavaScript linting to ESLint 10, and raised the Node.js minimum version to 24.15+ or 26+. Props @felipeelia.

Security:

  • Harden group ID and row count handling, with a configurable maximum of 50 rows per group. Props @felipeelia.

2.0.2 – 2024-10-22

This is a security release. It fixes a Stored cross-site scripting (XSS) vulnerability, that allowed users with contributor-level access and above, to inject arbitrary web scripts in pages that will execute whenever a user accesses an injected page. Thanks to Peter Thaleikis and the Wordfence team for reaching out about it.

Added:

Changed:

Security:

  • Sanitize wrapper div attributes. Props Peter Thaleikis and @felipeelia.
  • Bumped postcss from 8.4.26 to 8.4.31. Props @dependabot.
  • Updated ws from 8.13.0 to 8.18.0. Props @dependabot.
  • Updated @wordpress/scripts from 27.7.0 to 30.3.0. Props @dependabot.
  • Bumped braces from 3.0.2 to 3.0.3. Props @dependabot.
  • Bumped webpack from 5.91.0 to 5.94.0. Props @dependabot.
  • Bumped express from 4.18.2 to 4.19.2. Props @dependabot.
  • Bumped follow-redirects from 1.15.2 to 1.15.6. Props @dependabot.
  • Bumped webpack-dev-middleware from 5.3.3 to 5.3.4. Props @dependabot.
  • Bumped @babel/traverse from 7.22.8 to 7.23.2. Props @dependabot.
  • Several node packages updated. Props @felipeelia.

2.0.1 – 2023-09-11

Added:

  • End-to-end tests foundation.

Changed:

  • Removed unnecessary files from final package.

Fixed:

  • Required checkbox not showing validation messages.

2.0.0 – 2023-07-23

Note that this version changes minimum required versions of:

This release marks the (slow) resumption of this plugin development. If you want to know more about it check out this blog post. If you find this plugin useful, consider leaving it a review.

Added:

  • Support to wp-env.
  • group_id as a parameter to all filters.
  • Very basic unit testing.

Changed:

  • Linting tools and script build process.
  • Docs were migrated to GitHub wiki.

Fixed:

  • Validation problem with Contact Form 5.7+. Props @sfdeveloper.

1.1.3 – 2019-12-11

  • Update WP Tested up to field
  • Apply WP Coding Standards
  • Fix a small sanitization problem

1.1.2 – 2019-10-10

  • Fix Exclusive Checkboxes

1.1.1 – 2019-09-04

  • Add compatibility to formatted dates ([_format_{field name} "{date format}"])
  • DEV: Copy data and events while cloning a new group (JS)
  • DEV: Pass $new_group as an extra param for the wpcf7-field-groups/added event.
  • DEV: Apply some WPCS rules and add a CF7_REPEATABLE_FIELDS_VERSION const (may affect JS cache)

1.1 – 2018-06-14

  • Replace groups in mail 2 field

1.0.2 – 2018/03/29

  • Fix repeated tags in mail body

1.0.1 – 2018/03/20

  • Fix the wpcf7_field_group_remove_button_atts filter name. Props to @asilvestre87

1.0.0 – 2018/03/19

  • Initial release