Documentation

Setup guide & tutorial

Everything from install to your first attributed sale — with screenshots at every step. Total setup time: about 5 minutes.

Jump to: Adding videos · Tagging products · Theme editor · Selling tools · Embed anywhere · Statistics · Launch checklist

Step 1

Add your videos

1

Install and open Virally

Add Virally from the Shopify App Store. It asks only for read access to your products — it never writes to your catalogue or theme files. After install the app opens on the Videos page.

2

Paste a TikTok or YouTube link

Copy any public TikTok or YouTube link (regular videos and Shorts both work), paste it into the Add a video box and press Add. Virally pulls in the thumbnail and author automatically — no API keys, no social login.

3

Or import a whole list at once

Press Bulk import to paste many links (one per line). A YouTube channel URL (…/@yourhandle) or a playlist URL automatically adds its latest videos — up to 40 per import.

Virally add-a-video box with URL field, Add button and Bulk import link
The Add a video box — paste one link, or bulk import a whole channel.
Step 2

Tag the products each video shows

1

Press “Tag products” on a video card

Every video you add appears as a card. Press 🏷️ Tag products and pick the items that video features. These become the tappable buy buttons under the video on your storefront — shoppers can add them to the cart without leaving the page.

2

Choose where each video appears

The Home page / Product pages toggles control placement. A video marked for product pages automatically shows up only on the pages of the products you tagged in it.

3

Refresh or remove

Refresh re-fetches the thumbnail and author from the platform. Remove deletes the video from your store (the original clip on TikTok/YouTube is untouched).

Virally video cards with tagged products, placement toggles and Tag products buttons
Video cards: tagged products, placement toggles, refresh and remove.
Step 3

Put it on your storefront (theme editor)

1

Add the block

Open Online Store → Themes → Customize. On the page where you want the wall (usually the home page) press Add section → Apps (or Add block → Apps) and choose “Shoppable videos”. Press Save — that’s the only required step.

2

Pick a layout and order

In the block settings choose one of 10 layouts — Grid, Carousel, Stories bar, Hero, Marquee, Spotlight, Full-screen feed, Reels, Masonry or Bento. Set Order videos by to Best performing first and your highest-converting videos automatically move to the front.

3

Fine-tune the look

Width & alignment — center, left or right, a max-width slider or full width. Videos shown before “Show more” — how many load at first (the button reveals more). Button colour matches your brand. On Starter and Growth you can also customise the TikTok/YouTube badge on each thumbnail — position, size and colour.

Shoppable videos block settings in the Shopify theme editor: layout, columns, width, alignment, badge customisation
The block settings in the theme editor — everything is visual, no code.

Product pages & badges

Product videos block: in the theme editor switch the top dropdown to Products → Default product, press Add block → Apps and choose “Product videos”. Each product page then shows only the videos tagged with that product.

“As seen on TikTok” badges: open App embeds (the puzzle icon on the left), switch on “As seen on TikTok badges” and save. Tagged products across your collections get a small badge automatically.

Floating video bubble (Growth): switch on the “Floating video bubble” app embed once, then control it from the app under Settings — on/off, position and label.

Step 4

Turn on the selling tools

Open Settings in the app. These three mechanics run inside the video player and turn views into orders.

1

“Goes well with” upsell

The moment a shopper adds a product from a video, the player offers up to 3 related products they can add in one tap. Recommendations come from Shopify. On by default.

2

“🔥 X bought from this video” proof badge

Shows the real number of orders each video generated — on its thumbnail and inside the player. It is counted by Virally’s revenue attribution, so it is never fake. Set the minimum orders before it appears (default 3).

3

“Watch & unlock” discount (Starter+)

Create a discount code in Shopify admin under Discounts, then paste it here and choose how many seconds of watching unlock it. Shoppers who watch get the code in the player — a direct reason to buy now.

Virally Settings page with upsell, proof badge and watch-and-unlock discount controls
Settings → Selling tools: upsell, real social proof and watch-to-unlock discounts.
Reach beyond your store

Embed shoppable videos on any website

Put your videos — with tappable product links — on a blog, a landing page, a forum or your Shopify blog. Shoppers watch anywhere and land on your product pages to buy.

1

Open the embed code

On any video card in the Videos tab, press Embed. A window opens with two boxes.

2

Copy box 1 — the embed code

This is a single <iframe>. It works everywhere on its own, and its height is already sized to fit the products you tagged in that video. Paste it wherever you can add HTML.

3

Copy box 2 only if your site allows scripts (optional)

A tiny auto-resize <script> that makes the height fit perfectly. Add it next to the embed on sites that allow scripts. Skip it on sites that strip scripts (many blogs and forums) — the embed still works fine without it.

Where it worksWhat to paste
Your own website / a website builder (Webflow, WordPress, etc.)Box 1, plus Box 2 for a perfect fit
A Shopify blog article (or a page with a custom-HTML section)Box 1 (Box 2 optional)
A forum or comment that allows HTMLBox 1 only

The product buttons in an embed open your storefront product pages in a new tab (with a tracking tag), so you keep the sale. Every embed also carries a small link back to Virally, which helps more people discover shoppable video.

Step 5

Read your statistics

Open Activity in the app — this is where you see whether the videos actually sell.

MetricWhat it means
RevenueMoney from orders that started with an in-player “Add to cart” — attributed to the exact video that drove them
OrdersNumber of those attributed orders
ViewsHow many times shoppers opened your videos on the storefront
Shop clicksTaps on the product buttons under a video
Click rateClicks ÷ views — how convincing a video is
Virally Activity dashboard with revenue, orders, views, clicks and a top-videos table
Activity: totals on top, then every video ranked by the revenue it makes.

The monthly views bar tracks your plan’s soft limit. It is soft on purpose — your storefront never stops showing videos; if you regularly exceed it, a higher plan simply fits your traffic better.

Before you call it done

Launch checklist

  1. 1

    Videos added and tagged

    At least a few videos in the app, each with 1+ tagged products.

  2. 2

    Block saved in the theme

    “Shoppable videos” added via the theme editor and the theme saved — this is the step people miss most often.

  3. 3

    Open your storefront and tap a video

    It should play instantly and show the tagged products underneath.

  4. 4

    Test Add to cart

    Press the product button in the player — the item should land in the cart and the cart should update without a page reload.

  5. 5

    Check the extras you enabled

    Badges on tagged products, the unlock discount after watching, the floating bubble (Growth).

  6. 6

    Come back to Activity in a few days

    Views, clicks and the first attributed orders appear as shoppers use it.

Reference

Where things go

SurfaceWhat it doesWhere to add it
Shoppable videos blockA tappable wall of your videos; 10 layouts, “Show more” batchingTheme editor → Add section/block → Apps
Product videos blockShows only the videos tagged with that productProduct template → Add block → Apps
“As seen on TikTok” badgesA small badge on products that appear in a videoTheme editor → App embeds
Floating video bubbleA tappable bubble that opens your shoppable feed (Growth)App embeds once, then app → Settings
Troubleshooting

If something does not appear

I added videos but nothing shows on my store

Check the block first: Online Store → Themes → Customize → Add block → Apps → Shoppable videos must be added to the page and the theme must be saved. This accounts for almost every case.

A video shows as unavailable

The source clip was made private or deleted on TikTok or YouTube, so its embed no longer resolves. Remove that link in Virally, or make the original public again.

Products are not tappable in a video

Open that video in the Virally app and confirm you have tagged at least one product. Only tagged products appear as shoppable buttons under the clip.

The unlock discount never appears

In app → Settings the “Watch & unlock” switch must be on and a discount code entered — without a code nothing is shown. It appears once per browsing session after the set number of seconds; afterwards it collapses into a small 🎁 button in the player.

The badges are not showing on featured products

The badge surface is a separate switch: Online Store → Themes → Customize → App embeds → As seen on TikTok badges must be on, and the theme saved.

The floating bubble is not showing

Two switches control it: the “Floating video bubble” app embed in the theme editor (one-time), and the master switch in app → Settings. It is a Growth-plan feature, and it needs at least one video marked for the home page.

How do I remove Virally completely?

Remove the blocks in the theme editor, or uninstall the app. Uninstalling deletes the stored video links and their oEmbed data and all shop data from our servers. Nothing was written into your theme files, so nothing is left behind.