Skip to content

Thumbnails

The thumbnail is the image shown in the gallery before the customer presses play. Mediaverse fetches a thumbnail automatically for most embedded sources and lets you override it per video.

For embeds, the plugin downloads a thumbnail when you paste the video URL:

  • YouTubemaxresdefault.jpg, falling back to hqdefault, sddefault, mqdefault, default.
  • Vimeo — via the public oEmbed endpoint.
  • TikTok — via the public oEmbed endpoint.
  • Dailymotion — direct thumbnail URL.

Facebook and Gcore do not return a thumbnail automatically — upload one manually.

For local HTML5 videos, the browser uses the first frame unless you set a custom poster.

You can override the auto-fetched poster on a per-video basis through the standard Shopware media custom-thumbnail flow on the media entry.

Mediaverse draws a play-icon overlay on top of every video thumbnail. The selector that controls where the overlay is injected is configurable in Settings → System → System Config → Product videos → General settings → Container selector to add play icon — useful if your theme wraps gallery items in custom HTML.

In Settings → System → System Config → Product videos → General settings → Background image display mode, choose how the poster fills its slot:

  • contain — letterbox / pillarbox (no cropping)
  • cover — fill the slot and crop the edges (no letterbox)