This guide explains how to upload and use self-hosted videos in Shopware, including supported formats, size limits, and the steps for adding a video to products and storefront content.
For more information, please refer to the Media user documentation.
Self-hosted videos uploaded to the Shopware Media Manager.
Video covers (poster images) for better preview and performance.
Usage in product media galleries and storefront blocks that render media (for example, product galleries and image galleries).
Shopware supports video formats that are playable in most browsers. Use one of the following MIME types to avoid the unsupported-format warning:
video/mp4(example:my-video.mp4)
video/ogg(example:my-video.ogv or my-video.ogg)
video/webm(example:my-video.webm)
Formats outside this list can be uploaded, but they may show an unsupported-format warning in the Media Manager and might not play in the storefront (for example, my-video.mov or my-video.avi).
Shopware stores and serves the original video file. It does not transcode or re-encode videos.
There are no enforced codec or resolution requirements in Shopware itself. Playback depends on the customer’s browser.
Choose resolution and bitrate based on your storefront layout and performance targets (for example, product detail view size and typical network conditions).
Local file upload limits depend on your server and PHP settings (for example, upload_max_filesize, post_max_size, and any reverse-proxy limits).
Upload by URL (if enabled) uses the Shopware setting shopware.media.url_upload_max_size:
0means no explicit limit from Shopware.
Any non-zero value sets a hard limit; files above that size are rejected.
If large files fail to upload, increase server limits or use the URL upload option with a publicly reachable file.
Go to Content > Media.
Open the target media folder (or create one).
Upload your video file via drag-and-drop or the upload button.
Optional: switch to Upload by URL if your instance has the URL upload feature enabled.
A cover image is used as the video poster in the storefront and speeds up initial page rendering.
Select the uploaded video in the Media Manager.
In the sidebar, choose Set cover image.
Select an image file (image formats only are accepted).
Save the cover.
Open Catalogues > Products and select a product.
Scroll to the Media card.
Add the uploaded video to the product’s media list.
Save the product.
The storefront video player uses the cover as a poster image when available.
If your CMS element supports mixed media (images and videos), you can add the video from the Media Manager:
Go to Content > Shopping Experiences.
Open or create a layout.
Add an element that supports media (for example, an image gallery).
Choose the uploaded video from the Media Manager.
Save and assign the layout.
Cause: the uploaded file is not in one of the playable formats (video/mp4, video/ogg, video/webm).
Fix: re-encode to a supported format and re-upload the video.
Cause: server or proxy limits are lower than the video file size.
Fix: increase server limits (upload_max_filesize, post_max_size) or use URL upload if enabled.
Cause: unstable connection or server timeout during large uploads.
Fix: retry from a stable connection, reduce file size, or use URL upload.
Cause: the selected cover is not an image file or the media is not a video.
Fix: choose a valid image and ensure the media item is a video file.
