Known plugin and theme conflicts, issues and workarounds

In this article

LiteSpeed Cache

  • Exclude ai.min.js and ai-2.0.min.js from being combined (thanks to Mads).

  • If the previous doesn't work, turn off "JS Combine".

JetPack

  • Go to Jetpack > Settings > Performance and disable the option "Enable site accelerator" and "Enable Lazy Loading for images".

Hummingbird

  • Go to Hummingbird > Asset Optimization > Assets > Configuration > Exclusions, and exclude the files ai.min.js and ai-2.0.min.js .

  • In some cases, the previous instructions won't be enough. We have observed that the Hummingbird plugin will sometimes disable jQuery. To prevent issues with this, please go to Settings > ShortPixel AI > Behaviour and enable "New AI engine".

Autoptimize

  • You need to have "Optimize Images" and "Lazy-load images" turned off. They are located on Settings > Autoptimize > Images.

  • If you have the option "Aggregate JS-files" enabled, you may need to exclude the script ai.min.js and/or ai-2.0.min.js from optimization to prevent possible conflicts.

WP Rocket

  • Do not add the ShortPixel API URL to WP Rocket's CDN section.
  • Do not activate the "WebP Compatibility" add-on. If you'd like to use WebP, please do it from ShortPixel Adaptive Images' options.
  • You must deactivate lazy loading for images. Go to Settings > WP Rocket > Media > LazyLoad and disable "Enable for images".
  • If you combine your JS files using WP Rocket, you may need to exclude the file /wp-content/plugins/shortpixel-adaptive-images/assets/js/(.*).js  from being minified and combined (Settings > WP Rocket > File Optimization > JavaScript Files > Excluded JavaScript Files).
  • If the previous does not seem to work, try disabling the "Combine JavaScript files" option:

  • If you are using RocketCDN to serve your images files as well, then you should do one of the following:
    • Either associate your RocketCDN CNAME to your account (How can I associate a domain to my account?),
    • or simply don't serve images from RocketCDN. This method has the benefit of not having 2 CDNs (RocketCDN and SPAI) before your images
  • If you are using the option "Delay JavaScript execution", you will need to add the following lines in the "Excluded JavaScript Files" field:
    /jquery-?[0-9.](.*)(.min|.slim|.slim.min)?.js 
    /jquery-migrate(.min)?.js
    /shortpixel-adaptive-images/assets/js/ai(.*).min.js
    spai_settings
    https://cdn.shortpixel.ai/assets/js/
    	

Swift Performance

  • You will need to disable the option "Fix Invalid HTML" under Swift Performance > Settings > Optimization > HTML.

  • Some websites may have issues with the option "Merge Styles" under Swift Performance > Settings > Optimization > Styles. If you want it enabled, feel free to try to do it, but please check thoroughly your site. If it breaks, then you should disable "Merge Styles".

  • If you are using ShortPixel Adaptive Images to deliver WebP, then you have to go to Settings > Swift Performance > Media > Images and set the option "Serve WebP" as "Don't use WebP".

SG Optimizer

  • Go to SG Optimizer > Media and disable every single setting there.

  • Also, to make sure that your images load as fast as possible, disable the option SG Optimizer > Frontend > JavaScript > Defer Render-blocking JS.

WP Fastest Cache

  • Make sure that "Lazy Load" and "Minify JS" are disabled from WP Fastest Cache's settings.

Perfmatters

  • Deactivate the Lazy Loading option in Perfmatters' settings to allow ShortPixel AI to work correctly. SPAI has already lazy loading integrated.

  • If you are using the option "Delay JavaScript", you need to exclude SPAI scripts. Please add the string spai to the box "Excluded from Delay".

Slider Revolution

  • Deactivate the Lazy Loading of your sliders by going to the slider settings.

W3 Total Cache

  • Deactivate the JS Minify settings. Go to Performance > Minify > JS and turn off the option "JS minify settings"

Oxygen

  • You will have to enable CSS Caching inside Oxygen's settings to get rid of the xlink=css files.

Asset CleanUp

  • Do not unload, async or defer any file from ShortPixel Adaptive Images. If you do so, the plugin will stop working as it should and you could have missing images or parts of the plugin not working as they should.

Divi, Extra or any other Elegant Themes theme

  • Disable the option "Defer jQuery And jQuery Migrate". It is located on your Theme Options, under the General > Performance menu.

Smash Balloon Instagram Feed

  • Go to Instagram Feed > Settings > Customize and enable the option "Disable JS Image Loading"

Cornerstone

  • This page builder has a quite complicated way of rendering the builder itself. That's why it's better to disable the option to optimize the images for logged-in users. Go to Settings > ShortPixel AI > Behavior and disable the option "Logged-in users"

Meow Gallery

  • You will need to disable its Optimization features as they conflict with SPAI. Go to Meow Apps > Gallery > Basics > Optimization and set the Image Size to "Full" and disable the option "Infinite & Lazy"

RoyalSlider

  • We've seen some themes (e.g. Impreza) that come bundled with this component. If you find yourself building a slider with it and you see that its image URLs are not being replaced with the ones pointing to cdn.shortpixel.ai, try adding the following snippet of code to your functions.php file:
    add_filter('shortpixel/ai/customRules', 'my_spai_custom_rules');
    function my_spai_custom_rules($regexItems) {
      $regexItems[] = new ShortPixel\AI\TagRule('a', 'href', 'rsImg', false, false, false, true);
      return $regexItems;
    }
    	

Breeze

  • You must disable the "Lazy Load Images" option

  • Be careful with the "JS Files With Deferred Loading" option. We have seen websites where adding certain files caused our plugin to not work properly. If you experience random issues, first try to remove all files from there.

Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.

Still need help? Contact Us Contact Us