ACF Content Analysis for Yoast SEO


This plugin ensures that Yoast SEO analyzes all ACF content including Flexible Content and Repeaters.

Yoast SEO for WordPress content and SEO analysis does not take in to account the content of a post’s Advanced Custom Fields. This plugin uses the plugin system of Yoast SEO for WordPress to hook into the analyser in order to add ACF content to the SEO analysis.

This had previously been done by the WordPress SEO ACF Content Analysis plugin but that no longer works with Yoast 3.0. Kudos to ryuheixys, the author of that plugin, for the original idea.

This Plugin is compatible with the free ACF 4 Version as well as with the PRO Version 5. Please be aware that it ignores Pro Add-Ons for Version 4. In that case please upgrade to ACF PRO Version 5.

If you have issues, please submit them on GitHub

Previously called Yoast ACF Analysis.


Remove specific field from scoring

add_filter( 'Yoast\WP\ACF\blacklist_name', function ( $blacklist_name ) {
    $blacklist_name->add( 'my-field-name' );
    return $blacklist_name;

Remove field type from scoring

add_filter( 'Yoast\WP\ACF\blacklist_type', function ( $blacklist_type ) {
    // text, image etc
    $blacklist_type->add( 'text' );
    $blacklist_type->add( 'image' );
    return $blacklist_type;

Define custom field a specific heading value

add_filter( 'Yoast\WP\ACF\headlines', function ( $headlines ) {
    // value from 1-6, 1=h1, 6=h6
    $headlines['field_591eb45f2be86'] = 3;
    return $headlines;

Change refresh rate

add_filter( 'Yoast\WP\ACF\refresh_rate', function () {
    // Refresh rates in milliseconds
    return 1000;


2023年5月30日 1 reply
I have finished the Korean translation.I just want to say thank you for developing such a good plugin.And I hope it will be translated into more languages so that many WordPress users can use it conveniently.ACF Content Analysis for Yoast SEO 한국어 번역을 모두 마쳤습니다.좋은 플러그인을 개발해 주어서 고맙다는 인사를 전하고 싶습니다.그리고 보다 많은 언어로 번역되어 많은 워드프레스 사용자들이 편리하게 사용할 수 있기를 바랍니다.
The docs for this plugin say there is a box in the search appearance tab where you can add 'Custom fields to include in page analysis' but that box is no longer included in the plugin. I've installed it on three sites now, including one with no other plugins installed other than Yoast, so it doesn't look like a compatibility issue. No answers on the plugin support page and Yoast will only look into issues for premium subscribers unfortunately. Very frustrating.


“ACF Content Analysis for Yoast SEO” 是一個開源的軟體。以下的人對這個外掛作出了貢獻。


ACF Content Analysis for Yoast SEO 外掛目前已有 19 個本地化語言版本。 感謝所有譯者為這個外掛做出的貢獻。

將 ACF Content Analysis for Yoast SEO 外掛本地化為台灣繁體中文版。


任何人均可瀏覽程式碼、查看 SVN 存放庫,或透過 RSS 訂閱開發記錄



Released May 23rd, 2023


  • Improves the analysis by excluding content from the URL and email fields.


  • Fixes a bug where the content in ACF fields was not included in the analysis in Classic editor when WordProof plugin was activated.


  • Sets the minimum required Yoast SEO version to 20.8.
  • Sets the minimum required ACF version to 6.0.0.
  • Sets the minimum supported WordPress version to 6.1 and “Tested up to” to 6.2.
  • Drops compatibility with PHP 5.6, 7.0 and 7.1.


Released December 10th, 2020


  • Fixes a bug where ACF Analysis would fail on term pages when using WordPress 5.6.


Released September 29th, 2020


  • Fixes a bug where the content of ACF fields wouldn’t be included in the SEO and readability analysis when using the Classic Editor plugin.
  • Fixes a bug where changes to the content of ACF fields wouldn’t trigger a live refresh of the SEO and readability analysis.


  • No longer supports ACF versions below 5.7.


Released September 1st, 2020


  • Compatibility with Yoast SEO 14.9.


Released August 4th, 2020


  • Fixes a bug where the content of ACF blocks in ‘auto’ mode was not taken into account when the block (automatically) switched to preview mode. Props to TimVevida.


Released July 21st, 2020


  • Makes the plugin compatible with JavaScript changes introduced in Yoast SEO 14.6. We used to depend on JavaScript files which aren’t there anymore. We now depend on post-edit.js or term-edit.js.
  • Sets the minimum supported Yoast SEO version to 14.6.


Released June 10th, 2020


  • Fixes a bug where an error would be thrown when using the Classic Editor plugin.
  • Fixes a bug where custom fields were no longer analyzed when using the Classic Editor plugin.


Released June 4th, 2020


  • Add support for ACF blocks. Props to TimVevida.


  • Fixes a couple of typos in the code documentation. Props to akkspros.
  • Deprecates Yoast_ACF_Analysis_Facade::get_filter_name(). Use hard-coded hook names instead.
  • Deprecates the yoast-acf-analysis/configfilter hook in favor of theYoast\WP\ACF\config` hook.
  • Deprecates the yoast-acf-analysis/headlines filter hook in favor of the Yoast\WP\ACF\headlines hook.
  • Deprecates the yoast-acf-analysis/blacklist_type filter hook in favor of the Yoast\WP\ACF\blacklist_type hook.
  • Deprecates the yoast-acf-analysis/blacklist_name filter hook in favor of the Yoast\WP\ACF\blacklist_name hook.
  • Deprecates the yoast-acf-analysis/scraper_config filter hook in favor of the Yoast\WP\ACF\scraper_config hook.
  • Deprecates the yoast-acf-analysis/refresh_rate filter hook in favor of the Yoast\WP\ACF\refresh_rate hook.
  • Deprecates the yoast-acf-analysis/field_selectors filter hook in favor of the Yoast\WP\ACF\field_selectors hook.
  • Deprecates the yoast-acf-analysis/field_order filter hook in favor of the Yoast\WP\ACF\field_order hook.


Released May 15th, 2019


  • ACF URL fields are now analyzed as links. Props to t49tran.


Released January 22nd, 2019


  • Fixes a bug where textarea and non-headline text content would not be wrapped in paragraphs for the analysis. Props skaeser.


  • Introduces the ‘yoast-acf-analysis/field_order’ filter which allows for adjusting the ACF field order. This also adds the possibility to prepend field content to WordPress’ post_content using a negative field order. Props skaeser.


Released July 10th, 2018

* Fixes a bug where attempting to get the ACF version, wouldn’t always be reliable. This would lead the plugin to think that a newer version was installed than what was actually present.
* Fixes potential conflicts with other plugins due to generic variable naming.
* Fixes a bug where the YoastSEO ACF Content analysis would attempted to be loaded, although it wasn’t available.

* Adds filter examples to the readme.


Released October 19th, 2017

* Fixes the mismatch in textdomain according to the plugin slug.
* Fixes using an incorrect path when loading plugin data.
* Fixes a bug with flexible content and repeaters, in combination with ACF 5, causing JavaScript errors.
* Fixes a bug with short array notation which is a problem on sites running on PHP 5.3 or lower.
* Fixes a bug where assets are loaded without checking for required dependencies.


Released August 22th, 2017

* Complete rewrite, including full support for ACF 4 and 5.


Released July 24th, 2017

* Fixes Yoast SEO Premium social sharing tabs not showing any content when this plugin is active, props Matt McAchran.


Released June 30th, 2016

  • Bugfixes:

    • Fixes an incompatibility issue with Yoast SEO version 3.2+ where the assets are registered with a new prefix.
  • Internationalization:

    • Improved text in notifications when dependencies are missing.