FAQ
Does the add-on load YouTube or Vimeo scripts on every product page?
Section titled “Does the add-on load YouTube or Vimeo scripts on every product page?”No. Until the shopper presses play, the page contains only a local preview image and a play button. The player iframe is created on click. With Privacy-enhanced players on, YouTube loads from youtube-nocookie.com and Vimeo gets dnt=1. Two optional features do contact these services earlier: hover previews with the All videos option, and muted autoplay after the shopper navigates to a video slide.
Do I need cookie consent for the videos?
Section titled “Do I need cookie consent for the videos?”With the default settings no third-party request is made before the shopper clicks play, and that click is an explicit user action. Your legal requirements depend on your jurisdiction. If in doubt, ask your legal advisor, keep privacy mode on and leave hover previews on Only uploaded and MP4/WebM videos.
The YouTube/Vimeo video has no preview image.
Section titled “The YouTube/Vimeo video has no preview image.”The preview image is copied when you save the video. If your server cannot make outgoing HTTPS requests, or if Copy title and preview image is off, no image is copied. In that case upload a preview image in the Videos tab. Private or deleted videos have no public preview either.
My Vimeo video is not accepted or does not play.
Section titled “My Vimeo video is not accepted or does not play.”Use the public link. For unlisted videos, use the link that contains the hash (https://vimeo.com/123456789/abcdef1234). The video’s embed privacy settings on Vimeo must allow embedding on your domain.
Uploading a large video file fails.
Section titled “Uploading a large video file fails.”The upload is limited by PHP: upload_max_filesize, post_max_size and max_execution_time. Raise these limits, or upload the file by FTP into the store’s var/files area and pick it with the Server button. For very large files, host them on a CDN and paste the direct .mp4 link.
Which video formats should I use for uploads?
Section titled “Which video formats should I use for uploads?”MP4 (H.264 video, AAC audio) plays in all modern browsers. WebM (VP9/AV1) is a good second option. Keep product videos short and compressed. Hover previews work best with small files of 1–3 MB.
The videos do not appear in the gallery of my custom theme.
Section titled “The videos do not appear in the gallery of my custom theme.”The add-on extends the core Responsive gallery (.cm-preview-wrapper, #images_preview_<id>). If your theme renders a different gallery, the videos appear below the product images instead. This fallback is the same as the Below the product images placement. To integrate with a custom gallery, see the developer guide. You can also contact us.
Can I show videos only in a separate tab?
Section titled “Can I show videos only in a separate tab?”Yes. Set Show videos to Only in the “Videos” product tab. To show both the gallery and the tab, keep the gallery placement and turn on Also show a separate “Videos” product tab.
How do I translate video titles?
Section titled “How do I translate video titles?”Switch the content language at the top of the product editing page, edit the titles in the Videos tab, and save. You can also import the Videos column once per language.
Are videos copied to product variations or vendor offers?
Section titled “Are videos copied to product variations or vendor offers?”No. Videos belong to a single product. A cloned product gets copies of the videos. Variations and Multi-Vendor vendor offers of common products keep their own video lists.
Can vendors add videos?
Section titled “Can vendors add videos?”In Multi-Vendor, yes. They need Allow vendors to manage videos of their products on, and the right to edit their products. A vendor can only manage videos of their own products.
What happens to the videos when I uninstall the add-on?
Section titled “What happens to the videos when I uninstall the add-on?”All videos, their preview images and uploaded files are deleted. Export the products with the Videos column first if you may need them later.
Does it work with the SEO add-on’s structured data?
Section titled “Does it work with the SEO add-on’s structured data?”Yes. The add-on prints separate VideoObject blocks, so it does not interfere with the Product markup of the SEO add-on. You can turn the markup off with Add VideoObject structured data.
The videos disappeared from the storefront and the admin panel shows a license notice.
Section titled “The videos disappeared from the storefront and the admin panel shows a license notice.”Open Add-ons → Manage add-ons → Product Videos Gallery → Settings → License. The status line says what is wrong: no key, a key for another add-on, a revoked license, or a domain that the license does not cover. Fix it and click Check now. See License.
Does the add-on work on my staging copy?
Section titled “Does the add-on work on my staging copy?”Yes. Subdomains of your licensed domain (for example staging.example.com) and local development hosts (localhost, private IP addresses, *.local, *.test) are covered by the same license.
What happens if your license server is down?
Section titled “What happens if your license server is down?”Nothing visible: the add-on keeps the last verified result and keeps working for 14 days while it retries. The admin panel shows a notice from the first failed check.
Does the license check slow down my storefront?
Section titled “Does the license check slow down my storefront?”No. The check runs in the admin panel or from cron, once a day. The storefront only reads the stored result.
Still stuck?
Section titled “Still stuck?”Work through the troubleshooting guide, then contact support with your CS-Cart version, edition, PHP version and the add-on version (1.2.1).