Known conflicts, issues and workarounds #
Please take a look at this article to know more about this.
General issues #
If you installed ShortPixel Adaptive Images (SPAI) on your website and, after checking if it's working well, it doesn't seem to do it, then the usual reasons are:
- Your domain is not associated to your account: How can I associate a domain to my account?
- You don’t have enough available optimization credits. If this is the case, please purchase a new plan.
- The API URL is not correct. It is located on Settings > ShortPixel AI > Behaviour and by default it should be “https://cdn.shortpixel.ai/spai” (see image below); only change it if you know what you’re doing.
- You use a caching plugin or your hosting provider uses a caching mechanism, and the cache has not been flushed after installing and configuring SPAI. The solution is to flush your cache to get rid of old image URLs being displayed. To do a proper cache clearing, please read this article: How to clear WordPress cache
- There is another plugin or theme that has a lazy loading feature activated and this conflicts with SPAI. The solution is to deactivate this functionality on the plugin or theme that use it. Please notice that you don’t need to disable lazy loading on videos or other resources; only image lazy loading must be disabled.
- Your images are already being delivered as WebP. Please deactivate any other WebP delivering method that is not provided by ShortPixel Adaptive Images.
- SPAI’s JavaScript files are blocked or unregistered with another optimization plugin. For example, Asset CleanUp can stop such Javascript files if you tell it to do so. Please check all the optimization plugins to make sure that they don’t block anything related to SPAI.
- jQuery has been disabled either manually or by another plugin. In this case, SPAI will not work properly. Please make sure jQuery is enabled.
- Your hosting provider is SiteGround and you are working on a staging site. The way SiteGround creates staging sites is a little bit different: they are using a filter to replace the domain names in the URLs. Please ignore any malfunction in this case, as the live site will probably work correctly.
- There is a conflict with another plugin or theme.
#
Only some images are not optimized #
Sometimes SPAI is actually working correctly, but not all the images are being served from our CDN. This can happen because:
- The images are background images ("background-image" CSS property) declared in .css files. Please activate the "Replace in CSS files" option.
- The piece of content containing that image is built dynamically by Javascript (either the theme's or from a plugin). Please activate first the "Replace in JSON data" option (located on Settings > ShortPixel AI > Areas), and if there still are images not optimized, activate the "Replace in the JS blocks" option too. If neither of these solve all the cases, it might be that the dynamical part is built by a different means and we might need to code a custom integration for this situation. Please contact us to check if this is possible in your case.