Floating Product Video

Floating Product Video for WooCommerce lets you add a floating video to your product pages that remains accessible while customers browse and scroll.

Installation

↑ Back to top

To start using a product from WooCommerce.com, you can use the โ€œAdd to storeโ€ functionality on the order confirmation page or the My subscriptions section in your account.

  1. Navigate to My subscriptions.
  2. Find the Add to store button next to the product youโ€™re planning to install.
  3. Follow the instructions on the screen, and the product will be automatically added to your store.

Alternative options and more information at:
Managing WooCommerce.com subscriptions.

Setup and Configuration

↑ Back to top

Option 1:

Once the plugin is activated, you will see a Settings link on the Plugins page (as shown in the image below). Click this link to access the configuration panel.

floating product video setting link

Option 2:

  • Go to your WordPress Admin Sidebar.
  • Navigate to WooCommerce โ†’ Settings โ†’ Floating Video to configure the global display options.

General Setting

↑ Back to top

Find these under WooCommerce โ†’ Settings โ†’ Floating Video โ†’ General.

floating product video general setting
SettingOptionsDefaultWhat it does
Show the videoOn page load, After scrollingOn page loadWhen the play button or open player first appears.
Delay (seconds)0โ€“600Wait after the page loads. Applies to On page load.
Scroll distance (%)1โ€“10025How far down the page the customer must scroll. Applies to After scrolling. Pages too short to scroll that far show the video straight away.
Close behaviorReturn to play button, Hide the video completelyReturn to play buttonWhat the player’s close button does. A hidden video comes back when the page is next loaded.

Layout Setting

↑ Back to top
floating product video layout setting

The Layout section has a separate editor for desktop, tablet, and mobile, with a live preview of each screen as you change values.

floating product video layout setting demo

Per-device settings

↑ Back to top
SettingDesktopTabletMobileAllowed values
Show floating videoYesYesYesYes or No
Initial displayPlay buttonPlay buttonPlay buttonPlay button or Expanded video
PositionBottom rightBottom rightBottom rightAny corner
Horizontal offset20px20px12px0โ€“500 in px, or up to 50%
Vertical offset20px20px12px0โ€“500 in px, or up to 50%
Default video width410px340px280pxAt least 120px, or up to 100%
Play button sizeMediumMediumSmallSmall 48px, Medium 60px, Large 76px
Customers can move the playerNoNoNoYes or No
Customers can resize the playerNoNoNoYes or No

Device inheritance

↑ Back to top

You don’t have to configure every device. Tablet settings can be Same as desktop, Same as mobile, or Custom, and defaults to Same as desktop. Mobile settings can be Same as desktop or Custom, and defaults to Custom. The tablet column above only applies once tablet is set to Custom.

Screen size breakpoints

↑ Back to top
SettingDefault
Tablet (px)1024
Mobile (px)767

Playback settings

↑ Back to top
floating product video playback setting
SettingDefaultWhat it does
AutoplayNoStarts the video without a click, on devices where Initial display is Expanded video. It is always muted, and is skipped for visitors whose device asks for reduced motion.
MutedYesStarts the video with sound off, including when a customer presses play.
LoopNoRestarts the video when it ends.
Show controlsYesShows the player controls. For uploaded and external videos with controls off, clicking the video plays and pauses it.
Allow fullscreenYesLets customers watch in fullscreen.
  • Want sound when customers press play? Turn Muted off. It is on by default, so videos start silent until the customer unmutes them.

How the first view works

↑ Back to top
Initial displayAutoplayWhat the customer sees
Play buttonOn or offThe play button. The video starts when they click it.
Expanded videoOnThe open player, playing muted.
Expanded videoOffThe open player, paused. YouTube and Vimeo show the poster until the customer presses play.

Appearance settings

↑ Back to top
floating product video appearance setting
SettingDefaultOptions
Aspect ratio16:916:9 (Landscape), 4:3, 1:1 (Square), 9:16 (Vertical). The height follows the width at this ratio.
Border radius (px)80โ€“40
Play button iconPlayPlay, Play in a circle, Play in a filled circle, Play in a rounded square, Video camera
Play button background#1e1e1eAny color
Play button icon color#ffffffAny color
Pulse animationYesDraws attention to the play button with a subtle pulse.

Per-product overrides

↑ Back to top
floating product video product edit page

By default a product uses the global settings. To change them for one product, open its Floating Video tab and set Settings to Override settings. Two groups of options appear.

Layout

↑ Back to top

Set Layout to Customize layout for this product to open the same per-device editor and preview used in the global settings.

Advanced settings

↑ Back to top

Click Advanced settings to override individual General, Playback, and Appearance options. Each field shows the current global value as its default, such as Default (Yes). Leave a field on its default and it keeps following the global setting.

What customers can do

↑ Back to top
ActionResult
Press the play buttonOpens the player and starts the video.
Minimize, or press EscPauses the video and returns to the play button. Reopening continues from the same point.
CloseStops the video. It then returns to the play button or hides, depending on Close behavior. Opening it again starts from the beginning.
Drag the toolbarMoves the open player, if Customers can move the player is on. Minimizing or closing returns it to its configured corner. Double-click the toolbar to reset.
Drag the resize handleChanges the width, if Customers can resize the player is on, down to 180px. The browser remembers the width for each device type. Double-click the handle to reset.
Arrow keys on the move or resize handleMoves or resizes by 10px, or 50px with Shift.

Add a video to a product

↑ Back to top
floating product video product edit page
  • Go to Products and edit a product.
  • In the Product data box, open the Floating Video tab.
  • Tick Enable Floating Video.
  • Choose a Video source, then choose a file or paste the URL.
  • Optional: choose a Poster image.
  • Update the product and view it on your store.

On the Products list, the Video column shows an icon for every product whose video is ready to display, and a dash for the rest.

Video sources

↑ Back to top
SourceWhat to provide
Upload videoA video from your Media Library.
YouTubeA watch?v=, youtu.be/, /shorts/, /embed/, /live/, or /v/ URL. Videos play from the privacy-enhanced youtube-nocookie.com domain.
VimeoA vimeo.com or player.vimeo.com URL. For an unlisted video, paste the full link including its privacy hash. Videos play with Vimeo’s Do Not Track option on.
External URLA direct link to a file ending in .mp4, .m4v, .webm, .ogv, or .mov. If your store uses HTTPS, the link must too.

Poster images

↑ Back to top

The poster appears before the video plays. If you don’t choose one, YouTube and Vimeo videos use the thumbnail from their provider. Uploaded and external videos have no fallback poster.

Override the template

↑ Back to top

Copy the plugin’s

templates/single-product/floating-product-video.php

to:

wp-content/themes/yourtheme/floating-product-video/single-product/floating-product-video.php

Keep the .fpv-floating__frame element and the data-fpv-* and .fpv-floating__* hooks. The script creates the player inside the frame and adds the move and resize handles to .fpv-floating__toolbar. Without the toolbar, the player can’t be moved or resized.

Filter the frontend configuration

↑ Back to top

fpv_floating_product_video_config receives the configuration array, the WC_Product, and the product’s effective settings. Return null to show no video on that product.

add_filter(
	'fpv_floating_product_video_config',
	function ( $config, $product, $settings ) {
		if ( $product->is_on_sale() ) {
			$config['show'] = [
				'trigger' => 'scroll',
				'delay'   => 0,
				'scroll'  => 50,
			];
		}

		return $config;
	},
	10,
	3
);
KeyContents
provideryoutube, vimeo, or empty for a file
embedUrlThe YouTube or Vimeo iframe URL
srcThe file URL for uploaded and external videos
poster, titlePoster URL and the video’s accessible name
devices, breakpointsResolved layout per device, and the tablet and mobile widths
autoplay, muted, loop, controls, fullscreenBooleans
closeBehaviorminimize or hide
showtrigger (load or scroll), delay, scroll
i18nLabels for the move and resize handles

YouTube and Vimeo parameters live in embedUrl. Changing muted, loop, or controls in the filter only affects uploaded and external videos. For embeds, edit the query string in embedUrl.

Stored data

↑ Back to top
WhereKeyContents
wp_optionsfpv_{setting}One row per global setting. Layout keys use {device}_{setting}, such as fpv_mobile_width.
Post meta_fpv_floating_product_videoOne array per product: enabled state, source, attachment or URL, poster, override modes, and overrides.
Browser localStoragefpv-floating-product-video-widthThe widths a customer resized the player to, per device.

Reset and uninstall

↑ Back to top

Reset global settings

↑ Back to top

Go to WooCommerce โ†’ Settings โ†’ Floating Video โ†’ Tools, click Reset, and confirm. Every global setting returns to its default. This can’t be undone. Each product keeps its video and its overrides.

Uninstall

↑ Back to top

Deleting the plugin removes its data. Deleting it from the Plugins screen erases all global settings and every product’s floating video configuration. Deactivating it keeps everything. Your Media Library files are not deleted.

FAQs

↑ Back to top

Can each product have its own video?

  • Yes. Videos are added per product. Variations of a product share that product’s video.

Does the video show on shop or category pages?

  • No. It only appears on single product pages.

Can I hide the video on mobile?

  • Yes. Under Layout, make sure mobile is set to Custom, then turn off Show floating video.

Will it slow down my store?

  • The plugin’s scripts and styles load only on product pages with a floating video. YouTube and Vimeo players load only when the video is opened by the customer or autoplays. Uploaded videos with a poster don’t download until played.

Can I use a vertical video?

  • Yes. Set Aspect ratio to 9:16 under Appearance, globally or for one product.

Related Products

WooCommerce Subscriptions is a WooCommerce extension that lets customers subscribe to your products or...

Offer add-ons like gift wrapping, special messages or other special options for your products.

Use of your personal data
We and our partners process your personal data (such as browsing data, IP Addresses, cookie information, and other unique identifiers) based on your consent and/or our legitimate interest to optimize our website, marketing activities, and your user experience.