The Video Display app attaches videos and images to J2Commerce products and shows them in a responsive block on the product detail page. YouTube, Vimeo, and self-hosted MP4 videos are supported, and the provider is detected from the URL.
Choose a Grid, Scroller, or Alternating layout, pick where the block appears, and optionally add a link to the Product Navbar.
Requirements
- PHP 8.3.0 or later
- Joomla 6.x
- J2Commerce 6.6.4 or later
Purchase and Download
Step 1: Go to our Product Video Display on the J2Commerce Extensions Store -> Apps
Step 2: Locate the Video Display App -> click View Details -> Add to cart -> Checkout.
Step 3: Go to My Downloads under your profile button at the top right corner and search for the app. Click Available Versions -> View Files -> Download Now
Install the App
In the Joomla admin, go to System -> Install -> Extensions. Upload the plugin ZIP file or use the Install from URL option.
%20(1).webp)
Enable the App
There are two ways to open the Apps list.
Option A: Click the J2Commerce icon at the top right corner -> Apps
Option B: Go to Components in the left sidebar -> J2Commerce -> Apps

Find Video Display and click the X. It turns into a green checkmark and the app is enabled.

Configure the App
Click the Video Display title next to the green checkmark to open the settings.
Tip
Click the Toggle Inline Help button in the toolbar to show a description below each field.

Basic Settings Tab

Display Position: Controls where on the product page the video and image block appears. Default: End of Tab Content.
- End of Tab Content (default): Below the product description tab content
- Bottom of Product Page: Below all other content, just before the page footer
- Before Cross-Sells: Above the cross-sell / related products section
- After Cross-Sells: Below the cross-sell / related products section
- Below Product Image Gallery: Directly below the main product image gallery (used in the Frontend View example below)
- After Tab (accordion layout): After the last product tab when using accordion mode
Display Mode: Chooses the layout. Default: Grid. Individual products can override it in their Apps tab.
- Grid: A responsive row with a configurable number of columns
- Scroller: A swipeable carousel with optional arrows, dots, autoplay, and loop
- Alternating (zigzag): Each item paired with text, alternating left and right down the page
Show Section Title: Shows a heading above the block. Default: Yes.
Section Title: The heading text when Show Section Title is Yes. Leave blank to use the default, "Product Videos".
The following settings appear only for the selected mode.
Grid Mode

Columns: Number of columns in the grid (1 to 6). Default: 3. On small screens the grid collapses to fewer columns.
Scroller Mode

Scroller Style: Default: Spotlight (centered).
- Spotlight (centered): The active slide is centered and wider than its neighbours
- Normal: Slides are equal width
Autoplay: Advances the carousel automatically. Default: No.
Autoplay Delay (seconds): Seconds between slide advances (1 to 60). Default: 5. Shown only when Autoplay is Yes.
Loop: Returns to the first slide after the last. Default: No.
Navigation Arrows: Shows previous and next buttons. Default: Yes.
Pagination Dots: Shows clickable dot indicators. Default: No.
Space Between Slides (px): Gap between slides (0 to 100). Default: 40.
Alternating Mode

Media Column Width: How many of 12 columns the video or image half spans. Default: Equal (6/12 video).
- Narrow (4/12 video): Media takes one third and text two thirds
- Equal (6/12 video): Media and text share equal halves
- Wide (8/12 video): Media takes two thirds and text one third
Navbar Tab

These settings add a link to the media block in the Product Navbar. The Product Navbar app must be installed and enabled.
Show in Product Navbar: Registers a link for any product that has media. Default: Yes.
Navbar Label: The link text. Default: Media.
Navbar Sort Order: Position of the link relative to other items (0 to 999). Default: 40. Lower numbers appear earlier.
Style Tab

Subtemplate: The visual style of the block. The list shows the available subtemplates, such as Bootstrap 5 and, if the UIkit app is installed, UIkit.
Custom CSS: Optional CSS applied to the block container (#j2commerce-videodisplay). Do not include <style> tags. Paste raw CSS only, for example:
padding: 2rem 0;
background: #f8f8f8;
Adding Videos and Images to Products
Each product has its own list of videos and images. The per-product settings can also override the display mode.
Option A: Click the J2Commerce icon at the top right corner -> Catalog -> Products
Option B: Go to Components in the left sidebar -> J2Commerce -> Products
Click a product to edit it -> J2Commerce tab -> Apps tab. Expand the Video Display section.

Video Display Section Fields
Show Media On This Product: On/off switch for this product. Set to No to hide the block even if items are configured. Default: Yes.
Display Mode: Overrides the plugin display mode for this product.
- Use Plugin Default: Uses the mode set in the plugin settings (default)
- Grid, Scroller, or Alternating (zigzag): Forces that layout for this product
Adding Videos and Images
Click Add item inside the Videos and Images repeater to add a row. Each row has these fields:
Type: Video (default) or Image. The other fields change with the type.
Video URL: For the Video type. Paste a YouTube, Vimeo, or direct MP4/WebM URL. Examples:
https://www.youtube.com/watch?v=...https://vimeo.com/...https://example.com/videos/product-demo.mp4
Only https:// URLs and site-relative paths (starting with / or images/) are accepted.
Provider: For the Video type. Shows Auto-Detect, YouTube, Vimeo, or HTML5 Video. The field is read-only.
Image: For the Image type. Choose an image from the images folder in the Media Manager.
Alt Text: For the Image type. Describe the image for people who cannot see it, and include any words the image contains. When empty, the caption is used.
Caption: Short text shown beneath the item in Grid and Scroller modes, and as a heading in Alternating mode.
Supporting Text: Longer text shown beside the item in Alternating mode, and below it as a caption in Grid and Scroller modes. Supports basic HTML.
Poster Image: For the Video type. Optional thumbnail shown before the video plays. If blank, YouTube videos use their auto-generated thumbnail, and other videos show a neutral placeholder.
You can add up to 50 items per product. Drag the handle to reorder rows and click the trash icon to remove a row. Click Save or Save & Close when done.
Frontend View
The block appears at the configured position. Videos show as a poster thumbnail with a play button, and clicking one opens the video in a lightbox.
The example below uses Below Product Image Gallery for Display Position and 1 for Columns.

Display Conditions
The block appears when:
- The plugin is enabled under J2Commerce -> Apps.
- Show Media On This Product is Yes on the product.
- At least one row has a valid URL or image.
- Video URLs begin with
https://or are site-relative paths starting with/orimages/. - The product page is viewed normally, not in a quickview popup.
The Navbar link appears when:
- Show in Product Navbar is Yes.
- The Product Navbar app is installed and enabled.
- The product has at least one item to display.
Tips
- Start with Grid for most products.
- Use Scroller for long lists: with five or more items it keeps the page compact.
- Use Alternating with supporting text, such as a feature-by-feature walkthrough.
- YouTube thumbnails are automatic. Set a poster image only to replace them.
- Self-host MP4 files under
images/. A file uploaded to the Media Manager works asimages/my-video.mp4. - Write short, descriptive captions. The caption is used as the iframe
titlefor screen readers.
Troubleshooting
Videos Do Not Appear on the Product Page
- Go to J2Commerce -> Apps and check that Video Display has a green checkmark.
- Edit the product, open J2Commerce -> Apps -> Video Display, and confirm Show Media On This Product is Yes.
- Check that at least one video row has a URL beginning with
https://, or an image row has an image. - Try Below Product Image Gallery as the Display Position. Some positions fire only when the matching template block is present.
YouTube Video Shows a Placeholder Instead of a Thumbnail
- Confirm the video is public on YouTube.
- Use the standard URL format:
https://www.youtube.com/watch?v=XXXXXXXXXXX - Or set a Poster Image on the row.
Scroller Arrows or Dots Are Not Visible
- Clear the Joomla cache under System -> Clear Cache.
- Reload the product page and check the browser console for JavaScript errors.
- Check that no custom CSS sets
opacity: 0ordisplay: noneon.swiper-button-next,.swiper-button-prev, or.swiper-pagination.
Video Block Appears in the Wrong Position
- Open the Video Display settings and try another Display Position. End of Tab Content and Bottom of Product Page work across J2Commerce templates.
- If a template override moves that section, use Custom CSS or an override to adjust placement.
Navbar Link Does Not Appear
- Check that the Product Navbar app is installed and enabled under J2Commerce -> Apps.
- In the Video Display settings, open the Navbar tab and confirm Show in Product Navbar is Yes.
- Confirm the product has at least one item that displays.
Installation Stops With a Version Message
The message reads "This plugin requires J2Commerce 6.6.4 or later." Update J2Commerce, then install the app again.