Working with Custom Grid Content
Learn how to configure a grid to use specifically selected pieces of content.
Table of Contents
- Using Individually Selected Content Items
- Adding Items to a Custom Grid
- Custom Grid Content Types
- YouTube
- Adding Media Source Types
- Setting Media Source Preference Order
- Vimeo
- Self Hosted Media
- Image(s)
- Sound Cloud
- Simple Content
- Blank Item
Using Individually Selected Content Items
Rather than your grid containing dynamic content from your site or social media, you may instead wish to specifically select each individual item that appears.
You can do this using the Custom Grid grid source type.
To begin, go to the Source panel and set the Based on option to Custom Grid (Editor Below):
Once you’ve made this selection, if you scroll down to the Add Gallery Items panel you will see seven buttons, each representing one of the types of content you can use in a custom grid:

Those types are YouTube, Vimeo, Self Hosted Media, Image(s), Sound Cloud, Simple Content, and Blank Item.
Let’s first take a look at how to add items to your custom grid, and then check out how to use each of the seven types of content.
Using Individually Selected Content Items
There are two ways you can add items to a custom grid.
The first is to click any one of the seven buttons in the Add Items panel:

A dialogue box labelled Add Element will appear, where you can configure your content item. We’ll cover how to configure each type of content item in just a moment.
After you configure and add your item you’ll see it appear in the grid preview below:

The second way to add an item is to hover over the gray square/rectangle you see at the end of your grid preview:

A black overlay will appear labelled “CHOOSE ITEM”, with four buttons for each of the seven content items. Click one of those buttons to add a new item:

If you’re not sure which of these buttons is which, the icon on each matches the corresponding icon in the Add Gallery Items panel, so you can look at those for reference:

Custom Grid Content Types
Now that you know how to add grid items, let’s have a look at each of the seven types of content and how to configure them.
YouTube
The YouTube item type allows you to insert a specific video from YouTube.
To add a YouTube video first find its ID. The easiest way to do this is usually to visit a YouTube video in a browser, and then copy the string of characters that appears in the URL bar after watch?v=+

Or now with our app you can directly add the link of the youtube video and it will work without any problem at all.

Optionally, click the Choose Image button to browse for and set a custom thumbnail image to appear in the grid:

Then click the black Add Element button at the bottom right:
Adding Media Source Types
After adding a YouTube video item, by default you won’t actually see the video if you preview your grid or add it to a page. Instead you’ll see either an empty space, or a thumbnail if you’ve set one:
The reason for this is because a little extra configuration is needed of what we call Media Sources.
Media Sources are the types of media that are allowed to appear in a grid, e.g. featured images, YouTube videos, HTML5 videos, iFrames, and so on.
By default in a newly created grid, the only type of media that is allowed is a featured image. So when we want to add additional types of media we need to enable those extra types.
So to make your YouTube videos appear, scroll up to the Media Source panel, look in the Item Media Source Order column, and tick the box labelled YouTube video:

Now your YouTube videos will appear in your grid:
Custom Grid Content Types
Additionally, if you wish, you can also look under the Optional Audio/Video Image Order column and check the YouTube Thumbnail box to fetch the video’s thumbnail image.
Setting Media Source Preference Order
In case there might be multiple possible media sources available for a given grid item, you can set which should be preferred by dragging and dropping checked media sources to change their order in the stack:
Essential Grid will first try to display whichever media source is at the top of the stack, then if nothing is found it will look for the second preference, then the third, and so on.

Vimeo
The Vimeo item type is almost exactly the same as the YouTube item type only, as you would expect, you can use it to display a single Vimeo video.
Once again, the first step is to get the link of the video you want to display. Go to the page of the video you want to use and in the browser copy the link
After clicking one of the buttons to add a new Vimeo video, paste the video’s link into the Vimeo Video Link field of the Add Element pop-up, then click the Add Element button:

Now we have to add a new media source, just as we did when adding YouTube video.
In the Media Source panel, check the box labelled Vimeo Video, and optionally the box labelled Vimeo Thumbnail:

Your grid should now have a Vimeo video displaying within it:
Note that by default Vimeo videos don’t have any inline controls, so in order to allow visitors to play the video you may also wish to switch into the Grid Settings tab:
Then look for the Media Playback subsection, and switch Use Controls Inline to Enable:

Now your video will have controls available:
Self Hosted Media
The Self Hosted Media item type allows you to display MP4, OGV and WEBM files you are hosting yourself.
Before using this content type you will need to have uploaded your media to your own hosting, and have its URL ready for use.
After adding a self hosted media item to your grid, paste the URL of your media item into the field that corresponds with its file type, then click the Add Element button:

In the Media Source panel, check the box labelled Shopify Video so your video will show:

As with Vimeo videos, self hosted media does not show controls by default, so for this type of content you may also wish to enable inline controls:
Image(s)
The Add Image(s) item type allows you to add images from your media library to your grid.

The media library will open up. Click the image you want to use, and if you’re adding bulk images hold down your CTRL / CMD key and select additional images. Then click the Choose Images button at the bottom right corner.
Updated on: 25/06/2026