Troubleshooting & FAQs

Find quick solutions to common issues and answers to frequently asked questions about WooCommerce Product Video Gallery.

Frequently Asked Questions (FAQs) #

1. Which video platforms are supported by the plugin? #

The plugin supports YouTube, Vimeo, and Self-Hosted MP4 (uploaded directly to your WordPress Media Library).

2. Will embedding videos slow down my product page load times? #

No. The plugin uses lightweight scripts, optimized Swiper slider integration, and lazy loading for video embeds to ensure your core Web Vitals and site speed remain unaffected.

3. Can I assign different videos to specific product variations? #

Yes! You can attach a video as the Variation Featured Video or attach individual videos to items inside the Variation Image Gallery. When a customer switches variations, the gallery updates dynamically.

4. Why is my self-hosted MP4 video not playing on mobile devices? #

Most modern mobile browsers (iOS Safari, Android Chrome) restrict video autoplay unless the video is set to Muted. Ensure the mute option is enabled if you want videos to autoplay on mobile.

5. Can I display video play buttons on WooCommerce shop and archive pages? #

Yes. You can enable shop page video badges and play buttons from WooCommerce → Video Gallery → Settings, which allows customers to preview product videos in a popup lightbox right from the catalog.

Troubleshooting Guide #

Issue 1: Videos are not appearing on the product page #

• Check Theme Compatibility: Ensure your active WordPress theme uses standard WooCommerce gallery hooks (woocommerce_before_single_product_summary or WooCommerce template overrides).

• Verify Video URL: Double-check that the YouTube or Vimeo URL is entered correctly and is set to Public or Unlisted (Private videos will not load).

• Clear Cache: Clear your WordPress caching plugin (e.g., WP Rocket, LiteSpeed Cache) and browser cache after adding new videos.

Issue 2: Autoplay is not working #

• Browser Autoplay Policies: Google Chrome and Apple Safari block unmuted autoplaying videos by default. Make sure the Mute Video option is toggled ON in the plugin settings to allow autoplay.

Issue 3: Variation video is not changing when selecting an attribute #

• Ensure Variation Images exist: WooCommerce requires each variation to have a base image assigned for gallery switching to work properly.

• JavaScript Conflicts: Open your browser console (F12) to check if another plugin is throwing a JavaScript error that prevents WooCommerce scripts from running.

Issue 4: “Insufficient Quota” or API Errors (For AI Addons/Extensions) #

• If you are using any connected OpenAI/AI generator features within the backend, verify that your API key is valid and your OpenAI platform account has active prepaid credits/balance.