Title: ACF Content Analysis for Yoast SEO
Author: Yoast
Published: <strong>December 17, 2015</strong>
Last modified: May 18, 2026

---

Search plugins

![](https://ps.w.org/acf-content-analysis-for-yoast-seo/assets/banner-772x250.png?
rev=1717503)

![](https://ps.w.org/acf-content-analysis-for-yoast-seo/assets/icon-256x256.png?
rev=1717503)

# ACF Content Analysis for Yoast SEO

 By [Yoast](https://profiles.wordpress.org/yoast/)

[Download](https://downloads.wordpress.org/plugin/acf-content-analysis-for-yoast-seo.3.2.zip)

 * [Details](https://wordpress.org/plugins/acf-content-analysis-for-yoast-seo/#description)
 * [Reviews](https://wordpress.org/plugins/acf-content-analysis-for-yoast-seo/#reviews)
 * [Development](https://wordpress.org/plugins/acf-content-analysis-for-yoast-seo/#developers)

 [Support](https://wordpress.org/support/plugin/acf-content-analysis-for-yoast-seo/)

## Description

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

[Yoast SEO for WordPress](https://yoast.com/wordpress/plugins/) content and SEO 
analysis does not take in to account the content of a post’s [Advanced Custom Fields](http://www.advancedcustomfields.com/).
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](https://wordpress.org/plugins/wp-seo-acf-content-analysis/)
plugin but that no longer works with Yoast 3.0. Kudos to [ryuheixys](https://profiles.wordpress.org/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](https://github.com/Yoast/yoast-acf-analysis/issues)

Previously called Yoast ACF Analysis.

### Filters

#### 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;
    });
    ```

## Reviews

![](https://secure.gravatar.com/avatar/24e6ce434fd4171ae522cd22d710505c4ab1013a537376d4ce1dff45a7f2fae2?
s=60&d=retro&r=g)

### 󠀁[Should be integrated into Yoast](https://wordpress.org/support/topic/should-be-integrated-into-yoast/)󠁿

 [Toine Rademacher](https://profiles.wordpress.org/toineenzo/) January 9, 2025

Nice little plugin for better integration with ACF. But this should really be integrated
into the main Yoast SEO plugin! Has this every been discussed?

![](https://secure.gravatar.com/avatar/5229047c5dbb1b405f3be34e430240b7b0404eeb9d4c78779a5186b89832beab?
s=60&d=retro&r=g)

### 󠀁[the plugin does not work](https://wordpress.org/support/topic/the-plugin-does-not-work-67/)󠁿

 [izzik fayzak](https://profiles.wordpress.org/fayzak/) April 14, 2023

I installed the plugin does not work with Yoast. The new fields I added in the acf
extension do not appear in Yoast.

![](https://secure.gravatar.com/avatar/14876e11896707f15e434351972458d9038162feb07f121b25caeab48eababc6?
s=60&d=retro&r=g)

### 󠀁[Ability to add custom fields no longer working](https://wordpress.org/support/topic/ability-to-add-custom-fields-no-longer-working/)󠁿

 [jonoces](https://profiles.wordpress.org/jonoces/) September 1, 2022

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.

![](https://secure.gravatar.com/avatar/ad243f5b4d92b9dac132c49b3c0ecba51601870c19205bef4f4eb3af60d4d27c?
s=60&d=retro&r=g)

### 󠀁[Very satisfied](https://wordpress.org/support/topic/very-satisfied-138/)󠁿

 [umizen40](https://profiles.wordpress.org/umizen40/) April 24, 2022

Thanks a lot for this very good plugin !

![](https://secure.gravatar.com/avatar/f536e81cfaf2fb070e5fc43025a23545ffa65c24e558d4edb0155a86869a78f7?
s=60&d=retro&r=g)

### 󠀁[Since Update 5.5.1, and Yoast 14.9 – No longer works!](https://wordpress.org/support/topic/since-update-5-5-1-and-yoast-14-9-no-longer-works/)󠁿

 [squire2k](https://profiles.wordpress.org/squire2k/) September 24, 2020

Help! This no longer appears to work – we are using WP V 5.5.1, and Yoast 14.9, 
And ACF Pro 5.9.1… all the latest.. just doesn’t seem to pick up things like content
length and outbound links etc

![](https://secure.gravatar.com/avatar/44c44ecf298f2a43c15ba12f66a1dea2e60f91b6fa221bf7bfd8376c9f78f696?
s=60&d=retro&r=g)

### 󠀁[Was perfect, WP update broke it with no bug fix](https://wordpress.org/support/topic/was-perfect-wp-update-broke-it-with-no-bug-fix/)󠁿

 [webtailor](https://profiles.wordpress.org/webtailor/) September 2, 2020 2 replies

Since a while now (WP 5.5 update), this plugin doesn’t work anymore. Word count 
stays on 0 for all pages and post types.

 [ Read all 34 reviews ](https://wordpress.org/support/plugin/acf-content-analysis-for-yoast-seo/reviews/)

## Contributors & Developers

“ACF Content Analysis for Yoast SEO” is open source software. The following people
have contributed to this plugin.

Contributors

 *   [ Yoast ](https://profiles.wordpress.org/yoast/)
 *   [ Angry Creative ](https://profiles.wordpress.org/angrycreative/)
 *   [ Thomas Kräftner ](https://profiles.wordpress.org/kraftner/)
 *   [ Marcus Forsberg ](https://profiles.wordpress.org/marcusforsberg/)
 *   [ Viktor Fröberg ](https://profiles.wordpress.org/viktorfroberg/)
 *   [ Joost de Valk ](https://profiles.wordpress.org/joostdevalk/)
 *   [ Anton Timmermans ](https://profiles.wordpress.org/atimmer/)
 *   [ Jip Moors ](https://profiles.wordpress.org/jipmoors/)
 *   [ Richard Sweeney ](https://profiles.wordpress.org/theorboman/)

“ACF Content Analysis for Yoast SEO” has been translated into 22 locales. Thank 
you to [the translators](https://translate.wordpress.org/projects/wp-plugins/acf-content-analysis-for-yoast-seo/contributors)
for their contributions.

[Translate “ACF Content Analysis for Yoast SEO” into your language.](https://translate.wordpress.org/projects/wp-plugins/acf-content-analysis-for-yoast-seo)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/acf-content-analysis-for-yoast-seo/),
check out the [SVN repository](https://plugins.svn.wordpress.org/acf-content-analysis-for-yoast-seo/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/acf-content-analysis-for-yoast-seo/)
by [RSS](https://plugins.trac.wordpress.org/log/acf-content-analysis-for-yoast-seo/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 3.2

Released March 4th, 2025

Bugfixes:

 * Fixes a bug where browser performance was degraded by useless AJAX calls with
   an image or gallery field. Props to [mmorris8](https://github.com/mmorris8).

Other:

 * Sets the minimum required Yoast SEO version to 24.6.
 * Sets the minimum supported WordPress version to 6.6.
 * Improves discoverability of security policy
 * The plugin has no known incompatibilities with PHP 8.3.
 * Users requiring this package via [WP]Packagist can now use the `composer/installers`
   v2.

#### 3.1

Released May 23rd, 2023

Enhancements:

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

Bugfixes:

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

Other:

 * 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.

#### 3.0.1

Released December 10th, 2020

Bugfixes:

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

#### 3.0.0

Released September 29th, 2020

Bugfixes:

 * 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.

Other:

 * No longer supports ACF versions below 5.7.

#### 2.7.0

Released September 1st, 2020

Other:

 * Compatibility with Yoast SEO 14.9.

#### 2.6.0

Released August 4th, 2020

Bugfixes:

 * 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](https://github.com/TimVevida).

#### 2.5.0

Released July 21st, 2020

Other:

 * 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.

#### 2.4.1

Released June 10th, 2020

Bugfixes:

 * 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.

#### 2.4.0

Released June 4th, 2020

Enhancements:

 * Add support for ACF blocks. Props to [TimVevida](https://github.com/TimVevida).

Other:

 * Fixes a couple of typos in the code documentation. Props to [akkspros](https://github.com/akkspros).
 * Deprecates `Yoast_ACF_Analysis_Facade::get_filter_name()`. Use hard-coded hook
   names instead.
 * Deprecates the yoast-acf-analysis/config`filter hook in favor of the`Yoast\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.

#### 2.3.0

Released May 15th, 2019

Enhancements:

 * ACF URL fields are now analyzed as links. Props to [t49tran](https://github.com/t49tran).

#### 2.2.0

Released January 22nd, 2019

Bugfixes:

 * Fixes a bug where textarea and non-headline text content would not be wrapped
   in paragraphs for the analysis. Props [skaeser](https://github.com/skaeser).

Enhancements:

 * 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](https://github.com/skaeser).

#### 2.1.0

Released July 10th, 2018

Bugfixes:
 * 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.

Other:
 * Adds filter examples to the readme.

#### 2.0.1

Released October 19th, 2017

Bugfixes:
 * 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.

#### 2.0.0

Released August 22th, 2017

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

#### 1.2.1

Released July 24th, 2017

Bugfixes:
 * Fixes Yoast SEO Premium social sharing tabs not showing any content
when this plugin is active, props [Matt McAchran](https://github.com/mmcachran).

#### 1.2.0

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.

## Meta

 *  Version **3.2**
 *  Last updated **4 weeks ago**
 *  Active installations **100,000+**
 *  WordPress version ** 6.6 or higher **
 *  Tested up to **7.0**
 *  PHP version ** 7.2.5 or higher **
 *  Languages
 * [Catalan](https://ca.wordpress.org/plugins/acf-content-analysis-for-yoast-seo/),
   [Dutch](https://nl.wordpress.org/plugins/acf-content-analysis-for-yoast-seo/),
   [Dutch (Belgium)](https://nl-be.wordpress.org/plugins/acf-content-analysis-for-yoast-seo/),
   [English (Canada)](https://en-ca.wordpress.org/plugins/acf-content-analysis-for-yoast-seo/),
   [English (South Africa)](https://en-za.wordpress.org/plugins/acf-content-analysis-for-yoast-seo/),
   [English (UK)](https://en-gb.wordpress.org/plugins/acf-content-analysis-for-yoast-seo/),
   [English (US)](https://wordpress.org/plugins/acf-content-analysis-for-yoast-seo/),
   [French (Canada)](https://fr-ca.wordpress.org/plugins/acf-content-analysis-for-yoast-seo/),
   [French (France)](https://fr.wordpress.org/plugins/acf-content-analysis-for-yoast-seo/),
   [Galician](https://gl.wordpress.org/plugins/acf-content-analysis-for-yoast-seo/),
   [German](https://de.wordpress.org/plugins/acf-content-analysis-for-yoast-seo/),
   [Korean](https://ko.wordpress.org/plugins/acf-content-analysis-for-yoast-seo/),
   [Lithuanian](https://lt.wordpress.org/plugins/acf-content-analysis-for-yoast-seo/),
   [Marathi](https://mr.wordpress.org/plugins/acf-content-analysis-for-yoast-seo/),
   [Persian](https://fa.wordpress.org/plugins/acf-content-analysis-for-yoast-seo/),
   [Portuguese (Portugal)](https://pt.wordpress.org/plugins/acf-content-analysis-for-yoast-seo/),
   [Russian](https://ru.wordpress.org/plugins/acf-content-analysis-for-yoast-seo/),
   [Serbian](https://sr.wordpress.org/plugins/acf-content-analysis-for-yoast-seo/),
   [Spanish (Chile)](https://cl.wordpress.org/plugins/acf-content-analysis-for-yoast-seo/),
   [Spanish (Colombia)](https://es-co.wordpress.org/plugins/acf-content-analysis-for-yoast-seo/),
   [Spanish (Spain)](https://es.wordpress.org/plugins/acf-content-analysis-for-yoast-seo/),
   [Spanish (Venezuela)](https://ve.wordpress.org/plugins/acf-content-analysis-for-yoast-seo/),
   and [Swedish](https://sv.wordpress.org/plugins/acf-content-analysis-for-yoast-seo/).
 *  [Translate into your language](https://translate.wordpress.org/projects/wp-plugins/acf-content-analysis-for-yoast-seo)
 * Tags
 * [acf](https://wordpress.org/plugins/tags/acf/)[advanced custom fields](https://wordpress.org/plugins/tags/advanced-custom-fields/)
   [analysis](https://wordpress.org/plugins/tags/analysis/)[seo](https://wordpress.org/plugins/tags/seo/)
   [Yoast](https://wordpress.org/plugins/tags/yoast/)
 *  [Advanced View](https://wordpress.org/plugins/acf-content-analysis-for-yoast-seo/advanced/)

## Ratings

 4.2 out of 5 stars.

 *  [  25 5-star reviews     ](https://wordpress.org/support/plugin/acf-content-analysis-for-yoast-seo/reviews/?filter=5)
 *  [  1 4-star review     ](https://wordpress.org/support/plugin/acf-content-analysis-for-yoast-seo/reviews/?filter=4)
 *  [  2 3-star reviews     ](https://wordpress.org/support/plugin/acf-content-analysis-for-yoast-seo/reviews/?filter=3)
 *  [  1 2-star review     ](https://wordpress.org/support/plugin/acf-content-analysis-for-yoast-seo/reviews/?filter=2)
 *  [  5 1-star reviews     ](https://wordpress.org/support/plugin/acf-content-analysis-for-yoast-seo/reviews/?filter=1)

[Your review](https://wordpress.org/support/plugin/acf-content-analysis-for-yoast-seo/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/acf-content-analysis-for-yoast-seo/reviews/)

## Contributors

 *   [ Yoast ](https://profiles.wordpress.org/yoast/)
 *   [ Angry Creative ](https://profiles.wordpress.org/angrycreative/)
 *   [ Thomas Kräftner ](https://profiles.wordpress.org/kraftner/)
 *   [ Marcus Forsberg ](https://profiles.wordpress.org/marcusforsberg/)
 *   [ Viktor Fröberg ](https://profiles.wordpress.org/viktorfroberg/)
 *   [ Joost de Valk ](https://profiles.wordpress.org/joostdevalk/)
 *   [ Anton Timmermans ](https://profiles.wordpress.org/atimmer/)
 *   [ Jip Moors ](https://profiles.wordpress.org/jipmoors/)
 *   [ Richard Sweeney ](https://profiles.wordpress.org/theorboman/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/acf-content-analysis-for-yoast-seo/)