Skip to content
Gutenberg Motion

Gutenberg Motion

Documentation

From your first animation to a complete page in motion. Follow the workflow in the WordPress block editor.

Start here

What would you like to make?

Choose a task, follow the steps, and check the result on your own content.

Get started

Set up your motion builder.

Use the plugin made for your editor. WordPress 6.5 or newer is required. Your downloads and license keys are in your bitPlugins account.

  1. Sign in to your account with the purchase email. Download the ZIP for Gutenberg Motion; leave the ZIP compressed.
  2. In WordPress, open Plugins > Add New Plugin > Upload Plugin. Select the ZIP, install, and activate it.
  3. Open the product license screen in the WordPress admin menu and enter the license key for this product. A license for the other editor is not interchangeable.
  4. Open the Preset Library. Confirm the built-in presets appear, then open a test page in the WordPress block editor.

Get started

Animate one existing heading.

Start with one text preset and a Page load trigger. This makes it easy to confirm the selected target before adding more complex behavior.

  1. Open a page in the WordPress block editor and select a heading with its final text.
  2. Click Gutenberg Motion in the selected block toolbar. This opens the Block inspector and reveals its motion controls; the controls do not cover the canvas in a toolbar popover.
  3. Enable GSAP motion. Choose Architect Reveal under Animation Preset. Keep Apply To on Whole block and Animate As on Elements for this example.
  4. Set Trigger Type to Page load. Use Preview and check that only the intended heading moves.
  5. Save or update the page. Open its public URL in a new tab and check the saved result at desktop and mobile widths.
Gutenberg MotionYour first animation
Your first animation in Gutenberg Motion.
Your first animation in Gutenberg Motion.

Build motion

Create the motion. Choose where and when it runs.

A preset stores reusable animation. A trigger attaches it to selected content and decides when it plays. Changing a trigger does not require duplicating the preset.

Layer

The selected block, widget content, or layout container.

Preset

The visual properties, easing, and sequence you want to reuse.

Apply To

The whole selected layer or compatible content inside it.

Trigger On

The element or supported event source that starts the animation.

Playback

The settings that control the selected targets, repetition, and sequencing.

Build motion

Start with a preset. Keep control of the result.

The library contains editable built-in presets. Search by name and filter by content type or motion structure before opening a preview.

Simple Motion

A focused animation for a compatible target.

Staged Motion

A coordinated sequence that includes parent and child phases.

Advanced Timeline

Multiple motion steps with deliberate order, overlap, and timing.

  1. Open the Preset Library and select a content type such as Text, Image, Button, or Layout.
  2. Preview a candidate against its sample content. Replay to inspect the start and finish, not only the final frame.
  3. Choose Edit to change its animation. Review properties, timing, easing, and any target-dependent settings.
  4. Save, return to the page, and preview each placement that uses the preset. Use the built-in reset action when you need the shipped values again.
Gutenberg MotionUse and edit presets
Use and edit presets in Gutenberg Motion.
Use and edit presets in Gutenberg Motion.

Build motion

Compose a sequence, not a pile of effects.

Use Advanced Timeline when one animation cannot express the movement. Use Simple Motion when a single move is enough, and Staged Motion for a reusable parent-and-child sequence.

  1. Open Create New, choose the content type, and select Advanced Timeline.
  2. Set the first step to establish the starting movement. Add properties that the selected content can actually render.
  3. Add the next step. Adjust its position and duration to follow or overlap the first.
  4. Choose easing and stagger only where they serve the sequence. Replay the complete timeline after each timing change.
  5. Save the preset, apply it to real content, and test it with the intended trigger. A scroll-scrub timeline must also work when the visitor scrolls backward.
Gutenberg MotionCreate a timeline
Create a timeline in Gutenberg Motion.
Create a timeline in Gutenberg Motion.

Build motion

Give the movement its pace.

Ease controls acceleration, not the animation duration. Choose a standard ease for a familiar finish, or CustomEase when you need a particular curve. The curve is saved with the preset.

Duration

How long the step runs, in seconds. Keep this constant while comparing easing curves.

Type

In, Out, or InOut for ease families that expose direction.

Custom Path

The curve definition used by CustomEase. This is an easing path, not a path that the element follows.

Example curve

M0,0 C0.25,0.1 0.25,1 1,1 is a useful starting point for a smooth ease. Compare it with Power3 Out at the same duration.

  1. Open a preset and expand Timing. In an Advanced Timeline, open Timing inside the step you want to change.
  2. Start with Power3 and Type Out. Replay the same duration to see how the movement slows into its final position.
  3. Choose CustomEase in the Ease selector. Enter your curve in Custom Path, then leave the field to validate it.
  4. Replay the full sequence. A curve that looks good on one step may feel abrupt when it overlaps another. Save only after checking the combined result.
Gutenberg MotionEasing and CustomEase
Easing and CustomEase in Gutenberg Motion.
Easing and CustomEase in Gutenberg Motion.

Build motion

Reveal letters, or move them. Know the difference.

SplitText makes lines, words, or characters available as animation targets. ScrambleText changes the displayed characters while revealing the final text. They are different effects, not two names for the same setting.

Characters

The temporary characters used during the scramble, not the final copy.

Speed

The rate at which temporary characters change.

Reveal Delay

How long to wait before revealing the final characters.

Tween text length

Whether the displayed text length changes progressively during the effect.

  1. Use a short heading or label. Open a compatible Text preset, or a text step in Advanced Timeline.
  2. Expand ScrambleText and turn on Enable ScrambleText. Choose a Characters set, such as Letters Mixed Case, Uppercase, or Numbers.
  3. As a starting experiment, use Speed 0.35 and Reveal Delay 0. Keep the duration short enough that the final message is easy to read.
  4. Compare Tween text length enabled and disabled. Preview the original content before saving, and check that the final text has not been changed or truncated.

Target content

Animate the part that matters.

Gutenberg uses separate blocks for many content types. A List, List Item, Buttons group, and individual Button are different selections. Select the actual layer before choosing its motion.

Whole content

Moves the compatible field or selected element together.

Lines

Uses current text wrapping. Retest after font, width, or responsive changes.

Words

Useful for pacing a heading without animating every letter.

Characters

Suitable for short display text. Long character sequences can delay reading.

Semantic content

Where supported, narrow rich content to headings, paragraphs, list items, links, or other available nodes before choosing how they animate.

  1. Select the content, then review Apply To before adjusting timing.
  2. Choose the semantic target where available. Narrow heading levels or nested content when the control offers those options.
  3. Choose element, line, word, or character granularity only when compatible with the selected preset.
  4. Preview and check the untouched content too. A paragraph should not move if the intention is to animate only headings.

Target content

Move a group together, or one child after another.

Select a Group or Columns block to work at layout level. Container motion moves that layer together; Direct Children selects its immediate rendered children.

Preset stagger

Reusable choreography inside a tween or timeline step.

Selected Target Playback

How this placement distributes the selected targets or groups. It does not rewrite the saved preset.

Interval or Total Spread

A gap between target starts, or a total spread across the collection, depending on the selected distribution mode.

Nested containers

Direct Children selects immediate rendered children only. It does not recursively animate every descendant.

  1. Select the parent layout and open its motion controls.
  2. Choose Container for one coordinated movement, or Direct Children for sibling targets.
  3. For three sibling cards, open Selected Target Playback and choose Each target separately under Playback Scope. Under Target Timing, choose Play one after another.
  4. Start with Interval 0.08 seconds and the first-to-last order. Preview the first and last card, then repeat after the layout wraps on mobile. Adjust the interval for the actual child count.
  5. Use All selected targets and Use preset timing when the preset should choreograph the entire selected collection. Use Each target group only when the resolver supplies distinct groups, such as several text blocks.
  6. Preview with nested children and responsive wrapping. Verify any child that also owns motion does not compete with the parent for the same properties.

Target content

Keep the interaction usable.

An animation should reinforce the action, not move it out of reach. Keep click targets stable and use supported contextual targets.

Buttons

Select an individual Button for its action. Select the Buttons parent only when animating the group or sequencing its children.

Images

Check crop, clipping, transform origin and the final image bounds at each breakpoint.

Menus

Where supported, distinguish the complete menu, its items and nested submenus. Check desktop, mobile and keyboard navigation separately.

Control playback

Choose the moment, then its settings.

Trigger Type changes which controls are relevant. Start with one trigger and verify its behavior before combining events.

Page load

Starts when the page motion runtime is ready. A useful starting point for first-viewport content.

Scroll into view / Viewport leave

Responds to viewport boundaries. Check forward and backward entry or exit where available.

Scroll scrub

Connects progress to scrolling. Verify start, end, and backward scrolling.

Hover / Click / Focus

Responds to interaction with a compatible target. Preserve the element's normal action.

Pointer

Maps pointer movement over the target or viewport. Provide a useful static state on touch devices.

Custom event

Requires the named event to be dispatched by your own integration. Entering a name alone does not create that event.

  1. Choose Trigger Type, then Trigger Event when shown.
  2. Check Trigger On. It describes the event source, not necessarily the content being animated.
  3. Configure only the dependent controls the selected mode exposes. For scrolling, test the start and end against the actual page length.
  4. Preview, then test the real event on the saved frontend. Replay alone does not exercise every hover, scroll or event lifecycle.
Gutenberg MotionChoose a trigger
Choose a trigger in Gutenberg Motion.
Choose a trigger in Gutenberg Motion.

Control playback

Give each trigger a distinct job.

Use more than one trigger when the target needs an entrance and a later interaction. Avoid two independent animations writing the same property at the same time.

  1. Make the first trigger work by itself. Add the second only after checking the first animation's final state.
  2. For example, combine an entrance with a subtle later hover response, not two competing entrances.
  3. Review playback, reset, repeat, delay, and yoyo where available. A repeated animation should not prevent reading or clicking.
  4. Test in sequence: page load, enter, leave, re-enter, interact, scroll backward, then resize. Disable each trigger in turn if the result is unexpected.

Control playback

Start small. Check a specific result.

These examples use the existing library and your real content. Change one decision at a time so you can see what it affects.

A heading on load

Select a Heading. Choose Line Slide Up and a line target where the preset requires it. Use Page load, preview, then publish. Expected result: the heading reveals once; neighbouring paragraphs stay unchanged.

A group of cards

Select a Group or Columns block. Choose a compatible layout preset and Direct Children. Use the supported selected-target sequencing controls for separate child playback. Expected result: immediate children enter in order; nested text is not accidentally treated as another card.

An entrance plus interaction

Begin with one button entrance. Add a separate compatible hover preset only after verifying the entrance final state. Expected result: the link remains clickable, keyboard focus remains visible, and leaving hover restores the intended state.

Control playback

Check the page, not only the sample.

The preset preview helps create motion. Editor preview checks the selected content. The frontend confirms the saved configuration in the actual visitor environment.

  1. Replay the preset in the library and inspect its full sequence.
  2. Apply it to the intended content and preview from the trigger controls.
  3. Close editing panels and check the whole composition. Make sure motion does not hide or distract from important content.
  4. Save and open the published page in a fresh tab. Test desktop and mobile widths, scrolling, links and keyboard focus.
  5. Repeat with reduced motion enabled and with your real cache and optimization settings. Content must remain readable when animation is reduced.
Gutenberg MotionPreview and publish
Preview and publish in Gutenberg Motion.
Preview and publish in Gutenberg Motion.

Control playback

Keep the content usable while it moves.

Motion must preserve reading, clicking and navigation. Measure the complete page with its real images, fonts and optimization settings, rather than relying on an isolated preset preview.

  1. Check the final visible state with animation disabled. Keep important first-viewport copy and images available without waiting for a long entrance.
  2. Prefer transforms and opacity for entrances. Test layout properties, filters and large blurred layers deliberately because they can add rendering work.
  3. Count selected children and split-text targets. Use words or lines for long headings and whole elements for body copy when a character cascade would delay reading.
  4. Enable the operating system reduced-motion preference before loading the page. Verify visible content, usable links and ordinary navigation without unnecessary scrub, pinning or pointer motion.
  5. Resize and change orientation after playback. Check for duplicate text wrappers, stale pin spacing and targets left hidden by competing parent and child assignments.
  6. Compare repeated mobile performance traces with and without the tested assignments. Record the URL, viewport, versions, target count and exact preset/trigger settings; one score is not a universal plugin benchmark.

Manage your site

Treat navigation as its own experience.

Page transitions are document-level effects, separate from element motion presets. Configure them from the product's Page Transition menu.

  1. Select or customize a transition preset. Use its own preview to inspect the navigation effect.
  2. Set fallback behavior for navigation that does not match a more specific rule.
  3. Add a route rule. Choose the source and destination using the available page or route conditions.
  4. Keep specific exceptions above broad rules. Test the intended source-to-destination journey in the route tools and through actual same-site links.
  5. Check page-level participation and verify the incoming page's own motion. Browsers without the required native support must still navigate normally.
Gutenberg MotionPage transitions
Page transitions in Gutenberg Motion.
Page transitions in Gutenberg Motion.

Manage your site

Bring the asset and its motion into your site.

Built-in presets are already available locally. Remote presets must be saved to your library before they can be used as local animation definitions.

  1. Use Browse Remote to find and preview a compatible preset, then import or save it to the library.
  2. For a complete starting point, open Page Layouts and preview the full page.
  3. Import the layout using the product's layout workflow. Its required presets must be present with it.
  4. Open the imported page in the WordPress block editor. Inspect several content and container triggers before replacing the sample content.
  5. After editing, save the page and verify its frontend. Changing text length, image size or nesting can change animation timing and targets.

Manage your site

Find the first point that behaves differently.

Begin with the smallest failing target. Keep the preset and event simple until the underlying issue is clear.

Motion control missing

Confirm the required editor version and select a supported content or layout context. Parent and child blocks can expose different controls.

Preset unavailable

Confirm the preset exists in the local library. Import a missing remote dependency before selecting it again.

Editor works, frontend does not

Save the page, check the target on the frontend and clear page caches. Test without script-delay or combination to isolate optimization issues.

Content flashes or stays hidden

Check the initial and final preset state, duplicate entrances, delayed assets and competing parent/child motion.

Different text wrapping

Wait for fonts and images. Recheck split-line behavior at the affected width.

Transition missing

Check page participation, enabled rules, route priority and native browser support.

Manage your site

One account. The right access for each product.

Use your checkout email to access bitPlugins. Gutenberg Motion and Elementor Motion purchases appear in the same customer account, with their own downloads and license entitlements.

  1. Sign in using an email link or your account password.
  2. Open the purchased product to download its current package and find its license key.
  3. Activate the key in that product's WordPress license screen. Manage site activations within your plan allowance.
  4. Use the billing or subscription action in your account for the relevant purchase. Do not share a private billing or download link.
  5. Contact support using your purchase email if an order is missing or access does not match the purchase.