---
title: "KISS LocoMotion: scroll-scrubbed animation for Elementor"
description: "KISS LocoMotion plays a frame sequence or video as the visitor scrolls, with timed captions. An Elementor widget, with a calm reduced-motion version."
url: https://imaginarytrout.com/plugins/kiss-locomotion/
---

KISS LocoMotion

# Scroll becomes the playhead.

Give KISS LocoMotion a sequence of frames or a video and say how much scrolling it should take. As the visitor scrolls, the picture moves, and captions or numbered steps arrive with it.

[Ask about KISS LocoMotion](https://imaginarytrout.com/contact/)See it running

Version

1.1.0

WordPress

6.0+

Tested up to

WordPress 7.1.4

PHP

7.4+

Releases

59

License

GPL 2.0 or later

## What it solves

Explaining how a product works usually means a long video nobody finishes, or a row of still pictures. A scroll-driven sequence lets the visitor set the pace and stop on the step they care about.

LocoMotion keeps it to three ideas: a tall track whose height is the duration, a stage pinned inside it, and progress from 0 to 1. Everything else, from the frame shown to the caption on screen, follows progress.

## What it does

- ### Three sources

    A frame sequence from one ZIP upload, frames picked from the media library, or an MP4.

- ### Human controls

    Stage height, scroll distance, start and end, a hold at the end, easing, fit and focal point. A longer track is a slower scrub.

- ### Slides on the timeline

    Text timed to the scroll: numbered steps beside the visual, or captions over it in nine positions.

- ### Progress in CSS

    Publishes --loco-progress and --loco-frame, so captions, parallax and progress rails can be written in plain CSS.

- ### SVG tools

    Optimize, recolor and reframe illustrator SVGs in the browser, then save them as a sequence.

- ### Kind on phones

    Scrub, play once or show the first frame only, with defaults that never make a phone download 120 frames by accident.

- ### Reduced motion respected

    Visitors who ask for less motion get a still first frame, no pinning and no scroll track.

- ### Never the LCP

    The first frame is a real image; nothing else loads until the stage nears the screen. GSAP is self-hosted, and a built-in engine can run without it.

## What it needs

- WordPress 6.0 or later
- PHP 7.4 or later
- Elementor for the widget
- The \[kiss\_locomotion\] shortcode works without it

## See it running

On All Power Marine, an 8-post lift lowers a yacht to the waterline as you scroll.

- [Neptune 8-post lift (opens in a new tab)](https://marineboatlifts.com/boat-lifts/neptune-8-post-lift/)
- [Jet ski platform lifts (opens in a new tab)](https://marineboatlifts.com/boat-lifts/jet-ski-platform-lifts/)
- [All boat lifts (opens in a new tab)](https://marineboatlifts.com/boat-lifts/)

## Install

1. ### Step 1

    Upload kiss-locomotion.zip via Plugins → Add New → Upload Plugin and activate.

2. ### Step 2

    Activation lands you on the plugin Dashboard. Go to KISS LocoMotion → Sequences and import a ZIP of frames.

3. ### Step 3

    In Elementor, drop the KISS LocoMotion widget into a full-width container, pick the sequence, set the stage height and scroll distance, publish.

New versions install the same way: upload the new ZIP over the old one. Settings are kept.

## Changelog

59 releases so far. The newest:

1. ### 1.1.0November 15, 2026

    - **Added** Updates itself. New versions now arrive in Dashboard › Updates like any plugin from wordpress.org, with one-click and automatic updates, served from imaginarytrout.com. Nothing to set up.
    - **Added** A red "Update to v…" badge beside the version on the plugin's own screens whenever a newer version is waiting. It links to Dashboard › Updates.
    - **Added** The plugin's icon in the admin menu and beside each screen title, and its icon and banner on the update screen.
    - **Added** Marked compatible with WordPress 7.1.4 ("Tested up to"), so the update screen no longer says "Not tested".
    - **Security** The update check is a read-only HTTPS request to imaginarytrout.com, made from wp-admin and WordPress's scheduled update check, never from a visitor's page.
2. ### 1.0.21October 4, 2026

    - **Fixed** the Ripple could show a drawing that was still loading, half rippled, before switching itself off. It now starts only once every drawing has fully loaded.
    - **Changed** Ripple is off in Safari (and on iPads and iPhones, where every browser uses Safari's engine). Safari draws this effect too slowly to keep. Chrome, Edge and Firefox on computers keep it.
3. ### 1.0.20October 4, 2026

    - **Fixed** under a section that another plugin pins while you scroll (KISS 3D, for example), the dots sent you back up into that section. LocoMotion now measures its sections after every other scroll effect on the page.
4. ### 1.0.19October 4, 2026

    - **Fixed** a section placed under something that changes height after the page loads (a 3D viewer, for example, especially after turning a tablet) stopped following the scroll: the slides did not change and the dots jumped past it into the next section.
5. ### 1.0.18October 4, 2026

    - New: Screen height on phones and tablets (Stage size & scroll, per device).
6. ### 1.0.17October 3, 2026

    - **Fixed** the shortcode in a Custom HTML block, a Shortcode block or the classic editor printed a small first-screen script that WordPress's content filters broke ("SyntaxError: Invalid or unexpected token" in the console), so the section could shift on the first scroll.

## KISS LocoMotion questions

### 

It has not been re-encoded all-intra. Browsers seek efficiently only to keyframes. The exact ffmpeg command is under KISS LocoMotion → Help.

### 

A parent container is clipping overflow, which defeats position: sticky. Remove the clip, or switch Advanced → LocoMotion → Pinning to script-driven.

### 

They can, and the editor will warn you. One per page is the guidance.

## Other KISS plugins

- [KISS 3D](https://imaginarytrout.com/plugins/kiss-3d/)
- [KISS CoverFlow Slider](https://imaginarytrout.com/plugins/kiss-coverflow/)
- [All plugins](https://imaginarytrout.com/plugins/)

## Want KISS LocoMotion on your site?

It is not on WordPress.org yet. It runs on the sites we build and manage. Tell us about yours, or about a plugin you need built.

[Start a project](https://imaginarytrout.com/contact/)

![](/brand/logos/trout-sticker.svg)

---

Imaginary Trout, Laramie, Wyoming. Start a project: https://imaginarytrout.com/contact/ · hello@imaginarytrout.com · 480-463-4202 (leave a message)
