Video Gallery

Overview

The Video Gallery block shows a grid of videos. Each video can be a YouTube or Vimeo link, or an MP4 or WebM file uploaded to the File Manager. Each video has a thumbnail, a title, a description and, for uploaded videos, an optional download link.

To show a single video instead, use the Video Embed block. See Blocks (The + Add Menu).

Add a Video Gallery

  1. In the Design Center editor, click + Add.
  2. Go to Media > Videos.
  3. Pick Video Gallery.

A new Video Gallery is full width and starts with three empty videos in three columns. Each shows an "Add a video" placeholder in the editor until it has a link or a file.

📘

A Video Gallery can't be switched to a Video Embed block, and a Video Embed can't be switched to a Video Gallery. One holds a single video and the other holds a list, so switching would lose the videos. To change from one to the other, add the new block and set it up again.

The Videos List

Add and edit the videos in the Videos list.

  • Add YouTube or Vimeo Video adds an empty video, open for editing. Paste the link.
  • Add Uploaded Videos opens the File Manager, showing MP4 and WebM files only. Each video you pick is added to the list.

Each video in the list shows:

  • a badge with its type: YOUTUBE, VIMEO, MP4, WEBM or LINK;
  • its title, or the file name or link if it has no title;
  • a message when the video won't show on your store, for example when it has no link yet, the link isn't a YouTube or Vimeo video, or no video file is chosen.

Click a video to open or close its settings. Drag videos to change their order. Use the Duplicate and Remove buttons on each video to copy or delete it.

📘

A video without a link or file still shows its placeholder in the editor, but it is left out on your store.

Settings for Each Video

SettingWhat it does
Video SourceYouTube or Vimeo Link or File Manager (MP4).
YouTube or Vimeo LinkPaste the video's page or share link. Unlisted Vimeo links work too.
Video FilePick an uploaded MP4 or WebM file from the File Manager.
Thumbnail ImageOptional. Shown before the video plays. Without one, uploaded videos show their first frame and YouTube or Vimeo videos show their own thumbnail.
TitleAlso used as the video's name for search engines and screen readers.
DescriptionText shown with the video, with a text editor toolbar.
Show Download LinkUploaded videos only. Shows a link to download the video file.
Download Link TextUploaded videos only. The text of the download link.
👍

For private Vimeo videos, set a Thumbnail Image. Vimeo doesn't share a thumbnail for them.

Settings for Every Video

These settings are set once and apply to every video in the block.

SettingOptions
Play VideosOn the page or In a popup.
Video Shape16:9 (widescreen), 21:9 (cinema), 4:3, 1:1 (square) or 9:16 (vertical, Shorts).
Titles and DescriptionsAbove the videos or Below the videos.
Download Link StyleButton or Text Link. For uploaded videos with Show Download Link turned on.
Show File Type and SizeShows the file type and size next to download links, for example "MP4 · 24.3 MB". The size shows on the storefront, not in the editor.

Style Settings

The block's style settings can be set separately for desktop, tablet and mobile.

  • Container: background color and padding for the whole block.
  • Grid: Columns (1 to 6), Space between videos and Align videos vertically. By default the grid shows 3 columns on desktop, 2 on tablet and 1 on mobile.
  • Accent, Video Frame, Each Video, Title, Description, Download Link and Popup: the same video settings as the Video Embed block, applied to every video in the gallery.

On Your Store

  • YouTube and Vimeo players load only when a shopper clicks play. Nothing plays on page load.
  • Only one video plays at a time on the page.
  • Videos without a link or file are left out.

Did this page help you?