In most stores the gallery slider works as soon as you activate it. If yours does not, find your problem below. Each fix is short, and you do not need to write code for most of them.
Start here
- Clear your cache. Clear your cache plugin, your host cache and your browser cache. An old copy of the page is the most common reason for a wrong gallery.
- Check that the plugin is active and that WooCommerce is active too.
- Open a single product page, not the shop page. The slider works on product pages.
Still wrong? Go to the problem that looks like yours.
What the plugin already does for you
- It turns off the default WooCommerce zoom, lightbox and slider, so you do not get two of them.
- It replaces the standard WooCommerce gallery template, so most themes show the slider without any setup.
- It stops the Astra Pro product layout from taking over the gallery.
- It stops YITH Color and Label Variations from changing the gallery by itself.
Problem: I still see the old gallery
Your theme probably builds its own gallery and does not use the standard WooCommerce one.
- Look in your theme settings for a product gallery option and choose the default WooCommerce gallery.
- Porto. Go to the theme options, then General, and find Show Skeleton Screens. Switch it off for the Product Page and save.
- Themify themes. Go to Themify Settings, then Shop Settings, then Product Gallery, and choose the default WooCommerce gallery.
- If your theme has no such option and prints its own gallery in
content-single-product.php, ask your theme author or a developer to use the standard WooCommerce gallery in a child theme.
Problem: I see two galleries
- With a page builder, remove the builder gallery widget from your product template, so only the slider is left.
- With Divi, turn on Divi Compatibility. Go to TechBella Gallery, then Gallery Settings, then Tools and Custom CSS.
- With Woostify, the plugin lets the theme place the gallery and swaps in the slider. Use the shortcode below if the slider does not appear.
Problem: the slider does not appear in my page builder layout
- Go to TechBella Gallery, then Gallery Settings, then Tools and Custom CSS.
- Copy the code from Page Builder Shortcode.
- Paste it into a shortcode or code block of your product template. The Pro plugin also has a Product Gallery Slider widget for Elementor.
More help: “How to Use the Gallery With Elementor” and “How to Use the Gallery With Divi”.
Problem: the variation gallery behaves oddly with YITH
The plugin already turns off the YITH gallery handling. If you still see a problem, add this line at the end of the functions.php file of your child theme.
add_filter( 'yith_wccl_enable_handle_variation_gallery', '__return_false', 99 );Problem: the gallery does not work in a quick view popup
The YITH quick view works with the slider. For another quick view plugin, ask the plugin to load the gallery files on every page. Add this line to your child theme.
add_filter( 'techbella_load_entrie_site', '__return_true' );Problem: two lightboxes or two zoom effects open
- Another plugin or your theme adds its own lightbox or zoom. Turn that one off in the theme or plugin settings.
- Or turn off the lightbox of the slider. Go to Lightbox Popup and switch Open Images in Lightbox off.
Problem: images are missing, blurry or the gallery is blank
- A speed or cache plugin may delay or combine the scripts. Exclude the files of this plugin from minify, combine and delay options, then clear the cache.
- Another lazy loading plugin can clash with the lazy loading of the slider. Keep only one of them on for the product gallery.
- If theme styles hide the gallery, a few lines in the Custom CSS box of Tools and Custom CSS usually fix it. Ask support if you are not sure what to write.
- For blurry images, see “How to Fix Blurry Product Images in the Gallery”.
Find the cause when nothing helps
- Switch to a default WordPress theme for a moment. If the slider works, your theme is the cause.
- Switch back and deactivate other plugins one by one, and test after each one. The last one you turned off is the cause.
- Write down what you found and read “How to Get Support for a Plugin” in Getting Started.
