Your first video

This walkthrough adds your first video to a product. We will embed a YouTube video — the same flow applies to Vimeo, TikTok, Dailymotion, Facebook, Gcore and direct URLs.

Before you start

• The plugin is installed and activated (Installation).
• You have a product to test on.

Step 1 — Open the product media tab

1. Go to Catalogue → Products and open any product.
2. Switch to the Media tab.

The Product Video override extends the right-side panel for each media entry with three tabs:

• File — the standard Shopware media reference
• Video — HTML5 video configuration
• Embed Video — external video URL (YouTube, Vimeo, etc.)

You fill in either Video (for an uploaded file) or Embed Video (for a URL).

Step 2 — Paste the YouTube URL

1. Click Add file or Add from media library to create a media entry, then select it.
2. In the right-side panel, find the Embed Video card.
3. Click Add and paste a YouTube URL (https://www.youtube.com/watch?v=... or a short youtu.be/… URL).
4. The plugin recognises the URL as YouTube and fetches the thumbnail automatically.

Step 3 — Set playback options

Open the Settings tab inside the media entry to configure per-video options:

• Mark video as cover — replace the product listing cover with this video
• Autoplay, Muted, Loop, Controls, Play inline, Keyboard
• Start video at / End video at — trim the playable range
• Theme — pick one of the eight YouTube player themes
• Use default settings — fall back to the global defaults

Defaults for new entries come from Settings → System → System Config → Product videos → YouTube settings. You can override them per video here.

Step 4 — Save and preview

• Save the product.
• Open it on the storefront — the video appears in the gallery with a play-icon overlay.
• Click the play overlay. If GDPR mode is on, you will first see a cookie-consent prompt; otherwise the YouTube iframe loads and plays.

What just happened under the hood

• The plugin stored your video metadata (type, url, source, playback options) inside customFields.p2labProductVideo on the product_media row.
• The storefront Twig templates (product-video.html.twig and the gallery overrides) detect the Product Video metadata and render a video player instead of the plain image.
• If GDPR mode is on (Do not require cookies accept = off), the iframe is gated behind a cookie consent overlay.

Next steps

• Add more videos and reorder them in the gallery.
• Try a local HTML5 video (Local video) instead of an embed.
• Drop the P2Lab Video Player block into a Shopping Experience page (Shopping Experiences).
• Configure a different player theme for YouTube (YouTube themes).