Skip to main content

Video Providers

What are Video Providers?​

Video providers are the platforms or sources where your product videos come from. The Product Video module supports multiple providers, making it easy to add videos from different sources to your products.

Important

Module comes with two pre-configured providers: YouTube and Vimeo. Other providers must be configured first in the module settings before you can use them.

Supported Providers​

YouTube​

🎥 Default Provider

The world's largest video platform - perfect for product demos, tutorials, and reviews.

Why use YouTube?

  • ✅ Free unlimited hosting
  • ✅ Automatic quality adjustment
  • ✅ Fast loading worldwide
  • ✅ Built-in player controls
  • ✅ Mobile-optimized playback

Supported URL formats: Regular Videos and Shorts

https://www.youtube.com/watch?v=VIDEO_ID
https://youtu.be/VIDEO_ID
https://youtube.com/shorts/VIDEO_ID
...
Privacy Option

The module has the option to use YouTube's privacy-enhanced mode (youtube-nocookie.com)

Vimeo​

🎬 Default Provider

Ad-free professional video hosting platform, ideal for high-quality product presentations.

Why use Vimeo?

  • ✅ Clean, ad-free playback
  • ✅ Professional appearance
  • ✅ High-quality streaming
  • ✅ Customizable player colors
  • ✅ Privacy controls

Supported URL formats:

https://vimeo.com/VIDEO_ID
https://player.vimeo.com/video/VIDEO_ID

HTML5 (Self-Hosted)​

💾 Full control

Host your own video files directly on your server for complete control.

Why use HTML5?

  • ✅ Complete control over your content
  • ✅ No third-party dependencies
  • ✅ No branding or ads
  • ✅ Works offline/intranet
  • ✅ Custom player styling

Requirements:

  • Recommended format: MP4 (H.264 codec)
  • Max file size: Depends on your server (typically 50-100MB)
  • Other supported formats: WebM, OGG
Server Resources

Self-hosted videos use your server's bandwidth. For high-traffic stores, consider YouTube or Vimeo.

Technical: Optimal video settings

For best performance and compatibility:

Format: MP4
Codec: H.264
Resolution: (depends on the finality, if fullscreen is supported)
Aspect Ratio: The same as the product images, if the image placement is going to be used
Bitrate: 5-8 Mbps
Frame rate: 30 fps
Audio: AAC, 128 kbps

Custom iFrame​

🔧 Universal solution

Embed content from any platform using iframe code - not just videos!

What can you embed?

  • 📹 Videos from any platform (Dailymotion, Wistia, Facebook, etc.)
  • 🗺️ Interactive maps
  • 🎨 3D model viewers
  • 📊 Interactive presentations
  • 🎮 Product configurators
  • ...anything that provides iframe embed code!

Why use Custom Providers?

  • ✅ Works with ANY platform
  • ✅ Support for specialized content
  • ✅ Maximum flexibility
  • ✅ Easy to add new platforms
Beyond Videos

Custom providers aren't limited to videos - use them for interactive 3D models, maps, or any embeddable content!

Security Notice

For security reasons, only URLs from configured providers will be accepted. If you paste a URL from an unconfigured platform, you'll need to add that provider first.

How to Add/Enable Providers​

Using The Default Providers (YouTube/Vimeo)​

YouTube and Vimeo come pre-configured and can't be removed. Scripts related to the usage of those providers will only be loaded if the product has a video from them, otherwise no scripts will be loaded.

Note

Default providers can't be disabled nor deleted to prevent module malfuncitons.

Adding Custom Providers​

For other platforms (Dailymotion, Wistia, Facebook, etc.), you need to add them first:

For platforms with video URLs (like Dailymotion):

  1. Go to Modules → Product Video → Configure
  2. Click on Providers tab
  3. Click Add New Provider
  4. Fill in the form:
    • Name: Provider name (e.g., "Dailymotion")
    • Type: Select "URL Pattern"
    • URL domain: Enter the URL domain (e.g., dailymotion.com)
  5. Click Save

Example URL Pattern:

Domain: dailymotion.com
Path contains: /video/

Adding Videos to Products​

Step-by-Step Process​

Using configured providers:

  1. Navigate to Catalog → Products
  2. Edit your product
  3. Go to the Videos tab
  4. Click Add Video
  5. Paste your video URL
  6. Check the URL status:
    • ✅ Green: Provider recognized, ready to save
    • ❌ Red: Provider not configured
URL Rejected?

If the URL turns red, it means that provider hasn't been added yet. You need to:

  1. Add the provider first in module configuration
  2. Come back and try again

Coming soon: Direct link to add providers from this screen!

  1. Configure display options (optional)
  2. Click Save

Provider Security​

Why URL Validation?​

The module validates all video URLs for security reasons:

Benefits:

  • 🔒 Prevents malicious content injection
  • ✅ Ensures only configured platforms are used
  • 🛡️ Protects your store from XSS attacks
  • 📋 Maintains control over content sources

How it works:

Coming Soon

In future updates, you'll be able to add providers directly from the "Add Video" screen without leaving the page!

Choosing the Right Provider​

Quick Decision Guide​

Use YouTube when:

  • Your video is already on YouTube
  • You want free, fast hosting
  • You need global availability
  • You're okay with YouTube branding

Use Vimeo when:

  • You want an ad-free experience
  • You need professional appearance
  • You want advanced privacy controls
  • You have a Vimeo account

Use HTML5 when:

  • You need complete control
  • You have few videos (server bandwidth)
  • You want no third-party branding
  • You're on intranet/offline environment

Use Custom Provider when:

  • Your video is on another platform
  • You need interactive content (maps, 3D)
  • Standard providers don't support your platform
  • You have specialized embed requirements

Provider Settings​

Configuring Enabled Providers​

Each provider has specific settings you can customize:

Available Options:

  • ✓ Enable/Disable provider
  • Autoplay (on/off)
  • Show/hide controls
  • Loop video
  • Privacy mode (youtube-nocookie.com)
  • Modest branding

Access: Modules → Product Video → Configure → Providers → YouTube

Common Questions​

Why can't I paste any URL I want?

For security reasons, the module only accepts URLs from configured providers. This prevents:

  • Malicious content injection
  • Unauthorized iframe embedding
  • XSS attacks on your store
  • Unknown/untrusted content sources

Solution: Add the provider first in module configuration, then use the URL.

My URL turned red - what should I do?

A red URL means the provider isn't configured yet. Follow these steps:

  1. Note which platform your video is from (e.g., Dailymotion)
  2. Go to Modules → Product Video → Configure → Providers
  3. Add that provider (see Adding Custom Providers)
  4. Return to your product
  5. Paste the URL again - it should now turn green!
Can I use multiple providers on the same product?

Yes! You can mix different providers on a single product:

  • YouTube demo video
  • Vimeo testimonial
  • HTML5 product closeup
  • Custom iframe 3D viewer

As long as each provider is configured, they all work together.

Do I need to add YouTube and Vimeo?

No! YouTube and Vimeo come pre-configured. You just need to enable them in the Providers settings. No need to add patterns or configurations.

Can I disable a provider temporarily?

Yes! Go to Providers settings and click Disable on any provider. Videos from that provider will stop displaying (but won't be deleted).

Re-enable anytime to restore functionality.

What happens to videos if I remove a provider?

Videos remain in your database but won't display on the front-end. If you re-add the provider, they'll work again automatically.

caution

Be careful when deleting providers - make sure no products are using videos from that source!

Troubleshooting​

Common Issues​

URL immediately turns red when pasted

Cause: The provider for that URL isn't configured yet.

Solution:

  1. Identify the video platform (YouTube, Vimeo, Dailymotion, etc.)
  2. Check if that provider is enabled in Modules → Product Video → Providers
  3. If not listed, add the provider
  4. Try pasting the URL again
Provider enabled but URL still rejected

Check these points:

✓ URL format is correct - Copy directly from the video page
✓ Provider is actually enabled - Check the toggle is ON
✓ URL matches the pattern - For custom providers, verify your pattern is correct
✓ Clear cache - Both PrestaShop and browser cache

Still not working? The URL pattern for your custom provider might be incorrect. Double-check the domain and path pattern.

iframe code rejected (red)

Cause: The domain in the iframe isn't in the allowed domains list.

Solution:

  1. Copy the domain from your iframe src (e.g., player.example.com)
  2. Go to Providers → Your Custom Provider
  3. Add that domain to Allowed Domains
  4. Save and try again

Example:

<iframe src="https://player.example.com/video/123">

Add player.example.com to allowed domains.

Best Practices​

Recommendations
  1. Enable only needed providers - Keep your list clean and manageable
  2. Use default providers first - YouTube/Vimeo are tested and optimized
  3. Document custom providers - Note why you added each custom provider
  4. Review allowed domains - Periodically check iframe security settings
  5. Test after adding - Always test a provider with a real video URL

Security Tips:

  • Only add providers from trusted platforms
  • Keep allowed domains list minimal
  • Review custom iframe sources regularly
  • Disable unused providers instead of deleting them

Next Steps​

📍 Video Placements

Learn where videos can be displayed on your product pages

View Guide

⚙️ Configuration

Configure module settings and customize behavior

View Guide
Need Help?

If you have questions about adding providers or encounter issues, check our Support page or contact us.