Plugin configuration reference
This page summarises every configuration available in Settings → System → System Config → Product videos. v2 uses Shopware’s standard system-config UI; v3 (Shopware 6.7) uses a dedicated module.
General settings
Section titled “General settings”| Setting | Default | What it does |
|---|---|---|
| Background image display mode | contain | How the poster fills its slot: contain (letterbox) or cover (crop). |
| Stop gallery slider rebuild | on | Compatibility flag for themes that rebuild the gallery on every change. Off only if your theme does not work with the default. |
| Container selector to add play icon | — | CSS selector for the wrapper where the play icon overlay is injected. |
| Video in listing | all sources | Which embed sources are allowed to autoplay as cover videos in listings. |
| Lazy load in listing | on | Lazy-load video iframes / <video> elements in category and search grids. |
| Lazy load in CMS | on | Lazy-load videos inside Shopping Experiences. |
| Do not require cookies accept | off | When off (default), embeds show a GDPR consent overlay until the customer accepts cookies. |
| Disable VideoJS | off | Skip the Video.js wrapper for HTML5 videos. |
Embedding settings — product details page
Section titled “Embedding settings — product details page”- Load iframe immediately — multi-select of sources for which the iframe is loaded eagerly on the product detail page (skips the play-icon overlay step).
Embedding settings — listings
Section titled “Embedding settings — listings”- Load iframe immediately in listing — same idea, but for category / search grids.
Embedding settings — CMS
Section titled “Embedding settings — CMS”- Load iframe immediately in CMS — same idea, but for Shopping Experiences.
YouTube settings
Section titled “YouTube settings”- General
- YouTube nocookie — use
youtube-nocookie.com(recommended for EU stores)
- YouTube nocookie — use
- Custom theme
- Poster on pause, Delay first play, Seeking behaviour
- Product details defaults
- Theme — picker (one of eight)
- Per-video flags:
defaultYoutubeAutoplay,defaultYoutubeMuted,defaultYoutubeLoop,defaultYoutubeControls,defaultYoutubePlaysinline,defaultYoutubeKeyboard
- Product listing defaults
defaultCoverYoutubeAutoplay,defaultCoverYoutubeMuted, etc.
Vimeo settings
Section titled “Vimeo settings”- Theme — picker
- Product details defaults — autoplay, muted, loop, controls, playsinline
- Product listing defaults — autoplay, muted, loop, controls
Facebook / Dailymotion / TikTok / Gcore settings
Section titled “Facebook / Dailymotion / TikTok / Gcore settings”- Product details defaults — autoplay, muted, loop, controls, playsinline
- Product listing defaults — same flags per source
CMS video height
Section titled “CMS video height”- A separate input to control the height of videos embedded via the Mediaverse CMS block.
Per sales channel
Section titled “Per sales channel”All settings can be overridden per sales channel using the sales-channel switcher at the top of the configuration page. Global defaults apply unless a channel overrides them.