Try PagePilot.ai 100% FREE! No credit card required.
Cover image for How to Add Video to Shopify Product Pages: Uploads, Embeds, and Placement

How to Add Video to Shopify Product Pages: Uploads, Embeds, and Placement

• 13 min min readMilos M - Author

A product video can show customers things that photos can't. How does a backpack open? How much can it hold? What does it look like when someone actually wears it?

The challenge is getting that video onto your Shopify product page in a place where shoppers will see it, without slowing down the page or making it difficult to use on mobile.

You can add video to a Shopify product page in three ways:

Upload it to the product's media gallery.

Add a video section through your theme editor.

Embed a video directly in the product description.

The best option depends on what you're showing and where you want the video to appear.

We'll use Shopify's Dawn theme and a fictional travel backpack to walk through the options. If you're using another theme, some settings and playback features may differ.

Key Takeaways

  • Want to demonstrate your product? Add a short video to the product gallery so customers can watch it alongside the photos.
  • Need more room to explain something? Use a video section farther down the page. Just check whether other products share the same template.
  • Want a video alongside written instructions? Embed it in the product description and make sure it displays properly on mobile.
  • Uploading your own video? Check Shopify's supported formats and file-size limits. YouTube and Vimeo embeds work differently.
  • Ready to publish? Test the video on the live page. Make sure the preview image looks right, captions are available, playback controls work, and the video doesn't noticeably slow down the shopping experience.

Where Should a Shopify Product Video Go?

The best place for a product video depends on what you're trying to show customers. A quick demonstration usually belongs alongside your product photos, while a longer explanation might work better farther down the page.

Let's use our travel backpack as an example.

Say the backpack folds into a small pouch. A 20-second video showing how that works would fit nicely in the product gallery, where shoppers can watch it while browsing the photos.

But what about a longer tutorial showing how to pack the backpack for a weekend trip? That might deserve its own video section below the buying options, where customers can watch without interrupting their shopping.

You can also embed a video directly in the product description if it helps explain something mentioned in the text.

Here's how the three options compare:

You don't need to put the same video in all three places. Choose the spot where customers are most likely to need it.

There's also a difference between uploading a video to Shopify and embedding one from YouTube or Vimeo.

With a direct upload, Shopify hosts the video. With an embed, the video still plays through the external platform, even though customers watch it on your product page.

Both approaches can work. The important thing is choosing a placement that helps shoppers understand the product without making the page harder to navigate.

How to Add Video to a Shopify Product Gallery

To add a video to your Shopify product gallery, open the product in Shopify admin and upload a video file or add a supported YouTube or Vimeo link.

The video will be associated with that product, although your theme still needs to support video playback for customers to see it.

Upload a Video File

Here's how to add a video directly to your product gallery:

Go to Products in Shopify admin and open the product you want to update.

Find the Media section and click Upload new. You can also drag your video into this area. If you've already uploaded it, choose Select existing.

Allow Shopify to finish processing the video. If the upload fails, check the file format and export settings before trying again.

Drag the video into the position you want in the gallery. Save your changes if prompted.

Open the actual product page and check that the video plays correctly on both desktop and mobile.

For our travel backpack, I'd keep a clear product photo as the first gallery image and place the folding demonstration immediately after it.

There's a reason for that.

Shopify uses the first media item as the product's featured media, which can also affect how the product appears elsewhere in your store. Moving the video to the first position could change more than just the order of your gallery.

You'll also want to check the video's thumbnail.

Shopify automatically generates a preview image when you upload a video, but it doesn't always pick the most useful frame.

For example, a thumbnail showing an empty tabletop won't tell customers much about your backpack. A frame showing the backpack folded into its pouch would be much clearer.

To change the thumbnail:

Go to Products, open your product, and find the video under Media.

Select the video and click the pencil icon beside its cover image.

Choose a different image, then exit the preview.

Check the product page to make sure the new thumbnail appears correctly.

You can find more details in Shopify's video thumbnail instructions.

One other thing to know: Shopify's standard variant-media assignment doesn't support assigning videos or 3D models to individual product variants.

So, if your backpack comes in black and blue, don't assume selecting a different color will automatically show a video of that version.

Add a YouTube or Vimeo Video

You don't have to upload the video file directly to Shopify. If you've already published it on YouTube or Vimeo, you can add it to the product gallery using its URL.

Here's how:

Open the product in Shopify admin → Products.

In the Media section, choose Select existing → Add from URL.

Paste the YouTube or Vimeo video link.

Add the video and check that it appears and plays correctly on your product page.

Use the standard video URLs:

  • YouTube: https://www.youtube.com/watch?v=VIDEO_ID
  • Vimeo: https://vimeo.com/VIDEO_ID

For YouTube, the video needs to be Public or Unlisted. Vimeo videos must have embedding enabled.

There's also a small detail that can cause problems: Shopify doesn't accept YouTube Shorts-format URLs in this field. If you're adding a Short, use its corresponding standard YouTube watch URL instead.

And make sure you're pasting an actual supported video URL. An iframe embed address or a Google Drive sharing link won't work as a direct replacement.

Shopify explains the supported methods and requirements in its guide to adding product media.

For a short product demonstration, the gallery is usually the simplest place to start. Customers can watch the video while looking through your product photos, without having to scroll down the page to find it.

How to Add Video to Another Product Page Section

If you want a video to appear farther down your Shopify product page, Dawn lets you add a dedicated Video section through the theme editor.

This works well for longer demonstrations or tutorials that need their own space rather than sitting alongside the product photos.

For our travel backpack, you might use a separate section to show customers how to pack it for a weekend trip.

Here's how to add one:

Go to Online Store → Themes → Edit theme. It's worth duplicating your theme first, especially if you're making several changes.

Open Products → Default product, or select the template your product currently uses.

Click Add section → Video and move it to the position you want on the page.

Choose a video you've uploaded to Shopify or paste a supported YouTube or Vimeo URL. Add a heading, description, and adjust the available playback settings.

Save your changes and preview the product page.

There's one important thing to check before publishing: which other products use the same template?

Say you add the backpack packing tutorial to your Default product template. If your water bottle and phone case also use that template, they may end up displaying the same backpack video.

That's probably not what you want.

To avoid this, preview another product that uses the template. If different products need different video sections, you may want to create separate product templates.

Shopify's template guide explains how to do that.

Keep in mind that if you're working in an unpublished theme, you can preview its new templates there, but they won't necessarily appear in the live product editor's template dropdown until the theme is published.

What If Dawn Shows the Wrong Video or Thumbnail?

There are two Dawn behaviors worth knowing about.

First, if you've selected both a Shopify-hosted video and a YouTube or Vimeo link, Dawn prioritizes the Shopify-hosted video.

So, if you're trying to replace an uploaded video with a YouTube version and the old one keeps appearing, check whether you've cleared the original video source.

Second, Dawn may ignore the Cover image you've selected for the section if your Shopify-hosted video already has its own preview image.

In that case, go back to the uploaded video's thumbnail and check whether that's the image being displayed.

You can see how these settings work in Dawn's Video section code. Other Shopify themes may handle them differently.

Once you've added the video, check the actual product page and at least one other product using the same template. That way, you can be confident the tutorial appears where it belongs without accidentally showing up across your entire catalog.

How to Embed a YouTube Video in a Product Description

You can embed a YouTube or Vimeo video directly into your Shopify product description, right beside the text it helps explain.

This is useful when a video illustrates a specific feature or shows customers how to do something.

For our travel backpack, imagine you've written a short paragraph explaining how it folds into its storage pouch. You could place a video immediately below that paragraph so shoppers can watch the process instead of relying on written instructions alone.

Here's how to add it:

In Shopify admin, go to Products and open the product you want to edit.

Find the Description editor and place your cursor where the video should appear.

Open your video on YouTube or Vimeo and copy its embed code.

Back in Shopify, choose Insert video, paste the embed code, and save.

Open the product page to make sure the video appears and plays correctly.

You can also use the description editor's Edit code option if you'd rather add or inspect the HTML directly.

Shopify covers both methods in its rich-text editor guide.

Make Sure the Video Fits on Mobile

One problem with embedded videos is that they don't always resize properly on smaller screens.

A video might look fine on your desktop but extend beyond the edge of the screen on a phone.

To help avoid that, you can use a responsive embed like this:

<div style="position:relative; width:100%; padding-top:56.25%;">

<iframe

src="https://www.youtube.com/embed/VIDEO_ID"

title="How the travel backpack folds"

loading="lazy"

allow="fullscreen; picture-in-picture"

allowfullscreen

style="position:absolute; inset:0; width:100%; height:100%; border:0;">

</iframe>

</div>

Replace VIDEO_ID with the ID of your YouTube video.

Notice that the URL uses /embed/ rather than the usual watch?v= format. That's because you're embedding the YouTube player, not simply linking to the video.

The code also uses a 16:9 aspect ratio, which works well for landscape videos. If you've filmed a vertical demonstration, you'll need to adjust the ratio.

This is an example of how a responsive embed can work, not code that's been tested with every Shopify theme.

Shopify may also modify some HTML when you save it. Reopen the description editor afterward to check that the code is still there, then test the published page on your phone.

One final thing to consider is privacy.

YouTube and Vimeo videos can display their own branding and load resources from those platforms when someone visits your page.

Make sure your embedding setup is consistent with your store's privacy requirements. Even privacy-enhanced YouTube embeds shouldn't be treated as a guarantee that no information is shared with third parties.

For a short demonstration that belongs alongside written instructions, embedding can work well. Just make sure the player doesn't interfere with reading the description or using the rest of the product page.

Which Video Formats and Limits Does Shopify Support?

Shopify supports MP4, MOV, and WebM videos for direct product uploads, with a maximum length of 10 minutes, a file size of 1 GB, and a resolution of 4K (4096 × 2160).

You don't need to convert every video to MP4 before uploading it. Shopify can process MOV and WebM files and deliver them using MP4 or HLS playback formats.

These limits apply to videos uploaded directly to Shopify. If you're embedding a video from YouTube or Vimeo, those platforms have their own requirements.

There's also a limit on how much media you can attach to a product.

Each Shopify product can have up to 250 media items in total, including images and videos. Shopify also has store-wide limits for video counts and storage that vary by plan.

If you're planning to upload lots of videos, check Shopify's latest documentation on product media types and adding product media before getting started.

One thing worth remembering: just because Shopify accepts a 1 GB video doesn't mean you should upload one that large.

For our travel backpack, a short demonstration of how it folds into its pouch probably doesn't need a huge file. You want the footage to look clear without making customers download more data than necessary.

The ideal file size depends on the video's length, resolution, and how much movement you're showing.

And if Shopify rejects your upload, check the actual video encoding before trying again.

Simply renaming a .mov file to .mp4 won't convert the video. The underlying format remains unchanged, which can cause upload errors. Shopify specifically warns against this. Restore the original extension or use video conversion software to export a compatible file.

How Do You Keep Video From Slowing the Product Page?

Keep your product videos short, compress the files, and avoid loading the video player before someone needs it. A useful demonstration shouldn't make customers wait longer to browse your store.

Start with the footage itself. For our travel backpack, a 20-second clip showing how it folds into its pouch is probably enough. Cut anything that doesn't help explain the product, and export the video at a reasonable file size without sacrificing too much picture quality.

It's also worth choosing a good thumbnail. Show the backpack folded into its pouch so customers know what they'll see before pressing Play.

How the video loads matters just as much as the file size.

In Shopify's Dawn theme, the built-in Video section displays a preview image first. The actual player doesn't load until someone activates it.

That's different from pasting a YouTube video directly into your product description, where the embedded player may begin loading resources as soon as the page opens.

If you're using an embedded video farther down the page, adding loading="lazy" to the iframe can help delay loading until the customer gets closer to it.

You could also use a setup where the video player loads only after someone clicks the thumbnail, provided your theme supports it or a developer can implement it.

And don't assume that embedding a YouTube video automatically makes your page faster. YouTube handles the video hosting, but its player can still load extra scripts and make network requests.

So, how do you know whether your video is affecting page speed?

Test the same product URL before and after adding it, ideally under similar mobile conditions. Use PageSpeed Insights to check whether loading times or responsiveness have changed.

Google's video performance guide explains why third-party video players can add overhead, even when the video isn't hosted on your store.

For other ways to improve loading times, see our Shopify speed optimization guide.

The goal is to let customers watch the video when they want to, without making everyone else wait for it to load.

What Should You Check for Mobile Playback, Captions, and Autoplay?

Before publishing, watch your product video on an actual phone and make sure customers can play it, follow what's happening, and get back to shopping without any trouble.

Start with the basics. Play the video, pause it, and try watching it in fullscreen. Check the volume controls if they're available.

Then look at how the player fits on the page. Does the video get cut off at the edges? Does it force you to scroll sideways? Does it overlap the size selector or Add to Cart button?

These problems are easy to miss when you're only checking the desktop version of your store.

Don't Rely on Autoplay

You might want your product demonstration to start playing as soon as someone opens the page, but autoplay doesn't work consistently across browsers.

Most browsers restrict videos that try to play automatically with sound. Muted videos may autoplay, but that depends on the browser and its settings.

For a demonstration customers actually need to watch, a clear Play button is usually the safer choice.

MDN's autoplay guide explains these restrictions in more detail.

Make Sure Customers Can Follow the Video Without Sound

Captions are worth adding, especially when your demonstration includes spoken instructions.

How you add them depends on where the video is hosted.

For videos uploaded directly to Shopify, Shopify's captioning guide recommends adding readable captions to the video file before uploading it.

These are known as burned-in captions. They're part of the video itself, so customers can't turn them off.

YouTube and Vimeo support separate caption tracks, which you can review and edit through their platforms. Customers can then turn those captions on or off where the player supports it.

But captions alone won't explain everything happening on screen.

Think about our travel backpack. If the video silently shows someone releasing a hidden fastening, captions won't necessarily explain where that fastening is or how it works.

A short written explanation beside the video can help customers understand those details without having to replay the clip.

For more ways to check your product pages on smaller screens, see our Shopify mobile optimization guide.

Product Video Checklist Before Publishing

Once you've added the video, go through these checks:

  • Correct product: Does the video appear on the intended product page without showing up on unrelated products that share the same template?
  • Thumbnail: Does the preview image clearly show what the video demonstrates?
  • Gallery order: Have you accidentally changed the product's featured image?
  • Playback: Can customers play, pause, adjust volume, and watch in fullscreen where those controls are supported?
  • Captions: Are they readable and accurate? Is there enough written information to understand important visual steps?
  • Mobile layout: Does the video fit the screen without covering product options or buying buttons?
  • Page performance: Does the page still load and respond properly after adding the video?

Don't just check that the video appears. Watch it as a customer would, then try selecting a variant and adding the product to your cart.

The video should make buying decisions easier, not introduce another obstacle between customers and checkout.

Why Isn't My Shopify Product Video Showing or Playing?

If your Shopify product video isn't working, start by checking how you added it. A video uploaded directly to Shopify can fail for different reasons than one embedded from YouTube or Vimeo.

Here are the most common problems and what to check.

  • Your video is stuck processing. First, check the product's Media section and Content → Files. Sometimes Shopify finishes uploading a video even though a warning still appears. If it genuinely hasn't processed, look for an error message and check the video's encoding, file size, and your store's upload limits before trying again.
  • The video appears as a regular file instead of a playable video. The file might not be encoded in a supported format. Check that its extension matches the actual video format. Simply renaming a file from .mov to .mp4 won't fix an encoding problem. You'll need to export it properly.
  • Your YouTube or Vimeo video won't load. Make sure you've used the correct URL. Shopify's product Media field expects a supported YouTube watch URL or Vimeo video link, not an iframe embed address. Also check that the video is publicly accessible or has permissions that allow embedding.
  • Dawn keeps showing the wrong video. If you're using Dawn's Video section, check whether an older Shopify-hosted video is still selected. Dawn prioritizes that file over an external YouTube or Vimeo link, so you'll need to clear the old source before switching.
  • The video works in Shopify admin but doesn't appear on your product page. Check whether your theme supports product videos and whether you're editing the correct product template. If you've installed an app that changes the product gallery, it could also be affecting how videos display.
  • The video gets cut off or stretches beyond the screen. This is usually worth checking in the player's layout settings. A vertical video placed inside a landscape container, for example, may not display as intended. You might need a different aspect ratio or responsive embed styling.

Before reinstalling an app or editing your theme code, check the video source and where it's supposed to appear.

If the file itself isn't processing, start with the upload. If the video plays in admin but not on your storefront, look at the theme. And if only an embedded video is causing problems, check its URL, permissions, and player settings.

That should help you narrow down the problem without changing parts of your store that are already working.

Verify the Finished Product Page

Before publishing, open the backpack page and one unrelated product. Check that the video appears only where intended, then complete a permitted cart test on mobile. For changes to the wider layout, PagePilot's product page customization guide covers additional options. The video itself should still be placed through Shopify's supported media controls or a compatible external player; PagePilot's published documentation doesn't establish native video hosting.

Last updated: