Getting Started

Videoselz adds shoppable video carousels, stories, floating (picture-in-picture) videos and fullscreen (watch page) to your Shopify storefront. Once set up, shoppers can watch videos, tap featured products, and add to cart without leaving the video.

Setup takes three steps: add the app block to your theme, upload videos and tag products, then create playlists for each placement. (The Create your first Playlist checklist on the app's home screen lists the same three steps with Add app block last — you can do them in either order.) If you keep Add videos to product playlist checked while tagging, you can skip playlist setup for product pages — but you still need a playlist for your homepage (and for collection pages when you use that block).

---

Before you begin

• Videoselz requires a Shopify Online Store 2.0 theme (e.g., Dawn, Sense, Craft, or any theme released after 2021). If you're on a vintage theme, see Vintage themes.
• Shopify doesn't allow video uploads on its free trial plans, so your store needs a paid Shopify plan to upload videos.
• The app must be installed from the Shopify App Store before proceeding.

---

Step 1: Add the app block to your theme

The app block is what makes videos appear on your storefront. You add it separately for each page type — homepage, product pages, and collection pages — depending on where you want videos to show.

1. In Videoselz, click Add app block in the Create your first Playlist checklist on the home screen.

2. A panel opens with three page types:

   Page type	What it does
   Homepage	Shows videos on your store's main page
   Product pages	Displays videos on individual product pages
   Collection pages	Adds videos to collection listing pages

   

3. Click Activate next to each page type you want. Each button opens your Shopify theme editor in a new tab with the Videoselz block pre-loaded. Videoselz always opens your store's currently published (live) theme — the one customers see.

   Optional — adding the block to a different theme
   Use this only if the carousel should live on a draft or unpublished theme, or any theme other than the one Activate opens.

   1. In Shopify admin, go to Online Store → Themes.
   2. On the theme you want, click Customize.
   3. Use the top bar to open the matching template (Home page, a product page, or a collection page).
   4. Click Add block (or Add section, depending on your theme) where the carousel should appear, then under Apps select Videoselz Carousel.
   5. Click Save. The block shows the playlist for that page automatically.

   

4. In the theme editor, find the Videoselz Carousel block that was added to the page. Customize it as needed, then click Save.

5. Return to Videoselz and click Refresh in the panel to confirm the block is active. Enabled page types show ✓ Active.

   

Tip: You don't need to enable all three page types at once. You can add more later from the same panel.

---

Step 2: Upload videos and tag products

All videos live in the Video Library. Tagging products is what makes a video shoppable — tagged items appear as tappable product cards so shoppers can view details or add to cart from the player.

Upload a video

1. Navigate to Library in the left sidebar.

2. Click Upload video and choose a source:

   • Upload from device — drag and drop files, or click to browse. Multiple files can be uploaded at once. Use MP4 or MOV (H.264 or H.265).
   • Upload from Shopify — import videos already in your Shopify Files.
   • Import from Instagram or Import from TikTok — bring in videos from those platforms.
   

3. Videos process automatically. Once ready, they appear in the library with a thumbnail and duration.

   

Tag products to a video

1. Click + Tag Product on any video in the library (if the video already has tags, click +).

   

2. Search for products by name and select the ones featured in the video. The Free plan allows 2 tagged products per video; Pro is unlimited.

3. Keep Add videos to product playlist (Recommended) checked (it's on by default). That setting is what lets those product pages show this video. With it checked, you can skip Step 3 entirely for product pages — Videoselz attaches the video to each tagged product's playlist automatically.

4. Click Save tag. Tagged products will appear as product cards alongside the video in your storefront.

   

A video without tagged products will still play in the carousel — it just won't show product cards.

If Videoselz is only on product pages and you always leave Add videos to product playlist checked, you can skip Step 3 entirely. For homepage or collection placements, you still create playlists below.

---

Step 3: Create a playlist

For product pages, this step is optional when Add videos to product playlist was checked while tagging — you only need it there if you unchecked that option and want to build or edit the product playlist yourself.

Homepage and collection pages always need a playlist you create here; the tagging checkbox does not replace that.

A playlist is a collection of videos assigned to a specific page. Each page can have one playlist.

1. Navigate to Video Pages → Add video to page (or click Create Playlist in the home checklist).

2. In Choose a Page to Display Your Playlist, select where this playlist will appear:

   • Homepage
   • A specific product page (search by product name)
   • A specific collection page (search by collection name)
   

3. In the Choose Videos section, select the videos to include. At least one video is required. The Free plan allows 10 videos per playlist; Pro is unlimited.

   

4. Click Save in the save bar at the top of the page.

After saving, you land on the Playlist videos page where you can reorder videos by dragging, click Add videos to this playlist, and click Open on storefront to see the carousel live.

---

What's next

Once the app block is active, your videos are tagged, and every placement you use has a playlist (or product playlists from tagging), your carousel is live. From here:

• Collection playlists for products — On a collection playlist, turn on Show this playlist on products pages in this collection that don't have their own videos so the same videos show for all products in that collection, without setting up each product one by one.
• Carousel setup — create and manage your carousels and playlists, choose videos, and configure layout and playback for the storefront.
• Settings → Carousel — customize the carousel appearance: play button style, product card colors, captions, vignette, shadows, fonts, and custom CSS.
• Settings → General — configure price display (decimals, compare-at pricing, discount badges) and the Shop Now button color.
• Settings → Quickview — adjust the product card that appears when a shopper taps a tagged product.
• Analytics — track video clicks, add to carts, orders and revenue from your videos.

---

Troubleshooting

The carousel isn't showing on my storefront. Confirm the app block is enabled for that page type (Home → Add app block → check for ✓ Active). Also verify a playlist has been created and assigned to that page.

I enabled the app block but the carousel is empty. A playlist must be assigned to the page. Navigate to Video Pages → Add video to page and assign videos to the page.

I'm on a vintage (non-2.0) theme. Vintage themes don't support app blocks, so Videoselz needs an Online Store 2.0 theme. See Vintage themes, or email help@videoselz.com.