Product Videos: setup and help

Upload the Product Videos ZIP from your back office's Modules page and install it. Use Configure, or open Product Videos > Settings > Configuration.

Requires PrestaShop 1.7.8 or later and PHP 7.1 or later.

Prepare a browser-ready video or an accessible source URL. Supported links include YouTube, Vimeo, Dailymotion and direct self-hosted videos. Local uploads accept MP4, WebM and Ogg. Direct self-hosted links also accept M4V and OGV. Files are stored as supplied. The module does not transcode recordings or generate subtitles or translations.

For uploaded posters, use JPG, PNG, WebP or GIF. Your server needs file-type detection through Fileinfo or mime_content_type, plus GD support for the poster formats you process. Animated GIFs cannot be cropped.

The shop must be able to create and write media under img/mprproductvideos/. PHP upload limits and available storage must accommodate your videos and posters. You do not need an external video account for self-hosted clips. Externally hosted clips remain subject to their provider's availability and playback permissions.

Select one shop before editing settings or videos in multishop. Your employee profile needs the corresponding view, add, edit or delete permission for the module’s Configuration page. Save the product before adding its videos.

1. Open Configuration in the selected shop. Leave Display mode at Video strip below the gallery for an initial placement check.
2. Keep Show video strip and Show listing badges enabled. Leave autoplay disabled for your first test. Save.
3. Open a saved product and select Add a video in its Product Videos interface, including the Images area where the back office integration is available.
4. Choose Link and enter Video URL, or choose Upload file and select a supported file.
5. Review Thumbnail, Caption, Description (used for VideoObject schema) and Alt text (SEO / accessibility) in each language. Supply a poster if one cannot be retrieved or captured.
6. Set Consent gate to On if this video should wait for agreement. Review Autoplay, Muted and VideoObject JSON-LD, then add the video. For later edits, use Save video settings.
7. Open the product page and play the clip. Open a category listing and test its play badge. Check the same product on a mobile viewport and in each published language.

Confirm that the intended poster appears, the source plays and any configured consent prompt appears before the remote player loads. Test sound separately because browser and provider restrictions can affect it.

Open Product Videos > Settings > Configuration. These values apply to the selected shop unless a product or video overrides them.

The accepted aspect-ratio range is from 1:3 to 5:1, equivalent to height percentages from 300% to 20%. Invalid values are refused.

The effective upload maximum cannot exceed PHP's upload_max_filesize or post_max_size. Increasing the module setting does not increase those server limits. The form shows the current server maximum.

Product choices

Open This product's options in the product's Product Videos panel. New product overrides use Inherit. This follows the selected shop's current value.

Display mode also offers Video strip below gallery and Inside the product gallery. The following controls offer Inherit, On and Off:

• Show video strip
• Show product tab
• Autoplay product-page videos
• Mute product-page videos
• Show listing badge
• Autoplay on listing miniatures
• Mute listing autoplay
• Require consent before embeds
• VideoObject JSON-LD

Change a product override when that product needs different placement or playback. Return it to Inherit when you want it to follow the shop setting again.

Hover preview, aspect ratio and upload limits remain shop settings.

Video choices

In the video editor, Autoplay, Muted, Consent gate and VideoObject JSON-LD each offer Inherit, On and Off. Inherit follows the effective product choice, then the shop default. An explicit video choice takes priority for that clip.

Listing autoplay and listing mute use their separate shop or product settings. A clip's Autoplay and Muted controls do not override those listing settings.

Use Add a video for a new record. Open an existing video to change it.

For an uploaded clip without a supplied poster, the editing browser attempts to capture a still frame. Upload a custom poster if frame capture fails or gives an unsuitable image.

Select the thumbnail's crop control to reposition and zoom the image within the frame. The configured aspect ratio determines the crop shape. Server image support is required to process it. Use a still image if an animated GIF cannot be cropped.

Use Save video settings to store an edit. Reopen it to check the saved source, image and language fields. Delete removes the selected video and reclaims its uploaded files when no remaining record needs them.

Use Gallery order (images + videos) to drag photos and clips into the intended sequence. The module also saves the product's photo ordering. In multishop, video settings and records belong to the selected shop, but the product-image order is shared by shops using those images.

Only one video cover is selected for a product and shop. In a supported native gallery, that video becomes the initial gallery media. In listings, its poster can represent the product if an image is available and consent permits loading it. Check the cover after changing either the video selection or the native photo cover.

For a folding-chair demonstration, try this arrangement:

1. Set Display mode to Inside the product gallery and Show video strip to On.
2. Keep an overall photo as the cover.
3. Arrange the media as overall photo, opening demonstration, hinge photo.
4. Set the clip's Caption to How the chair opens and folds. Keep Autoplay Off for this test.
5. Set Consent gate to On if you want agreement before that clip loads.

You supply the example product, photos and video.

Product page

The separate video strip is the initial display mode. You can also enable Show product tab. For instructions grouped only in the Videos tab, enable Show product tab and disable Show video strip.

Native gallery display supports Classic and Hummingbird, with a legacy default-bootstrap adapter also included. Other themes and heavily customized galleries need a placement check. When the expected gallery is unavailable, the module keeps a separate video section as fallback.

Selecting a video creates its player. Selecting another photo or video stops the previous gallery player. The product page uses active video records for the current product, shop and language.

With compatible Gallery Revolution coordination, Product Videos contributes its video section to the owned gallery area and avoids rendering it again in the native position. If that contribution is unavailable or ownership is uncertain, it uses a visible adjacent section. Not every Gallery Revolution layout shows videos as slides, so read the placement notice in Configuration and check the product page.

Listings

The listing badge opens a window containing the product’s videos and thumbnails. Supported listings include category, search, manufacturer, supplier, special offers, new products and best sellers. Controls remain available after supported product-list refreshes.

Optional listing autoplay requires a video cover and a suitable browser. It starts when at least 60% of the observed media area is visible. Only one listing autoplay player is kept running at a time. Playback stops when it leaves the visibility threshold.

Hover previews use self-hosted video, play muted and stop when the pointer leaves. You need a device with hover support. Reduced-motion and reported data-saving or slow-connection preferences suppress automatic cover playback and hover previews. Consent-required listing clips skip automatic and hover playback and use the badge to reach their prompt.

For a silent fabric-motion preview, use a self-hosted clip, enable Enable hover preview and test a hover-capable device. Keep the listing badge available for opening the video window.

Enable Require consent before embeds at shop or product level, or set the clip's Consent gate to On. Consent starts Off at shop level, so enable it wherever you require the prompt.

For a gated clip, the player and remote poster wait for agreement. Posters stored through the module under the shop's img/mprproductvideos/ path remain visible. Agreement is remembered per provider in that browser's local storage. Clearing that storage removes the remembered choice. If browser storage is unavailable, the browser cannot remember agreement for later visits.

The choice is separate from Cookies Revolution. A choice in one interface does not automatically update the other. It also applies to self-hosted clips when their effective consent setting is enabled.

Test in a browser profile without saved agreement. Check the prompt before playback, grant agreement and verify the clip plays. Reload and test another clip from the same provider. Clear storage when you need to repeat the first-visit test.

Keep Enable VideoObject JSON-LD enabled if you want the module to emit structured information for eligible clips. A product or video override can disable it.

Output requires a name, thumbnail and upload date. The module uses the video title or product name. It prefers the saved video description, then video title, product short description and product name. If the source has no upload date, it uses the date the video was added to the shop. A valid saved duration is included when available.

Supply a custom poster if no thumbnail is available. Check the product page source for VideoObject after saving. These details describe the recording.

After changing placement, playback or source, check the product page and at least one supported listing in your actual theme. Test each language, a mobile viewport, consent before agreement, manual playback and sound. Refresh the product editor to confirm the saved order and cover.

The module does not provide viewing reports or saved playback positions. You maintain the recordings, poster images and translated text yourself.

Back up video records, translated text, settings and uploaded files before removal. Use the module's Uninstall action.

Successful uninstallation removes its video tables, settings and uploaded media. Videos stored at external providers remain there. If uploaded-media cleanup fails, uninstallation stops before removing the schema. Check file permissions and PrestaShop logs, then retry.