Skip to main content

How to embed Vimmi widgets on your Shopify storefront?

2.703.34

Updated over 3 weeks ago

In this article

Want to boost engagement and sales on your Shopify store?

With Vimmi widgets (Solo Video Widget, Video Mall Widget, Video Carousel Widget, and PDP Video Widget), you can display shoppable videos directly on your storefront — no coding required.

By the end of this guide, you’ll be able to embed your videos, customize their layout, and verify they display correctly on your Shopify store.


Main Steps

  1. Install the Vimmi Shopify App

  2. Upload at least one video → How to Upload a New Video

  3. Create and configure an embed → How to Set Up the PDP Video Widget

  4. Add your Website Destination (Shopify domain)

  5. Turn ON Vimmi App Embed in your Shopify theme

  6. Add widgets using App Section or Custom Liquid method

  7. (Optional) Add a PDP Video Widget to product pages

  8. Save and test your storefront


Prerequisites

  • Install the Vimmi Shopify App

  • Upload at least one video to Vimmi. See How to upload a new video

  • Create a playlist if you plan to use Video Mall or Carousel.

  • Create and configure an embed in Vimmi (Solo Video / Video Mall / Carousel / PDP).

  • Website Destination: your Shopify domain is added automatically.

⚠️ Important about default embeds: Vimmi automatically creates default embeds, but they will not appear on storefront unless replaced with a playlist or video created by you.

Tip: Always Save your embed in Vimmi before copying the Embed code.


Turn on Vimmi in App Embeds

  • In Shopify Admin → Online Store → Themes → Customize.

  • Open the left sidebar → App embeds.

  • Toggle Vimmi Video Commerce to ONSave.


Method A — Add widgets via App Section (recommended)

This is the easiest, no‑code path.

  • Online Store → Themes → Customize.

  • Go to the page you want (Homepage, Collection, Product, etc.).

  • Click Add section.

Add section.png

  • Pick a Vimmi widget:

    • Vimmi Carousel — slider with multiple videos.

    • Vimmi Solo Video — single shoppable video.

    • Vimmi Video Mall — multi‑tab gallery powered by playlists.

Vimmi widgets.png

  • Adjust section options if your theme exposes them; the visual settings come from Vimmi embed config.

  • Save and preview.

Demo store.png

Need a refresher on widget types? See:


Method B — Add widgets via Custom Liquid (embed code)

Use this when you want full control or when a theme section is not available.

  • Create a new embed (Video Mall / Video Carousel / Solo Video) or open an existing one.

Create a new embed.png
  • Configure it (name, width/height, corners, fit mode).

  • Add your Website Destination.

Add your Website Destination.png
Click Embed code.png

In Shopify Customize:

  • Click Add section (or Add block) → Custom liquid.

  • Paste the entire embed snippet into the code field.

Paste the entire embed snippet into the code field..png

  • Position the block where you want it and Save.

Preview Shopify.png


Add a PDP Video Widget to product pages

The PDP Video Widget works only on Product pages. It automatically shows the product-specific video where that product is marked as Featured.

Upload or assign a video → mark product as Featured → widget will display automatically on that product’s PDP.

Steps:

  • 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.

1 Default Product.2.703.34.png
2 Default Product.2.703.34.png

  • 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.

Vimmi Product Page Video Widget. 2.703.34.png

  • 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.

Position the widget 2.703.34.png

  • Save your changes

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

⚠️ If no video is assigned to that product → widget will not show.

To check what videos will appear on each PDP, review your Product Playlists in Vimmi Console → How to check Product Playlists.

pdp 2.703.34.png

Best practices

  • Use optimized posters for brand consistency.

  • Test layouts on mobile (tap targets, performance).

  • Keep the PDP widget above the fold for better engagement.


Troubleshooting

Widget not showing

  • Ensure the embed was Saved before copying.

  • Confirm Publish is ON in Vimmi.

  • Verify App embed is ON in Shopify

  • Check Website Destination contains your shop domain

  • Make sure a specific widget is selected in the editor — empty widget configs won’t display.

  • Ensure you haven’t reached your plan limits (views quota).

  • Paste the full snippet (script + <vimmi-watch-player-widget>), quotes intact.

Layout / sizing issues

  • Adjust Width / Height / Fit mode in the embed.

  • Inspect theme CSS; ensure parent container isn’t constraining the block.

Changes not appearing

  • Clear cache or test in incognito.

  • Save in both Vimmi and Shopify.


FAQ

Q1: Can I use multiple Vimmi widgets on the same page?

Yes — include the <script> once, then add multiple <vimmi-watch-player-widget> tags for each section.

Q2: Do I need to toggle Vimmi again for draft themes?

Yes, each Shopify theme (Live or Draft) has its own App Embed toggle.

Q3: Why doesn’t the PDP Video Widget appear?

It will only appear if at least one video is linked and marked Featured for that product in Vimmi.

Q4: Can I edit widget styling in Shopify?

You can style the section container in Shopify, but widget internals are managed in Vimmi Console.


Related articles

Did this answer your question?