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
Install the Vimmi Shopify App.
Upload at least one video. - How to upload a new video
Mark products as Featured.
Enable the App Embed in Shopify.
Add the PDP section to your Product template.
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
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
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
Open the product’s playlist.
On the video tile, click Remove.
3. Save.
4) Rename playlist name or poster
In the right panel, set Playlist name or Poster → Save.
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
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&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.
Related articles