Skip to Content
Account
Enter the email address on your account.
Forgot Your Username?
Enter your password.
Forgot Your Password?

Or continue with

J2Commerce 6

Video Display

8 Min Read

Documentation current for Video Display v6.1.3. Last checked November 17, 2026.

On This Page

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.

Install extensions

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

Joomla admin navigation to J2Commerce Apps: Components, J2Commerce, Apps in the sidebar and Apps in the J2Commerce menu highlighted, above the list of apps

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

Apps list filtered by the search term "video", with the Status icon of the Video Display app highlighted to enable it

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.

Video Display app settings with the Toggle Inline Help button highlighted and the Display Position help text shown below the field

Basic Settings Tab

Video Display app, Plugin tab highlighted: Display Position Below Product Image Gallery, Display Mode Grid, Show Section Title Yes, Columns 1

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

Video Display app, Plugin tab: Display Mode set to Grid and highlighted, Display Position Below Product Image Gallery, Columns 1

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

Scroller Mode

Video Display app, Plugin tab: Display Mode Scroller highlighted, Scroller Style Spotlight (centered), Autoplay Yes with 5 second delay, Loop No

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

Video Display app, Plugin tab: Display Mode set to Alternating (zigzag) and highlighted, Video Column Width Equal (6/12 video)

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

Video Display app, Navbar tab highlighted: Show in Product Navbar Yes, Navbar Label field, Navbar Sort Order 40

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

Video Display app, Style tab highlighted: Subtemplate choice of Product View - Bootstrap 5 (selected) or Product View - UIkit, plus Custom CSS field

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.

Product edit screen, Apps tab highlighted with the Video Display section expanded: Show Videos On This Product Yes, Video URL, Provider, Caption and Poster Image fields

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.

Product page with a Product Videos section highlighted below the image gallery, showing a video thumbnail with a play button

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 / or images/.
  • 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 as images/my-video.mp4.
  • Write short, descriptive captions. The caption is used as the iframe title for screen readers.

Troubleshooting

Videos Do Not Appear on the Product Page

  1. Go to J2Commerce -> Apps and check that Video Display has a green checkmark.
  2. Edit the product, open J2Commerce -> Apps -> Video Display, and confirm Show Media On This Product is Yes.
  3. Check that at least one video row has a URL beginning with https://, or an image row has an image.
  4. 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

  1. Confirm the video is public on YouTube.
  2. Use the standard URL format: https://www.youtube.com/watch?v=XXXXXXXXXXX
  3. Or set a Poster Image on the row.

Scroller Arrows or Dots Are Not Visible

  1. Clear the Joomla cache under System -> Clear Cache.
  2. Reload the product page and check the browser console for JavaScript errors.
  3. Check that no custom CSS sets opacity: 0 or display: none on .swiper-button-next, .swiper-button-prev, or .swiper-pagination.

Video Block Appears in the Wrong Position

  1. Open the Video Display settings and try another Display Position. End of Tab Content and Bottom of Product Page work across J2Commerce templates.
  2. If a template override moves that section, use Custom CSS or an override to adjust placement.
  1. Check that the Product Navbar app is installed and enabled under J2Commerce -> Apps.
  2. In the Video Display settings, open the Navbar tab and confirm Show in Product Navbar is Yes.
  3. 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.

Related Products

Related Products

Still stuck? Our team can help.

Back to Top