Troubleshooting

This page lists some common issues that people often see and the corresponding solutions. If you find any bug not listed here, please let us know.

Shortcodes not working

Sometimes, you have a shortcode in the post content or your page executes a special shortcode from a plugin like WooCommerce or EDD Invoices, and you see a blank page or the shortcode doesn't work at all.

The root cause might be that Slim SEO already parses the shortcodes when it tries to auto generate meta description. If the shortcode has something related to session, custom logic, etc., then it might not work as expected.

To fix this problem, you need to tell Slim SEO to skip processing the shortcodes.

Assuming you have the following shortcode in your post content:

[my_shortcode id="value" title="my custom title"]

Then to tell Slim SEO to skip it, add the following snippet in your theme's functions.php file:

add_filter( 'slim_seo_skipped_shortcodes', function( $shortcodes ) {
    $shortcodes[] = 'my_shortcode';
    return $shortcodes;
} );

Note that you need to add the shortcode name only, not the full shortcode text with its attributes.

If you want to skip multiple shortcodes, use the following snippet:

add_filter( 'slim_seo_skipped_shortcodes', function( $shortcodes ) {
    $shortcodes[] = 'my_shortcode';
    $shortcodes[] = 'another_shortcode';
    return $shortcodes;
} );

Blocks not working

Similar to shortcodes, some blocks might not working properly. To fix this problem, use the following snippet:

add_filter( 'slim_seo_skipped_blocks', function( $blocks ) {
    $blocks[] = 'namespace/your-block-name';

    // Another block.
    $blocks[] = 'namespace/your-2nd-block-name';

    return $blocks;
} );