{"id":34,"date":"2026-09-08T05:21:11","date_gmt":"2026-09-08T05:21:11","guid":{"rendered":"https:\/\/woodevkit.com\/product-video-gallery-for-woocommerce\/?post_type=docs&p=34"},"modified":"2026-09-08T05:21:13","modified_gmt":"2026-09-08T05:21:13","password":"","slug":"troubleshooting-faqs","status":"publish","type":"docs","link":"https:\/\/woodevkit.com\/product-video-gallery-for-woocommerce\/docs\/troubleshooting-faqs\/","title":{"rendered":"Troubleshooting & FAQs"},"content":{"rendered":"

Find quick solutions to common issues and answers to frequently asked questions about WooCommerce Product Video Gallery<\/b>.<\/p>\n

Frequently Asked Questions (FAQs)<\/h2>\n

1. Which video platforms are supported by the plugin?<\/h3>\n

The plugin supports YouTube<\/b>, Vimeo<\/b>, and Self-Hosted MP4<\/b> (uploaded directly to your WordPress Media Library).<\/p>\n

2. Will embedding videos slow down my product page load times?<\/h3>\n

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.<\/p>\n

3. Can I assign different videos to specific product variations?<\/h3>\n

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

4. Why is my self-hosted MP4 video not playing on mobile devices?<\/h3>\n

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

5. Can I display video play buttons on WooCommerce shop and archive pages?<\/h3>\n

Yes. You can enable shop page video badges and play buttons from WooCommerce \u2192 Video Gallery \u2192 Settings<\/b>, which allows customers to preview product videos in a popup lightbox right from the catalog.<\/p>\n

Troubleshooting Guide<\/h2>\n

Issue 1: Videos are not appearing on the product page<\/h3>\n
    \n
  • \n

    Check Theme Compatibility:<\/b> Ensure your active WordPress theme uses standard WooCommerce gallery hooks (woocommerce_before_single_product_summary<\/code> or WooCommerce template overrides).<\/p>\n<\/li>\n

  • \n

    Verify Video URL:<\/b> Double-check that the YouTube or Vimeo URL is entered correctly and is set to Public<\/b> or Unlisted<\/b> (Private videos will not load).<\/p>\n<\/li>\n

  • \n

    Clear Cache:<\/b> Clear your WordPress caching plugin (e.g., WP Rocket, LiteSpeed Cache) and browser cache after adding new videos.<\/p>\n<\/li>\n<\/ul>\n

    Issue 2: Autoplay is not working<\/h3>\n
      \n
    • \n

      Browser Autoplay Policies:<\/b> Google Chrome and Apple Safari block unmuted autoplaying videos by default. Make sure the Mute Video<\/b> option is toggled ON<\/b> in the plugin settings to allow autoplay.<\/p>\n<\/li>\n<\/ul>\n

      Issue 3: Variation video is not changing when selecting an attribute<\/h3>\n
        \n
      • \n

        Ensure Variation Images exist:<\/b> WooCommerce requires each variation to have a base image assigned for gallery switching to work properly.<\/p>\n<\/li>\n

      • \n

        JavaScript Conflicts:<\/b> Open your browser console (F12) to check if another plugin is throwing a JavaScript error that prevents WooCommerce scripts from running.<\/p>\n<\/li>\n<\/ul>\n

        Issue 4: “Insufficient Quota” or API Errors (For AI Addons\/Extensions)<\/h3>\n
          \n
        • \n

          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.<\/p>\n<\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"

          Find quick solutions to common issues and answers to frequently asked questions about WooCommerce Product Video Gallery. Frequently Asked Questions […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"site-sidebar-layout":"default","site-content-layout":"","ast-site-content-layout":"default","site-content-style":"default","site-sidebar-style":"default","ast-global-header-display":"","ast-banner-title-visibility":"","ast-main-header-display":"","ast-hfb-above-header-display":"","ast-hfb-below-header-display":"","ast-hfb-mobile-header-display":"","site-post-title":"","ast-breadcrumbs-content":"","ast-featured-img":"","footer-sml-layout":"","ast-disable-related-posts":"","theme-transparent-header-meta":"","adv-header-id-meta":"","stick-header-meta":"","header-above-stick-meta":"","header-main-stick-meta":"","header-below-stick-meta":"","astra-migrate-meta-layouts":"default","ast-page-background-enabled":"default","ast-page-background-meta":{"desktop":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"ast-content-background-meta":{"desktop":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"footnotes":""},"doc_category":[17],"doc_tag":[],"class_list":["post-34","docs","type-docs","status-publish","hentry","doc_category-woocommerce-video-plugin"],"year_month":"2026-09","word_count":413,"total_views":"9","reactions":{"happy":"0","normal":"0","sad":"0"},"author_info":{"name":"sharabindubakshi","author_nicename":"sharabindubakshi","author_url":"https:\/\/woodevkit.com\/product-video-gallery-for-woocommerce\/author\/sharabindubakshi\/"},"doc_category_info":[{"term_name":"WooCommerce Video Plugin","term_url":"https:\/\/woodevkit.com\/product-video-gallery-for-woocommerce\/docs-category\/woocommerce-video-plugin\/"}],"doc_tag_info":[],"_links":{"self":[{"href":"https:\/\/woodevkit.com\/product-video-gallery-for-woocommerce\/wp-json\/wp\/v2\/docs\/34","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/woodevkit.com\/product-video-gallery-for-woocommerce\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/woodevkit.com\/product-video-gallery-for-woocommerce\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/woodevkit.com\/product-video-gallery-for-woocommerce\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/woodevkit.com\/product-video-gallery-for-woocommerce\/wp-json\/wp\/v2\/comments?post=34"}],"version-history":[{"count":1,"href":"https:\/\/woodevkit.com\/product-video-gallery-for-woocommerce\/wp-json\/wp\/v2\/docs\/34\/revisions"}],"predecessor-version":[{"id":35,"href":"https:\/\/woodevkit.com\/product-video-gallery-for-woocommerce\/wp-json\/wp\/v2\/docs\/34\/revisions\/35"}],"wp:attachment":[{"href":"https:\/\/woodevkit.com\/product-video-gallery-for-woocommerce\/wp-json\/wp\/v2\/media?parent=34"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/woodevkit.com\/product-video-gallery-for-woocommerce\/wp-json\/wp\/v2\/doc_category?post=34"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/woodevkit.com\/product-video-gallery-for-woocommerce\/wp-json\/wp\/v2\/doc_tag?post=34"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}