✨ The Innovation Engine: Fueling Performance & Unstoppable Growth --- 🚦 Stop Guessing: Real User Monitoring for Magento 2 --- 🏆 Go For Gold: JaJuMa Is Hyvä Gold Partner --- 🚀 LCP Optimization - All You Need To Know --- 💡 Showcase: 60 Days On Hyvä - Project Rescue To Lightspeed ---
us
Jajuma Logo
user
Cart shopping-cart

Extensions by Category

Icon for Magento Extensions category All Extensions Icon for Hyvä Themes Extensions category Hyvä Theme Icon for Performance Optimization Extensions category Performance Optimization Icon for Power Toys Extensions category Power Toys Icon for Free Magento Extensions category Free

🤔 10. Troubleshooting, FAQ & Best Practices

This section provides answers to frequently asked questions, solutions to common problems, and best practices for getting the most out of the JaJuMa Ultimate Image Optimizer for Magento 2. If your question is not answered here, please feel free to contact our support team.

10.1 Frequently Asked Questions

Why aren't my images converting to WebP/AVIF?

This is the most common issue and usually relates to the setup process. Run through this checklist:

  1. Is the extension enabled?
    • Go to JaJuMa > Image Optimization Configuration > General and ensure Enable Image Optimization is set to Yes.
  2. Did you run the Media Scan?
    • The conversion process relies on the database built by the media scan.
      Go to JaJuMa > Image Optimization Status and click Scan Images to run it manually.
  3. Is the Optimization Cron running?
    • AVIF conversion is entirely cron-based. Ensure your main Magento cron jobs are configured and executing correctly on the server.
  4. Did you verify your server tools?
    • Go to General > Debug and use the Check Configuration button to validate that the extension can access the necessary conversion tools (like cwebp or cavif).
  5. Did you check the log files?
    • Look in the var/log/image-optimizer/ directory for specific error messages. See section 10.3 below for details.

AVIF conversion is very slow. Can I speed it up?

Yes, AVIF conversion is computationally intensive by design; this is the trade-off for its incredible compression. The speed is normal, but you can manage it:

  • Use the Right Tool: We recommend using the cavif conversion tool, which is bundled with the extension and offers a great balance of speed and quality.
  • Manage Server Resources: In the General > Optimization by Cron settings, use the Number of Threads and Server Load Limit options. These are essential safeguards to prevent the conversion process from slowing down your live site.
  • Be Patient: Especially on the first run with thousands of images, the process will take time. Let the cron jobs run, and the images will be converted in the background.

Which image conversion tool should I use?

For the best balance of speed, quality, and ease of setup, we recommend:

  • For WebP: Use cwebp. It's the official tool from Google and provides the best results.
  • For AVIF: Use cavif. It's bundled with the extension, making it easy to set up, and is very efficient.

For a full comparison, please see the Conversion Tool Comparison Table in the Performance Features guide.

What "Quality" setting should I use?

There is no single "perfect" value. A setting of 75 for WebP and 50–60 for AVIF is a good starting point. However, we strongly recommend using the built-in Test & Preview Conversion Tool (Performance > WebP/AVIF Conversion Configurations) to find the ideal balance of file size and visual quality for your specific products.

This table can be used as a general guideline for matching quality to a source JPEG:

JPEG quality AVIF quality WebP quality
50 48 55
60 51 64
70 56 72
80 64 82

Note: These numbers can only be rough guidelines. The result varies depending on conversion tool used.

Will this work with my CDN and Varnish/Full Page Cache?

Yes, the extension is 100% compatible with Full Page Caching (FPC), Varnish, and CDNs. Because it uses the HTML <picture> tag, the browser itself makes the final decision on which image format to download from the various options provided in the HTML. The cached HTML contains all options, making it universally compatible.

Is the extension compatible with Hyvä Themes?

Yes, it is fully compatible with Hyvä Themes out-of-the-box. We also provide a "Hyvä Theme Bonus Option" under Performance > Hyvä Theme Bonus Option to further improve performance on Hyvä sites.

🏆 10.2 Best Practices for Core Web Vitals

This extension is a powerful toolkit for directly addressing and improving Google's Core Web Vitals. This table connects a specific problem to the solution within the extension.

Core Web Vital Common Cause in Magento Extension Feature & Solution Configuration Path
LCP
(Largest Contentful Paint)		 A large, unoptimized "above-the-fold" hero image is slow to load because it's too big or is being lazy-loaded. 1. Next-Gen Formats: Automatically serve a much smaller AVIF or WebP file.
2. Lazy Loading Blacklist: Add the LCP image to this list to prevent it from being lazy-loaded.
3. High Priority Loading: Add the LCP image here to add fetchpriority="high", telling the browser to download it immediately.		 Performance > WebP/AVIF
Performance > Lazy Loading
CLS
(Cumulative Layout Shift)		 Images load without width and height attributes, so the browser doesn't know how much space to reserve, causing content to "jump". Add Width/Height In Img Tag: This feature is the direct solution. It automatically adds the dimensions to the <img> tag, completely eliminating this type of layout shift. Performance > Miscellaneous
INP
(Interaction to Next Paint)		 The browser's main thread is blocked by heavy tasks, making the page feel unresponsive to user clicks. Hyvä Theme Bonus Option: For Hyvä users, this option removes an Alpine component on category pages, which can reduce Total Blocking Time (TBT) and improve page interactivity. Performance > Hyvä Theme

Pro Tip: Looking for more tips and solutions to improve your Largest Contentful Paint (LCP)?.
Check our The Ultimate Guide To LCP Optimization for Luma + Hyvä

10.3 Understanding the Log Files

If you encounter persistent issues, the extension's log files are the best place to find detailed error messages.

  • Location: [magento_root]/var/log/image-optimizer/
  • Log Files:
    • scan-images.log: Records the progress and any issues encountered during the media scan process.
    • convert-images.log: Records errors that occur during the actual image conversion process.

💡 Pro Tip: Before contacting support, check these files for messages related to the images that are failing to convert. The error message will often point directly to the cause, such as a permissions issue, a corrupted source image, or a misconfigured server tool.

📞 Need Help?

We hope this guide has resolved your issue. If you still have questions or need personalized assistance, we're here to help.

Before Contacting Support

To help us resolve your issue as quickly as possible, please include the following information in your support request:

  • Your Order Number
  • Magento Version (e.g., 2.4.6-p5)
  • Ultimate Image Optimizer Extension Version
  • A clear description of the issue you are experiencing
  • Steps to reproduce the issue
  • Any relevant error messages or log file excerpts

For technical issues or specific questions, please don't hesitate to contact our support team.

Ready to unlock these features for your store?

The JaJuMa Ultimate Image Optimizer is the all-in-one solution for a faster, higher-ranking Magento store.

Find all you need to know and more valuable insights about Hyvä and Magento.
Expertly curated by JaJuMa:

🚀 Launch the JaJuMa Hyväverse

Your central resource for everything Hyvä.

Explore the Magento Metropolis!

Your central resource for everything Magento.


Do you find all information about us and our services?

thumb-up
thumb-down
Customer Feedback Form Like This In Your Magento Store?