Loading
Loading
Loading
mobile footer

Build the Interaction Layer Your Website is Missing.

Browse All EffectsBrowse All EffectsBrowse All EffectsUpgrade to ProUpgrade to ProUpgrade to Pro

70+ effects free, forever. No credit card.

© 2026 Hyperiux. All Rights Reserved.

AI Component CatalogueHey AI, Learn About Us
Platform

Vault

  • Documentation
  • Pricing
  • Blog
  • Community
  • NPM
  • MCP

Categories

  • All Effects
  • WebGL
  • Text
  • Backgrounds
  • Buttons
  • Carousels
  • Scroll
  • Components
  • Navigation
  • Cursor
  • Transitions
  • Loaders

Documents

  • Introduction
  • Installation
  • CLI
  • Dependencies
  • License

Legal

  • License Agreement
  • Terms of Service
  • Privacy Policy
  • Refund Policy
Socials
  • Twitter / X
  • LinkedIn
  • GitHub
  • Instagram
Contact Us
  • hello@hyperiux.com
New effects, in your inbox

Every new drop, plus the occasional behind-the-scenes build. No spam. Unsubscribe anytime.

All Effects
Featured ComponentsText AnimationsAnimated BackgroundsAnimated ButtonsCarousel EffectsScroll EffectsCreative ComponentsNavigationsCursor EffectsTransitionsLoadersWebGL & 3D Effects
Templates
IntroductionInstallationCLIDependenciesLicense
PricingBlogGithubNPMMCP Doc
Loading
Home/effects/Draggable Marquee

Draggable Marquee

A self-drifting image strip that users can grab, drag, and throw, with momentum that eases back into the loop.

GSAP
DemoDemoDemo

Tune the Real Props

Overview

Draggable Marquee gives repeated content a second mode: drift for rhythm, drag for choice.

Use Draggable Marquee when continuous motion should invite interruption. Brand campaigns and editorial pages use it best when visitors can grab a stream of images and fling it in either direction. The default component ships a set of four images, so swap the marqueeImages list in the source for your own visuals. The page job is participation: the marquee should feel alive because the visitor can steer it.

In production, the risk is control. The strip only stops while it is held, unless you set pauseOnHover, which is off by default. Without that, it becomes background noise with a pointer event attached.


Usage Code

page
1import DraggableMarquee from "@/components/effects/draggable-marquee";2 3const page = () => {4	return (5		<>6			<DraggableMarquee/>7		</>8	);9};10 11export default page;

Example Production Use Case

A campaign page showing a strip of key visuals: Draggable Marquee lets visitors grab the stream, throw it backwards or forwards, and hold it still to look closer. With pauseOnHover enabled it also stops while the pointer rests on it. The outcome is participation: the section feels active without hiding the content.


Best Used For

  • Image strips where visitors may want to hold the stream still and inspect it, with pauseOnHover turned on.
  • Logo, tech-stack, and award strips that should drift but also invite a flick.
  • Sections where a drag-and-throw interaction gives visitors something a static row of images would not.

Not For

  • Not for mandatory proof, compliance logos, or content users must read in sequence.
  • Not for logo strips where motion prevents recognition, trust, or partner scanning.

Performance Budget

The strip moves with a transform on a single track and wraps endlessly, so cost stays low. Its ticker callback detaches when the section is offscreen or the tab is hidden, and the Draggable, observers, and listeners are cleaned up on unmount. Pre-size your images so remeasuring on load does not shift the loop.


Accessibility and Mobile

The strip has no keyboard control and the default images carry placeholder alt text, so put any meaningful content in HTML outside it and replace the alt text with your own. Touch dragging works on mobile, and below 768px the images switch to a fixed 320px width. With reduced motion, the strip does not drift and a drag stops exactly where you let go, with no momentum.


Common Mistakes

  • Letting horizontal drag fight native vertical scrolling.
  • Using motion for logos that must be recognized quickly.
  • Making the marquee the only way to access important proof.

Changelog

Added reduced-motion support and fixed offscreen pause freezing every other GSAP animation on the page instead of just the marquee's own ticker.
Initial release

API Reference

PropTypeDefaultDescription
speednumber7.2Autoplay movement speed (px per tick).
pauseOnHoverbooleanfalsePauses autoplay while hovered.
throwMultipliernumber2.8Drag-release momentum strength.
throwFrictionnumber0.975Momentum decay rate per frame after a drag release - closer to 1 coasts longer.

Questions, Answered.

What makes Draggable Marquee different from a standard scroll reveal?

It gives a repeating strip two modes: it drifts on its own for rhythm, and the user can grab and drag it to take control. A standard reveal is a one-way entrance; this is an ongoing, optionally interactive band. Use it for logos, tags, or proof that should move but also invite a flick.

How should Draggable Marquee simplify on mobile devices?

Touch already implies dragging, and the strip responds to a horizontal swipe; check that it doesn't fight vertical page scroll on your layout. Lower the speed prop if the drift competes with the user. With reduced motion, the strip stays still until dragged and has no momentum after release.

What should developers test before shipping Draggable Marquee?

Verify drag and native scroll don't conflict, and that momentum settles predictably with your throwMultiplier and throwFriction values. The strip has no keyboard control and its items are images, so anything keyboard users need must also exist elsewhere on the page. Replace the placeholder alt text on the default images.

Which content structure works best with Draggable Marquee?

Short, equal-weight, repeatable visuals where order isn't critical. The default component renders a list of images, which you change in the source. It's wrong for sequential arguments or anything that must be read top to bottom. Keep each item glanceable.

When should I avoid Draggable Marquee even if the preview looks good?

Avoid it for important sequential content, for anything that must be fully read, or where horizontal drag would interfere with scrolling on touch. If the items carry real meaning that order conveys, use a list. Skip it when motion is the only reason it's there.

Request a Custom Animation

Need a custom effect? Tell us what to create.

Related Effects

Explore All EffectsExplore All EffectsExplore All Effects
Pixelated Image Effect
SVG Filter

Pixelated Image Effect

Cursor

Helix Slider
Pro
Three.js@react-three/fiber

Helix Slider

Scroll

Rectangular Text Reveal
GSAP

Rectangular Text Reveal

Text

Chess Grid Transition
GSAPnext-transition-router

Chess Grid Transition

Transitions

Rope Cursor
Pro
svg-path

Rope Cursor

Cursor