Skip to content
Mediaverse

Troubleshooting

This page collects the issues we see most often. For deeper diagnostics, check the standard Shopware logs and the browser DevTools console.

Product videos configuration page is missing

Section titled “Product videos configuration page is missing”
  • Confirm the plugin is activated under Extensions → My extensions.
  • Clear the admin cache: bin/console cache:clear.
  • Hard-refresh the admin (Ctrl+Shift+R).
  • Check that your user role has access to the new ACL keys.

Video does not play on the storefront

Section titled “Video does not play on the storefront”
  • Open the product detail page in an incognito tab to bypass cookie consent state.
  • Check the browser console for CORS or third-party blocking errors.
  • For embeds: try a different browser to rule out ad-blockers.
  • For local HTML5: verify the file is actually in the media library and not deleted.

Cover video does not autoplay in listings

Section titled “Cover video does not autoplay in listings”
  • Confirm Muted = on for the cover entry. Modern browsers require muted autoplay.
  • Confirm the source is enabled in Settings → System → System Config → Product videos → General settings → Video in listing.
  • Check that lazy loading does not unmount the video before it can play.

Thumbnails are missing for YouTube / Vimeo / TikTok

Section titled “Thumbnails are missing for YouTube / Vimeo / TikTok”
  • The auto-fetch happens when you save the media entry. If the URL was invalid at save time, no thumbnail is downloaded.
  • Re-paste the URL and save again to retrigger the fetch.
  • For Facebook and Gcore, automatic thumbnails are not supported — upload one manually.

YouTube theme is broken after a YouTube update

Section titled “YouTube theme is broken after a YouTube update”
  • YouTube changes its iframe internals occasionally — Mediaverse themes apply CSS on top.
  • Fall back to YouTube default theme until the next Mediaverse release fixes the styling.
Section titled “Gallery slider is laggy or rebuilds incorrectly”
  • Try Settings → System → System Config → Product videos → General settings → Stop gallery slider rebuild.
  • If your theme has a custom gallery, the slider rebuild flag may conflict — try toggling it.

Storefront does not pick up settings changes

Section titled “Storefront does not pick up settings changes”
  • Clear the storefront cache: bin/console cache:clear.
  • For asset changes, also rebuild the storefront bundle if you self-host.
  • Hard-refresh the browser.

Where to look first

Section titled “Where to look first”
  • Browser DevTools — for storefront problems, the JS console usually points at the cause.
  • Shopware logs — var/log/dev.log (or prod.log) for backend errors.
  • API logs — Shopware admin → Settings → System → API event log (for media write events).
Section titled “Related”