Skip to main content

How to set Vimmi PDP Video Widget?

Updated today

In this article, you’ll learn how to set up and display the PDP Video Widget on your Shopify store.

This widget automatically shows product-specific videos on each Product Detail Page (PDP) — helping your customers see the right content for every product.

By the end, you’ll know how to:

  • Enable the PDP widget on your storefront,

  • Link products and videos in the editor,

  • Troubleshoot visibility issues.


Main Steps

  1. Install the Vimmi Shopify App.

  2. Upload at least one video. - How to upload a new video

  3. Mark products as Featured.

  4. Enable the App Embed in Shopify.

  5. Add the PDP section to your Product template.

  6. Save and preview on your storefront.


Prerequisites

Before adding your PDP widget, make sure you have:

  • The Vimmi app installed in Shopify.

  • App Embeds are ON for your theme.

  • At least one uploaded video. - How to upload a new video

  • If you plan to import from social platforms, connect your accounts first.

  • (Strongly recommended) In the Vimmi Video Editor, attach the product and mark it Featured.

The PDP widget automatically displays videos from product-specific playlists.

To ensure the correct video appears, mark your product as Featured in the video editor.

If nothing is Featured, the PDP won’t know which video to display.


Step 1: Add the Vimmi Widget to Your Product Detail Page

  • Log in to your Shopify admin console and open the theme customizer

  • In Shopify Admin → Online Store → Themes → Customize, open your active theme.

  • In the theme editor, use the page selection dropdown in the header to select Default Product.

  • Add the widget as a section/block

  • Click Add section (or Add block inside the product template) and select Vimmi PDP Video Widget.
    If the widget isn’t visible, ensure your theme supports application blocks on the product detail page.

  • Position the widget

  • Drag-and-drop to the desired location (under the image gallery, below description, after reviews, etc.).

  • Tip: keep it above the fold for higher engagement.

  • Save your changes

  • Click Save (top-right) in the customizer.

Important: If no video is assigned (Featured) for that product, the player won’t appear on the product’s page. See Mark products as Featured.


Step 2: Assign a Video to a Product Page

Adding the block alone won’t show anything unless you link a video to the product.

  • In your Shopify Admin → Apps → Vimmi Video Commerce.

  • Click Add video Go to Videos → Add video and upload (MP4/MOV/WEBM).


About Product Playlists

When you attach a product to any video and Save, Vimmi automatically creates a Product Playlist for that product. This playlist collects all videos linked to the same product, so you can manage them in one place.

1) Find your Product Playlists

  1. Open Vimmi Console → Videos → Product Playlists.

2. Each playlist is named after the product (you can rename it). Click a playlist to manage it.

2) Add videos to a Product Playlist

  1. Inside the playlist, click the “+” tile (Add).

2. In Select videos or playlist, choose one or more videos and click Add.

3. Click Save.

3) Remove videos from a Product Playlist

  1. Open the product’s playlist.

  2. On the video tile, click Remove.

3. Save.

4) Rename playlist name or poster

  • In the right panel, set Playlist name or PosterSave.


How Product Playlists relate to PDP

  • PDP Video Widget: shows the Featured video for that product. Change the default by setting another video as Featured in the video editor

  • Other widgets: You can also surface a product’s entire playlist in Video Mall or Video Carousel to show multiple angles


Common questions

  • Do I need a playlist to show one video on PDP?

    No. PDP uses the Featured video mapping. The playlist just organizes all videos tied to the product.

  • What if the widget doesn’t show on PDP?

    Check that the product is attached to the video and Featured, and that the PDP section/block is added in Shopify


Troubleshooting

Widget doesn’t show

  • Confirm App Embeds are ON

  • Ensure you added the block/section to the Product template (not Home/Collection)

Video not mapping to the product

  • In the video editor, the product must be attached and Featured

    Changes not visible:

  • Clear Shopify theme cache.

  • Test in an incognito window.

Layout issues:

  • Adjust block position in Theme Editor.

  • Check container CSS for conflicts.


Common Questions

Do I need a playlist for PDP videos?

No — PDP Widget automatically maps videos marked as Featured to products.

A playlist is optional for managing multiple videos per product.

Can the PDP widget work on Collection or Home pages?

No — it only works on Product templates.

How can I check what video will play on a product page?

Go to the Video Editor → Product playlists in your Vimmi Console.

Q&A Summary

Q: What does the PDP Video Widget do?

A: It automatically displays product-specific videos on product pages using the Featured tag.

Q: How to add the PDP Widget to a page?

A: In Shopify → Themes → Customize → Add section → Apps → Vimmi PDP Video Widget.

Q: Why my video doesn’t appear?

A: Check App Embeds, Featured mapping.

2.703.34

Related articles

Did this answer your question?