Skip to main content

Animated Heading

A heading with static text and a run of words that rotate through a list — typewriter, slide, flip and a dozen more. The usual way to get this in Gutenberg is a plugin that ships its own typing library; here it is the element you already have.

The block renders through the animated_heading element — the same PHP that runs in the page builder, so the front end is identical either way.

What the sidebar exposes

OptionWhat it does
before_textStatic text before the rotating words
wordsThe rotating words — one per line
after_textStatic text after the rotating words
tagWhich heading level it renders as (h1h6, p, div)
animThe rotation animation
speedHow fast it cycles
highlightHow the rotating word is set apart — accent colour, underline, marker
loopRotate forever, or stop after one pass
pause_hoverPause the rotation while the pointer is over it
randomizeShuffle the word order rather than cycling in sequence
caret_showShow the typing caret
caret_styleCaret shape — bar, block, underscore
caret_colorCaret colour (blank inherits the text colour)
alignHorizontal alignment
text_colorText colour
accent_colorHighlight colour for the rotating word
font_size_presetText size preset

Anything not listed stays available in the page builder, and round-trips untouched — the block only writes the values you change, so an element styled in the builder keeps every setting this sidebar does not show.

Margin and padding come from Gutenberg, not the element

The block declares core spacing support, so margin and padding are edited by Gutenberg's own controls at the top of the sidebar. The element's own spacing option is deliberately not exposed, because two controls for one thing in one sidebar — writing to two different places — is how a heading ends up with spacing nobody can find the source of.

The preview does not rotate, on purpose

The canvas shows the first word, held. A headline that retyped itself every few seconds would move while you were reading the sidebar, and because every option change re-renders the preview, the animation would restart from the beginning each time — which reads as the editor stuttering rather than as a preview of anything. Visitors see the full rotation.

Do not stack a Text Effect on top of it

This element runs its own rotation and does not need the Animation Engine. If you also apply an Animation Engine Text Effect to it, the two animate the same characters and fight. Use one or the other: this block for a rotating headline, a Text Effect for animating any other text.