Video: popup section
The Video: popup section shows an image with a play button in Kingdom that plays a YouTube or Vimeo video in its place when selected.
Applies to: Kingdom 6.2.0 and later. Added in: Kingdom 2.0.0. Last checked: 2026-10-13 against Kingdom 6.2.0.
The Video: popup section shows an image with a large play button and an optional heading and text. When a customer selects it, a YouTube or Vimeo video loads in place of the image and starts playing.
Where to find it: select Add section in the theme editor, then choose Video: popup (Add section category Media & galleries).
Setting up the video link
Add the section
In the theme editor, select Add section and choose Video: popup.
Paste the video link
Open the video on YouTube or Vimeo, copy the link from the browser's address bar, for example https://www.youtube.com/watch?v=xcJtL7QggTI, and paste it into Video URL. Shopify accepts only YouTube and Vimeo links in this field.
Choose the cover image
Upload a Background image. It shows under the play button until the video starts, in a 16:9 frame, cropped around its focal point.
Test it
Select Save, open the page in the storefront and select the play button. The video replaces the image and plays with sound, inside the same frame.
Use the video's complete link in this format: https://www.youtube.com/watch?v=xcJtL7QggTI. If a share link (https://youtu.be/…) or a link with extra parameters does not load, replace it with the complete link.
Image and text
- The section has two blocks, each used once: Heading (with Heading size Regular, Large or Extra large, and a Heading tag) and Text. The Text block also shows a Heading size setting, but in Kingdom 6.2.0 it does not change the text.
- The heading and text sit on the image, next to the play button. The whole image, text included, starts the video.
- Custom text color sets the color of the text and the play button. Background overlay lays a color over the image at 36 percent opacity, so light text stays readable.
- Enable inner content spacing (default off) adds side padding around the section. See General section settings.
Why does my video not load?
Because the link is not one Shopify can read, or the video does not allow embedding. Check these in order:
- Video URL holds the complete link from the address bar, such as
https://www.youtube.com/watch?v=…orhttps://vimeo.com/…. - The video is public or unlisted on YouTube, and embedding is allowed in its YouTube or Vimeo settings. Private videos never play on other sites.
- A browser extension or a cookie banner does not block YouTube or Vimeo on your store.
Can I use a video uploaded to Shopify?
No. The Video: popup section plays only YouTube and Vimeo links. For a video file uploaded to Shopify, use the Video: background section, which plays it muted in a loop.
All Video: popup settings
Every setting in this group, with its type and default.
Accepts these blocks: Heading and Text.
Video URL (video URL, default: https://www.youtube.com/watch?v=_9VUPq3SxOc): Sets the YouTube or Vimeo link of the video. Selecting the section loads the video in place of the image and starts it.
Background image (image): Shows under the play button until the video starts, in a 16:9 frame.
Video: popup section: Colors
Where to find it: Video: popup → Colors
Custom text color (color, default: transparent): Sets the color of the heading, the text and the play button.
Background overlay (color, default: transparent): Lays this color over the image at 36 percent opacity.
Video: popup section: Gutter
Where to find it: Video: popup → Gutter
Enable inner content spacing (checkbox): Adds side padding around the section and a space below it. Off, the image runs edge to edge.
Heading block
Where to find it: Video: popup → Add block → Heading
One Heading block per section.
Heading (text field, default: "Talk about your brand").
Heading size (dropdown, default: Regular). Options: Regular, Large, Extra large.
Heading tag (dropdown, default: H2): Specify heading level to help search engines index the structure of your page. Options: H1, H2, H3, H4, span.
Text block
Where to find it: Video: popup → Add block → Text
One Text block per section.
Text (rich text, default: "Use this text to share information about your brand with your customers. Describe a product, share…").
Heading size (dropdown, default: Regular): Has no effect in Kingdom 6.2.0: the text keeps the body size whatever you choose. Options: Regular, Large, Extra large.
Related pages
- Video: background section: a muted, looping video behind text.
- Troubleshoot images and videos: more answers about videos.
- General section settings: custom colors and inner content spacing.
Video: background
The Video: background section plays a muted, looping video behind a heading, text and button in Kingdom, with a fallback image.
Product page
The Product page section of Kingdom: the media gallery, its zoom and video options, and the blocks that show product details, variants and buy buttons.