acf/schema/debug

Enable debug HTML comments showing JSON-LD processing steps.
Description
This filter enables debug mode for JSON-LD output. When enabled, ACF outputs HTML comments showing each step of the JSON-LD processing, including which post types are checked, which fields are found, and why output may be skipped.
This is useful for troubleshooting when JSON-LD is not appearing as expected.
Changelog
Added in version 6.8.0
Parameters
apply_filters( 'acf/schema/debug', $debug );
$debug (bool) Whether to output debug comments. Default: 
false
Return
(bool) Whether debug mode is enabled.
Example
This example enables debug mode.
add_filter( 'acf/schema/debug', '__return_true' );
This example enables debug mode only for administrators.
/**
 * Enable JSON-LD debug mode for admins only.
 *
 * @param bool $debug Whether debug mode is enabled.
 * @return bool Modified debug setting.
 */
function my_acf_schema_debug_for_admins( $debug ) {
    if ( current_user_can( 'manage_options' ) ) {
        return true;
    }
    return $debug;
}
add_filter( 'acf/schema/debug', 'my_acf_schema_debug_for_admins' );
Debug Output
When enabled, you’ll see HTML comments like:
<!-- ACF AI JSON-LD: Checking post type: recipe -->
<!-- ACF AI JSON-LD: Found 8 ACF fields -->
<!-- ACF AI JSON-LD: Processing field 'prep_time' with schema_property 'prepTime' -->
Or when output is skipped:
<!-- ACF AI JSON-LD: Post type 'post' does not have JSON-LD enabled -->