Omega Image Engine — Troubleshooting Guide

Omega Web Apps High‑Stability Image Optimization Engine omegawebapps.com

This guide covers common issues and safe recovery steps when using Omega Image Engine on production WordPress sites.

5. Troubleshooting

5.1 Images Not Optimizing

If newly uploaded images are not optimized:

• Ensure Omega Image Engine is active
• Upload a fresh image (existing images are not retro‑optimized)
• Check file permissions in /wp-content/uploads/
• Clear plugin, server, and CDN caches

5.2 WebP Not Being Delivered

If WebP versions exist but are not being served:

• Clear all caches (plugin, server, CDN)
• Ensure your CDN is not rewriting image URLs
• Check that your theme uses wp_get_attachment_image() or standard WordPress functions

5.3 Broken Images After Activation

This usually indicates a conflict with another image plugin.

• Deactivate all other image optimization plugins
• Clear all caches
• Reload the page and inspect image URLs

5.4 WooCommerce Images Not Updating

If product images appear unchanged:

• Regenerate WooCommerce thumbnails
• Clear all caches
• Ensure no other plugin is modifying product images

5.5 Layout Shifts or Distorted Images

Check the following:

• Your theme is not forcing custom image dimensions
• No CSS is stretching or compressing images
• All responsive image sizes exist in /uploads/

5.6 Slow Image Loading

Possible causes:

• Large unoptimized hero images
• CDN caching disabled
• Lazy‑loading conflicts

Fix:

• Re‑upload large images to trigger optimization
• Enable CDN caching
• Disable duplicate lazy‑loading plugins

5.7 WebP Missing for Some Images

Some formats cannot be converted:

• SVG
• Animated GIF
• Corrupted uploads

For all other formats, re‑upload the image to regenerate WebP.

5.8 Multisite Issues

If using WordPress Multisite:

• Ensure the plugin is network‑activated
• Check each site’s upload directory permissions
• Clear network‑level caching

5.9 Theme Output Conflicts

Some themes override WordPress image handling.

Fix:

• Disable theme image optimization modules
• Ensure the theme uses standard WordPress image functions

5.10 Safe Rollback

To instantly revert to your previous image behavior:

Deactivate the plugin.