Effects · Gutenberg

Text Path block for WordPress

Render text along a curved SVG path — arc, wave, circle or S-curve.

Get Blockenberg

Free Gutenberg block in Blockenberg. The inspector controls and front-end behavior on this page come from this block’s source, not a shared stub.

Get Blockenberg

What it actually does

Render text along a curved SVG path — arc, wave, circle or S-curve.

Inspector panels on this block: Text & Path, Path Stroke, Animation. Those titles come from index.js, not from a shared template.

Behavior controls: “Text & Path — Text” (Add • or | between repetitions for circular paths); “Path Shape” options: Arc (Bow), Wave, Circle, S-Curve; “Arc Direction” options: Bow Up (text on top), Bow Down (text underneath); “Text Anchor” options: Start, Middle, End.

Where to find it

Gutenberg inserter → Effects → search “Text Path” (block name `blockenberg/text-path` in block.json). Style it in the sidebar after insert.

How to use Text Path block for WordPress

  1. Install Blockenberg. Install from WordPress.org and activate the plugin.
  2. Insert the block. Edit a page, click +, search for “Text Path”, insert it. Category: Effects.
  3. Configure inspector controls that exist on this block. Open Text & Path. Set “Text & Path — Text”, “Path Shape”, “Arc Radius (px)”, “Arc Direction”.
  4. Check the published page. The view script reads HTML data attributes: data-opts. The block editor preview may not run the same view script.

Inspector controls from this block’s code

ControlWhat the code does
Text & Path — TextText field in the inspector. Add • or | between repetitions for circular paths. block.json default: Your Curved Text Goes Here • Beautiful Typography •. Saved as `text`.
Path ShapeSelect control; the chosen value is saved on the block. Options: Arc (Bow); Wave; Circle; S-Curve. block.json default: arc. Saved as `pathType`.
Arc Radius (px)Numeric range control in the inspector. Range 50–600. block.json default: 300. Saved as `arcRadius`.
Arc DirectionSelect control; the chosen value is saved on the block. Options: Bow Up (text on top); Bow Down (text underneath). block.json default: top. Saved as `arcDirection`.
Wave Amplitude (px)Numeric range control in the inspector. Range 5–120. block.json default: 40. Saved as `waveAmplitude`.
Wave FrequencyNumeric range control in the inspector. Range 1–6. block.json default: 2. Saved as `waveFrequency`.
SVG Width (px)Numeric range control in the inspector. Range 300–1400. block.json default: 800. Saved as `svgWidth`.
SVG Height (px)Numeric range control in the inspector. Range 80–600. block.json default: 200. Saved as `svgHeight`.
Text Start Offset (%)Numeric range control in the inspector. Range 0–100. block.json default: 10. Saved as `startOffset`.
Text AnchorSelect control; the chosen value is saved on the block. Options: Start; Middle; End. block.json default: start. Saved as `textAnchor`.
Typography — AlignmentSelect control; the chosen value is saved on the block. Options: Left; Center; Right. block.json default: center. Saved as `align2`.
Show Path LineOn/off toggle in the inspector. Off by default. Saved as `showPath`.
Stroke Width (px)Numeric range control in the inspector. Range 1–10. block.json default: 1. Saved as `pathStrokeWidth`.
Animate Text Along PathOn/off toggle in the inspector. Off by default. Saved as `animate`.
Animation Duration (s)Numeric range control in the inspector. Range 2–60. block.json default: 12. Saved as `animateDuration`.
RepeatSelect control; the chosen value is saved on the block. Options: Infinite; 1×; 2×; 3×. block.json default: indefinite. Saved as `repeatCount`.
Text ColorColor control in the inspector. block.json default: #0f172a. Saved as `textColor`.
Path Stroke ColorColor control in the inspector. block.json default: #e2e8f0. Saved as `pathStrokeColor`.
Section BackgroundColor control in the inspector. Saved as `sectionBg`.

What the front-end script actually does

When this is the right block

Notes from the implementation

viewScript: this folder’s frontend.js is enqueued on the front end for this block.

FAQ

How do I add the Text Path block in WordPress?

Install Blockenberg from WordPress.org, edit a page in the block editor, click +, and search for “Text Path”. It sits under Effects. After insert, open Text & Path and set “Text & Path — Text”, “Path Shape”, “Arc Radius (px)”, “Arc Direction”.

What makes Text Path different from other Blockenberg blocks?

Render text along a curved SVG path — arc, wave, circle or S-curve. Inspector labels on this block include “Text & Path — Text”, “Path Shape”, “Arc Radius (px)”, “Arc Direction”.

Is the Text Path Gutenberg block free?

Yes. Text Path ships inside Blockenberg. Get the plugin from WordPress.org — no paid add-on is required for this block.

Can I style Text Path to match my theme?

Yes. Blockenberg’s shared typography and color panels apply here, plus any block-specific style controls listed on this page (panels: Text & Path, Path Stroke, Animation).

Related effects blocks

Get Blockenberg

Install Blockenberg from WordPress.org, then insert Text Path from the Gutenberg inserter.

Get Blockenberg