# Block Animations, Motion & Scroll Effects – Ghost Kit # * Contributors: nko * Tags: animation, effects, scroll effects, blocks, gutenberg blocks * Donate link: https://www.ghostkit.io/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=donate * Requires at least: 6.6 * Tested up to: 7.2 * Requires PHP: 8.3 * Stable tag: 3.8.1 * License: GPLv2 or later * License URI: Animate WordPress blocks with reveal, scroll, mouse and loop effects, set in the block settings. ## Description ## **Ghost Kit adds motion to the blocks you already use.** Select a block, open Effects in the block settings, and choose what happens when it comes into view, when the page scrolls past it, and when the pointer moves across it. [See Live Demo](https://www.ghostkit.io/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=head) | [Documentation](https://www.ghostkit.io/docs/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=head) | [GitHub](https://github.com/nk-crew/ghostkit/) WordPress ships a good set of blocks now. What it still does not ship is motion, and the usual way to get motion is to rebuild the page in a page builder. Ghost Kit is the smaller move. Keep the blocks you have and add the animation on top. ### 🎬 Reveal animations ### Start from a preset, Fade In, Zoom In or one of the three directional zooms, then adjust the offset, opacity, scale and rotation the block animates from. The transition is a spring rather than a fixed easing curve, so the movement settles instead of stopping dead. Reveal is in the free plugin. ### 📜 Scroll effects ### Tie a block's position, scale, rotation and opacity to how far the page has scrolled, rather than to a single trigger. This is how parallax sections and scroll-driven reveals are built. ### 🖱️ Mouse effects ### Move, tilt, scale or rotate a block as the pointer travels over it. Hover and press are separate states, so a card can lift under the cursor and sink when it is clicked. ### 🔁 Loop animations ### Run an animation continuously. Rotating badges, floating shapes and drifting backgrounds are all loops with different transforms. ### ♿ Reduced motion is respected ### Every effect checks `prefers-reduced-motion: reduce` before it runs, so a visitor who turned animations off in their operating system gets a still page. There is nothing to configure. ### 🧩 It works on the blocks you already have ### Effects appear on every core WordPress block, from Paragraph, Heading and Image to Cover, Group, Columns, Buttons and Query Loop. They appear on every Ghost Kit block as well. A block from another plugin can opt in by declaring `supports.ghostkit` in its own `block.json`. You do not have to rebuild anything. Install the plugin, select a block that is already on the page, and the controls are there. ### ⚙️ Extensions ### The same place carries the controls a block usually needs and WordPress leaves out. * [**Position**](https://www.ghostkit.io/docs/extensions/position/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=extensions) Switch a block to absolute or fixed and offset it, per screen size. * [**Spacings**](https://www.ghostkit.io/docs/extensions/spacings/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=extensions) Padding and margin per screen size, on any block. * [**Frame**](https://www.ghostkit.io/docs/extensions/frame/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=extensions) Borders, corner radius and shadows, with a separate hover state. * [**Display**](https://www.ghostkit.io/docs/extensions/display-conditions/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=extensions) Hide a block on the screen sizes where it does not belong. * [**Transform**](https://www.ghostkit.io/docs/extensions/transform/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=extensions) Translate, scale, rotate and skew, including a hover state. * [**Custom CSS & JavaScript**](https://www.ghostkit.io/docs/extensions/custom-css-js/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=extensions) Per page or site wide, edited in the admin with syntax highlighting. ### 🧱 Blocks ### Ghost Kit also ships blocks for the things core still leaves out. Every one of them carries the Effects panel. * [Advanced Columns](https://www.ghostkit.io/docs/blocks/advanced-columns/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=blocks), a twelve column responsive grid with visual size and order controls * [Accordion](https://www.ghostkit.io/docs/blocks/accordion/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=blocks), [Tabs](https://www.ghostkit.io/docs/blocks/tabs/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=blocks), [Toggle Content](https://www.ghostkit.io/docs/blocks/toggle-content/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=blocks) * [Alert](https://www.ghostkit.io/docs/blocks/alert/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=blocks), [Icon](https://www.ghostkit.io/docs/blocks/icon/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=blocks), [Number Box](https://www.ghostkit.io/docs/blocks/number-box/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=blocks), [Progress](https://www.ghostkit.io/docs/blocks/progress/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=blocks), [Countdown](https://www.ghostkit.io/docs/blocks/countdown/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=blocks) * [Button](https://www.ghostkit.io/docs/blocks/button/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=blocks), [Circle Button](https://www.ghostkit.io/docs/blocks/circle-button/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=blocks), [Divider](https://www.ghostkit.io/docs/blocks/divider/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=blocks), [Shape Divider](https://www.ghostkit.io/docs/blocks/shape-divider/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=blocks) * [Video](https://www.ghostkit.io/docs/blocks/video/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=blocks), [GIF](https://www.ghostkit.io/docs/blocks/gif/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=blocks), [Image Compare](https://www.ghostkit.io/docs/blocks/image-compare/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=blocks), [Image Scroller](https://www.ghostkit.io/docs/blocks/image-scroller/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=blocks), [Magnifying Image](https://www.ghostkit.io/docs/blocks/magnifying-image/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=blocks), [Carousel](https://www.ghostkit.io/docs/blocks/carousel/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=blocks), [Marquee](https://www.ghostkit.io/docs/blocks/marquee/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=blocks) * [Contact Form](https://www.ghostkit.io/docs/blocks/form/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=blocks), [Google Maps](https://www.ghostkit.io/docs/blocks/google-maps/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=blocks), [Pricing Table](https://www.ghostkit.io/docs/blocks/pricing-table/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=blocks), [Testimonial](https://www.ghostkit.io/docs/blocks/testimonial/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=blocks), [Table of Contents](https://www.ghostkit.io/docs/blocks/table-of-contents/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=blocks) * [Code Highlight](https://www.ghostkit.io/docs/blocks/code/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=blocks), [GitHub Gist](https://www.ghostkit.io/docs/blocks/github-gist/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=blocks), [Changelog](https://www.ghostkit.io/docs/blocks/changelog/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=blocks), [Interactive Links](https://www.ghostkit.io/docs/blocks/interactive-links/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=blocks) ### ✍️ Content formatting ### Formats that apply to a text selection rather than to a whole block. See them on the [formats demo page](https://www.ghostkit.io/docs/formats/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=formatting). [Animated Text](https://www.ghostkit.io/docs/formats/animated-text/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=formatting), [Badges](https://www.ghostkit.io/docs/formats/badge/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=formatting), [Lorem Ipsum Generator](https://www.ghostkit.io/docs/formats/lorem-ipsum-generator/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=formatting), [Spoiler](https://www.ghostkit.io/docs/formats/spoiler/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=formatting), [Stroke](https://www.ghostkit.io/docs/formats/stroke/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=formatting), [Tooltip](https://www.ghostkit.io/docs/formats/tooltip/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=formatting), [Uppercase](https://www.ghostkit.io/docs/formats/uppercase/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=formatting) ### 🔥 Ghost Kit Pro ### > The free plugin covers reveal animations, the layout extensions and the block set. [**Ghost Kit Pro**](https://www.ghostkit.io/pricing/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=pro) adds the rest of the motion system and pays for the free version to keep being maintained and supported. * Scroll effects, mouse effects and loop animations * 3D rotation, custom viewport and replay for reveal animations * CSS transform and transition per block, with a hover state * Custom block attributes and custom responsive breakpoints * Marquee, Code Highlight, Interactive Links, Magnifying Image, Image Scroller, Circle Button and Toggle Content blocks * Animated Text, Stroke, Spoiler and Tooltip formats * More icon packs, Adobe Fonts and custom font files * Gradients for buttons, backgrounds, icons and badges * Extra shapes for the Shape Divider block ### 🏳️ Multilingual ### Ghost Kit adds a layer of [WPML](https://wpml.org/) compatibility. Every block is translation ready. [Read the multilingual guide](https://www.ghostkit.io/docs/languages/multilingual/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=multilingual). ## Installation ## ### Automatic installation ### In the WordPress dashboard go to Plugins, click Add New, and search for Ghost Kit. Click Install Now and then Activate. Effects appear in the block settings straight away. ### Manual installation ### Download the plugin, upload the folder to `wp-content/plugins` over FTP, and activate it from the Plugins screen. The WordPress documentation has [the longer version](https://wordpress.org/documentation/article/manage-plugins/#manual-plugin-installation-1). ## Frequently Asked Questions ## ### Which blocks can I animate? ### Every core WordPress block and every Ghost Kit block. That covers Paragraph, Heading, Image, Cover, Group, Columns, Buttons, Query Loop and the rest of the core set. A block from another plugin joins in once it declares `supports.ghostkit` in its `block.json`. ### Do I need a page builder? ### No. Ghost Kit works inside the standard block editor and the Site Editor. Pages you have already built stay as they are, and the Effects panel appears on the blocks that are on them. ### Do the animations work on mobile? ### Yes. Reveal animations run on touch devices as the visitor scrolls. Mouse effects need a pointer, so they stay idle on touch screens rather than misfiring. ### Will animations slow down my site? ### The effects are CSS transforms and opacity changes, which the browser composites on the GPU. Ghost Kit loads the effects script only on pages that actually use an effect. ### What happens for visitors who turned animations off? ### Ghost Kit checks `prefers-reduced-motion: reduce` and skips the animation for them, leaving the block in its final state. This is on by default and there is no setting to remember. ### How do I add a parallax effect? ### Select the block, open Effects, and use Scroll to tie its vertical offset to the scroll position. Scroll effects are part of Ghost Kit Pro. ### Can I reuse an effect on another block? ### Yes. The block toolbar has a Ghost Kit menu with Copy extensions and Paste extensions, so an effect you tuned on one block can be pasted onto the next one instead of set up again. ### Does Ghost Kit have documentation? ### Yes, at [ghostkit.io/docs](https://www.ghostkit.io/docs/getting-started/?utm_source=wordpress.org&utm_medium=faq&utm_campaign=docs). It covers every block, every extension, and the filters and events for developers. ### Is Ghost Kit translation ready? ### Yes, and it carries WPML compatibility for block content. ## Screenshots ## 1. Ghost Kit panels on a core Group block: Effects, Position, Spacings, Frame, Transform, Custom CSS and Display Conditions 2. Reveal settings: a Zoom In preset, the offset the block animates from, and a spring transition 3. Ghost Kit blocks in the inserter 4. Frame: border, corner radius and shadow, each with a hover state and a value per screen size 5. Display Conditions: hide a block at one screen size and leave it at the others 6. Transform: translate, scale and rotate a block, in 2D or 3D ## Changelog ## = 3.8.1 - Nov 17, 2026 = * fixed block style values of 0, such as a margin or opacity of 0, showing in the editor but missing on the site = 3.8.0 - Oct 24, 2026 = * added WordPress 7.2 compatibility * raised the minimum PHP requirement to 8.3 * added a redesigned icon picker with search, an icon set filter, keyboard navigation and recently used icons * updated FontAwesome to 7.3.1; icons saved with the previous version keep working * changed effect and transition settings to show as one group with their current values * changed global custom JavaScript to be editable only by users allowed to post unfiltered HTML * improved block editor loading: icons (about 2 MB) load only when the icon picker opens * removed the Instagram and Twitter blocks, whose services shut down the APIs they used; saved blocks print nothing on the site * removed the breakpoints dropdown from the editor top bar; the device toggles in block settings still preview each breakpoint * changed the Accordion to fire show, hide, show, shown when opening an item is interrupted by a close * security fix: visitors could read draft and private templates and make the site fetch remote templates * security fix: custom CSS could close the tag it is printed in and add HTML to the page * fixed custom CSS losing rules that use nesting with `&`, child selectors, range media queries or `