Shopify App · Merchant Guide

PopupVideo

Turn quiet store pages into conversions with floating video, GIF, and image popups. This guide walks you through installing, building, targeting, and measuring your popups — no code required.

01What is PopupVideo

PopupVideo (shown on your storefront as BubblePop) is a Shopify app that adds a small floating "bubble" to your store. Shoppers tap it to expand a video, GIF, or image popup — with an optional call-to-action button that links them straight to what you're selling.

You control everything from the app's dashboard inside Shopify admin: what the popup shows, how it looks, which pages it appears on, when it triggers, and how it's performing.

Video, GIF & image popups

One media item per popup, played in a floating card or full-screen player.

Four corner positions

Place the bubble in any corner with per-edge pixel offsets.

Page targeting

Home, product, collection, cart, checkout, and account pages.

Smart triggers

Show after a delay, on scroll depth, or on exit intent.

📈

Live analytics

Views, clicks, CTR, revenue, and conversion rate over 30 days.

Multiple media sources

Shopify Files, YouTube, DailyMotion, or any image URL.

02Setup in 4 steps

From a fresh install to a live popup takes four steps. The order matters — a popup will not appear on your storefront until the theme embed is enabled and your popups are synced.

  1. Install PopupVideoAdd the app from the Shopify App Store. It opens inside your Shopify admin under Apps → PopupVideo.
  2. Choose & activate a planPick Starter, Pro, or Scale on the Plans & billing page. Every new store gets a 3-day free trial. You must have an active plan to create or edit popups.
  3. Enable the theme app embedTurn on the BubblePop embed in your theme so the popup code can load on your storefront. See Enable the theme embed.
  4. Build a popup & syncCreate your first popup, target a page, set it to Active, then use Sync to storefront. Your popup is now live.
Quick checkOpen your storefront in a new tab after step 4. If the bubble doesn't show, jump to Troubleshooting.

03Enable the theme app embed

The app embed is what actually injects the popup onto your live storefront. It only needs to be enabled once per theme.

  1. Open the theme editorIn Shopify admin go to Online Store → Themes, then click Customize on your active theme.
  2. Open App embedsClick the App embeds icon in the left toolbar (the puzzle / app icon).
  3. Turn on BubblePopFind BubblePop · PopupVideo in the list and flip the toggle on.
  4. SaveClick Save in the theme editor. The popup engine now loads on every page of that theme.
Why this is separate from the appShopify keeps storefront code (the theme embed) and admin apps separate. Enabling the embed gives PopupVideo permission to render on your live pages. If you switch or duplicate themes, enable the embed again on the new theme.

04Performance dashboard

The Dashboard is the app's home screen. It shows how your popups are performing over a selected window, compared with the previous period of the same length.

Top actions

View all popups
Jump to the Popups list to manage individual campaigns.
Sync to storefront
Force-publish your active popups to the live store (see Storefront sync).
Export
Download your performance data.
+ Create popup
Start a new popup draft and open the editor.

Filters

Narrow what the dashboard shows with three filters: Date range (7 / 30 / 90 days), Status (all, active, paused, draft), and Page (limit to a specific page type).

The five KPI cards

MetricWhat it means
ViewsHow many times your popups were shown to shoppers (impressions).
ClicksHow many times shoppers clicked the popup or its CTA button.
CTRClick-through rate — clicks ÷ views, as a percentage.
RevenueOrder value attributed to popups the shopper interacted with.
Conversion rateShare of popup interactions that led to an attributed order.

Each card shows a trend badge versus the previous period and a mini sparkline. Below the cards, the Views vs. clicks chart plots daily impressions and clicks across your selected range.

Why Revenue may read $0Revenue and conversion attribution depend on order tracking. If your store is brand new, or popups haven't driven a tracked order yet, these stay at zero until the first attributed purchase.

05Creating a popup

Click + Create popup from the dashboard (or New on the Popups list). This opens the editor with a fresh draft called "Untitled popup." A popup has three states:

StatusMeaning
ActiveLive and visible on the storefront pages you target.
PauseHidden on the storefront until you re-activate it.
DraftNot visible yet — the default for new popups.

Rename the popup with the pencil icon next to the title. The editor is organized into sections (Live preview, Design, Source, Card overlay, Pages, Trigger, Danger zone). Use the Live preview panel at the top to click the bubble and preview its expanded state as you edit. When you're done, click Save in the footer; Discard abandons unsaved changes.

Add media to publishA popup stays in draft until it has media attached. The editor shows an "Add media to publish" banner until you pick a source.

06Design & position

The Design section controls how the popup looks.

Bubble
The bubble / accent color (default #FF7A59). Also used for the tag pill and CTA button.
Border
Border color of the popup card.
Text
Text color used on the card.
Width
Card width in pixels (e.g. 450px; ranges roughly 250–800).
Height
Auto (9:16) keeps a vertical video ratio, or set a fixed pixel height.
Popup style
Inline — a player with controls (mute / pause / scrub). The alternative is a classic silent autoplay loop with no controls.
Corner radius
Roundness of the card corners, in pixels (default 36).
Position
One of the four corners — top-left, top-right, bottom-left, bottom-right.
Edge offsets
Top / Right / Bottom / Left nudge in pixels. The card uses the two offsets matching its corner — e.g. a top-left popup honors Top + Left.

07Media source

In the Source section you choose where the popup's media lives. There is one media item per popup. Pick from four sources:

SourceUse it for
Pick from Shopify FilesVideo or image already uploaded to your Shopify Files library.
Add YouTube URLA YouTube video link.
Add DailyMotion URLA DailyMotion video link.
Add image URLAny hosted image (e.g. a poster or static promo).
TipHosting videos in Shopify Files keeps everything in one place and avoids third-party branding or ads that come with embedded video platforms.

08Card overlay & CTA

The Card overlay section adds text on top of the storefront card. All fields are optional with sensible fallbacks.

Tag
Small uppercase pill in the corner, e.g. NEW, SALE, LIMITED. (max 20 chars)
Card title
Heading on the card. Falls back to the popup name if left blank. (max 40 chars)
Card subtitle
Secondary line under the title. Falls back to the CTA label. (max 60 chars)
Video thumbnail
Optional poster image shown before the video plays. Leave empty to use the video's own first frame.
CTA button text
Label on the action button (e.g. "Shop now"). Shown on the full-screen player only; leave empty to hide the button.

09Page targeting

The Pages section decides where the popup appears. Choose broad page types, specific products/collections, or a mix.

Page types

Page typeWhere the popup shows
HomepageYour store's front page.
All product pagesEvery product page (wildcard).
All collection pagesEvery collection page (wildcard).
CartThe cart page.
CheckoutCheckout pages.
AccountCustomer account pages.

Specific products & collections

Use Pick products… or Pick collections… to target individual items instead of every page of that type — handy for promoting one launch product. When a shopper lands on a page, an exact match (e.g. that specific product) takes priority over a wildcard ("all product pages").

10Triggers

The Trigger section sets when the bubble appears. If you set more than one, whichever fires first wins.

Show after delay
Wait N seconds after the page loads (0 = immediately).
After scroll depth
Show once the shopper scrolls past N% of the page.
Show on exit intent
Trigger when the shopper's cursor moves to leave the page — a last-chance prompt.

11Storefront sync

PopupVideo publishes your active popups into a shop metafield, and the theme app extension reads that metafield in Liquid to render them on the storefront. Saving or deleting a popup pushes the update automatically — you usually don't need to do anything.

Use the manual sync when you want to force a re-publish — for example after restoring a backup, after enabling the embed, or while testing. You'll find it on the dashboard (Sync to storefront) and in Settings → Storefront sync (Sync to storefront now).

Metafield
shop.bubblepop.popups · JSON · public read
Auto-updates
Every time you save or delete a popup.
Manual button
"Sync to storefront now" forces an immediate re-publish.
Inspect
"Open metafield in Shopify admin" shows the raw JSON the storefront reads.
If a popup isn't updatingGo to Settings → Storefront sync → Sync to storefront now. This re-publishes immediately and resolves most "my change isn't showing" cases.

12Popups list

Open Popups from the left menu to manage all your campaigns in one table. From here you can:

Create
Start a new popup draft.
Search & sort
Filter by name and sort by CTR, views, or name.
Filter by status
View all, active, paused, or draft popups.
Activate / pause
Change status individually or in bulk.
Duplicate
Copy a popup to reuse its design as a starting point.
Delete
Remove a popup. Performance data is kept for 90 days.

13Settings

The Settings page holds store-wide defaults and tools.

Language
Interface language for the app.
Analytics
Toggle storefront analytics tracking on or off.
Defaults
Default behavior, position, size, and animation applied to new popups.
API key
Your shop's key, with the ability to regenerate it.
Notifications
Weekly summary, anomaly alerts, billing, and tips emails.
Storefront sync
Force re-publish and inspect the live metafield (see Storefront sync).

14Plans & billing

Every plan includes the same full feature set — they differ only in how many popups, media items, and pages you can use. New stores start with a 3-day free trial. Annual billing charges 10 months up front, so you get 2 months free.

Starter

€5.99/mo

For one-product stores trying their first popup.

  • Up to 3 popups
  • Up to 5 media items
  • Up to 5 pages

Scale

€39.99/mo

For brands with playbooks across many SKUs.

  • Unlimited popups
  • Unlimited media items
  • Unlimited pages

Shared features (all plans)

Video, GIF & image popups · four corner positions with edge offsets · card overlay (title, subtitle, tag) · full-screen player with CTA button · page targeting (home, cart, product, collection, checkout, account) · delay, scroll-depth & exit-intent triggers · storefront analytics (views, clicks, CTR) · 30-day performance dashboard · Shopify Files, YouTube, DailyMotion & image-URL sources.

Billing is handled by ShopifyCharges, trials, and cancellations run through Shopify's billing — prices shown in the app always match what Shopify charges. Cancel anytime from the Plans & billing page.

15Troubleshooting

My popup isn't showing on the storefront

Work through these in order:

  1. Is the popup Active?Draft and paused popups never appear. Set it to Active and save.
  2. Does it have media?A popup with no video/GIF/image stays in draft. Add a source.
  3. Is a page targeted?The popup only shows on pages selected in the Pages section.
  4. Is the theme embed on?Confirm BubblePop is enabled in Online Store → Themes → Customize → App embeds.
  5. Force a syncGo to Settings → Storefront sync → Sync to storefront now, then reload your storefront.

My changes aren't reflected on the live store

Saving normally auto-publishes, but if an edit isn't showing, use Settings → Storefront sync → Sync to storefront now to force a re-publish, then hard-refresh the storefront page.

Revenue / conversion rate shows 0

These metrics rely on attributed orders. They remain at zero until a shopper who interacted with a popup completes a tracked purchase.

I can't create or edit popups

An active plan (or trial) is required. Check Plans & billing to make sure your subscription is active.

16Glossary

TermMeaning
BubblePopThe storefront name of PopupVideo — the floating bubble shoppers see and the theme app embed.
Theme app embedThe toggle in the theme editor that lets the app render on your live storefront.
MetafieldThe data record (shop.bubblepop.popups) that stores your active popups so the theme can read them.
CTRClick-through rate: clicks divided by views.
CTACall to action — the button shoppers click (e.g. "Shop now").
Wildcard target"All product pages" / "All collection pages" — matches every page of that type.
Exit intentA trigger that fires when the shopper moves to leave the page.