README

Only loads Contact Form 7 scripts and styles on pages that actually contain a form. Zero configuration.

Fixes Contact Form 7 #1278 — CF7 enqueues its JS, CSS, reCAPTCHA, Turnstile, and Stripe scripts on every single page, even pages with no form. This plugin detects whether the current page has a CF7 form and dequeues all CF7 assets when no form is present.

Author: Renzo Johnson

Requirements

• PHP 8.4+
• WordPress 6.4+
• Contact Form 7 5.0+

Installation

Via Composer

composer require renzojohnson/cf7-asset-optimizer

Manual

Download and upload to /wp-content/plugins/cf7-asset-optimizer/, then activate.

As mu-plugin

Copy cf7-asset-optimizer.php to /wp-content/mu-plugins/.

How It Works

The plugin hooks into CF7's own wpcf7_load_js and wpcf7_load_css filters to conditionally disable asset loading. On pages without a form, it also dequeues module scripts (reCAPTCHA, Turnstile, Stripe, SWV).

Detection

The plugin checks for CF7 forms in:

• [contact-form-7] shortcode in post content
• [contact-form] shortcode (legacy alias)
• contact-form-7/contact-form-selector Gutenberg block
• CF7 widgets in sidebar areas
• CF7 shortcodes inside text widgets
• CF7 blocks inside block widgets

Assets Dequeued

When no form is detected, these handles are dequeued:

Edge Cases

For forms rendered via PHP templates or dynamic shortcodes not in post content:

// Force-load CF7 assets on specific pages
add_filter('cf7ao_has_form', function (?bool $has_form): ?bool {
    if (is_page('custom-form-page')) {
        return true;
    }
    return $has_form;
});

Testing

composer install
vendor/bin/phpunit

Related Project

If you use Contact Form 7 with Mailchimp, check out Chimpmatic — a CF7-to-Mailchimp integration plugin with 50,000+ active installations. Supports merge field mapping, subscriber tags, groups, double opt-in, and GDPR consent. Built by the same developer.

• Chimpmatic — Connect Contact Form 7 to Mailchimp
• How to Get Your Mailchimp API Key

Links

• Packagist
• GitHub
• Issues
• CF7 Issue #1278
• Author

License

MIT License. Copyright (c) 2026 Renzo Johnson.