You don't have javascript enabled. Good luck with that. ACF Field for CF7: What Changed in v1.8.1 and When to Upgrade to Pro

ACF Field for CF7: What Changed in New Update and When You Should Upgrade to Pro

Thursday, April 9, 2026 / WordPress Plugin / Dhruvang Shah

ACF Field for CF7 What Changed in New Update and When You Should Upgrade to Pro

 

ACF Field for CF7 just pushed version 1.8.1 to the WordPress repository. It is not just a compatibility bump — there are meaningful code changes under the hood that affect how the plugin behaves with the current ACF 5 and ACF 6 versions.

Now is a good time to see where the free version ends and Pro begins, as the line between them is clearer than ever.

 

What Actually Changed in Version 1.8.1

There are several updates that matter if you have been running this plugin on a production site.

ACF 3 and ACF 4 support dropped

The plugin now requires ACF 5 or ACF 6. If you are on ACF 3 or 4, both years past end-of-life with known security issues, you need to upgrade ACF before updating this plugin.

Allow Null toggle added

A new Allow Null toggle lets editors mark the CF7 field as optional. If no form needs to appear in a location, the field can be left empty without the template throwing an error. Previously this required custom code in the template. Now it is a field setting.

format_value() fixed for front-end rendering

The plugin now handles shortcode-to-HTML conversion at the ACF field level. do_shortcode() is no longer needed in templates. If you had it wrapped around get_field(), you can remove it after updating.

 

What the Free Version Covers

The free plugin is available at wordpress.org/plugins/acf-field-for-contact-form-7 with over 10,000 active installations. Here is what you get.

  •   A Contact Form 7 field type inside ACF (free or Pro)
  •   The dropdown is populated automatically from all CF7 forms on the site
  •   Rendered form markup returned by get_field() — no do_shortcode() needed
  •   Allow Null toggle so the field can be left empty
  •   Works on post types, pages, and ACF options pages
  •   Works inside ACF Flexible Content, Repeater, and Group fields
  •   acf_cf7_object filter to get the WPCF7_ContactForm object instead of markup
  •   ~10KB footprint — genuinely lightweight
  •   Compatible with WordPress 6.0+, CF7 5.9+, ACF 5/6

 

Where the Free Version Stops

The free version does not support:

  • Gutenberg blocks: The CF7 field type does not work inside ACF blocks built with acf_register_block_type()
  • WordPress widgets: No support for classic widgets or widget blocks in FSE themes
  • Theme Customizer: Form selection inside a Customizer panel is not available
  • Disable Forms: No way to hide individual forms from the dropdown

Those four gaps are specifically where Pro picks up.

 

What Pro Adds on Top

The Pro version (v2.0) is available at KrishaStore for $19.99 — a one-time payment. It adds four capabilities the free version does not cover.

>> Buy ACF Field for CF7 Pro — $19.99  

Gutenberg Block Support: Full CF7 field support inside custom ACF blocks. The render callback, block editor preview, and field panel all work without extra developer work after the initial build.

Widget Support: Classic widgets and FSE widget blocks both work with the Pro CF7 field. Sidebar forms, footer widgets, and custom widget areas are handled.

Theme Customizer Integration: The CF7 field works inside Customizer panels with live preview support. Form changes update in real time before publishing.

Disable Forms: Mark individual CF7 forms as disabled. They disappear from the dropdown but stay in the database. Existing assignments are not affected. 

 

ACF Field for CF7 Free vs Pro: Side by Side

FeatureFree (v1.8.1)Pro (v2.0)
CF7 field type in ACFYesYes
Works on post types, pages, options pagesYesYes
Works inside Repeater, Flexible Content, GroupsYesYes
Rendered markup from get_field() (no do_shortcode)YesYes
Allow Null toggleYesYes
acf_cf7_object filter for form objectYesYes
PHP 8.1 strict typesYesYes
Gutenberg block support (ACF blocks)NoYes
WordPress widget supportNoYes
Theme Customizer integrationNoYes
Disable Forms optionNoYes
PriceFree$19.99
Where to get itwordpress.orgstore.krishaweb.com

 

Who Should Buy the Pro Version

The free version is the right starting point for PHP-template-based builds. Upgrade to Pro when the project needs any of these:

  •   ACF blocks in Gutenberg: the free version does not support this context
  •   Forms in widget areas: sidebars, footer zones, FSE widget blocks
  •   Theme Customizer settings: global contact forms in Customizer panels
  •   Many CF7 forms: Disable Forms keeps the dropdown clean
  •   Client handoffs: a cleaner dropdown means fewer support calls

At $19.99 one-time, it pays for itself on the first project where you would otherwise build a workaround.

Buy ACF Field for CF7 Pro — $19.99   

 

Upgrading From an Older Version

If you are on v1.7 or earlier, check two things before updating on a live site:

  • ACF version: ACF 3 and 4 are no longer supported. Upgrade ACF first if you are on either.
  • do_shortcode() in templates: No longer needed from v1.8 onwards. It will not break if you leave it, but it is now redundant.

 

Frequently Asked Questions

Does the free version work with Gutenberg?

The free version works in PHP templates. For native ACF block support inside the Gutenberg block editor, you need the Pro version. The wordpress.org plugin description is explicit about this—it is one of the four features listed as Pro-only.

I was using do_shortcode() in my templates. Do I still need it after updating to v1.8?

No. The format_value() addition in v1.8 means get_field() now returns properly rendered form markup without any additional shortcode processing. Remove the do_shortcode() wrapper. Your templates will be cleaner for it.

What happens to existing form assignments if I disable a form in Pro?

Nothing. Disabling a form removes it from the dropdown for future selections. Any page, post, or widget that was already using that form continues to render it. The disabled option is editorial—it prevents new assignments, it does not change existing ones.

Does Pro require ACF Pro, or will ACF free work?

The Pro version requires ACF Pro. The free plugin works with both ACF free and ACF Pro. If you are considering buying the Pro version and you are currently on ACF free, you will need ACF Pro as well — that is an additional cost to factor in.

Is the $19.99 a one-time payment or a subscription?

One-time payment. There is no recurring subscription on the store.krishaweb.com product page. You pay once and own the plugin. 

Can I use both the free and Pro versions on the same site?

No. You install one or the other. The Pro version includes everything the free version does, plus the additional features. Deactivate and remove the free version before installing Pro.

 

Conclusion

Version 1.8.1 is the most solid the free plugin has been since its initial release. It handles PHP-template-based CF7 and ACF builds cleanly.

If your projects move into Gutenberg blocks, widget areas, or Customizer settings, the free version has a hard stop. Pro at $19.99 removes those limits. For any project where you would otherwise build a workaround, it pays for itself.

Buy ACF Field for CF7 Pro — $19.99