Skip to content

How to Add Custom Shape Divider in WordPress?

Key Takeaways

  • Nexter Blocks Container block adds a Shape Divider that places decorative SVG presets like wave, curve, and triangle on the top and/or bottom edge of a Container block.
  • Style tab provides independent Top Divider and Bottom Divider controls, plus color, per-device width and height, Flip, Invert, and Bring to Front options.
  • Shape Divider renders as an absolutely positioned SVG, so its color, width, and height change independently for each device without re-exporting an asset.
  • Nexter WP bug ticket #18269 reports the Flip setting not working; if Flip has no visible effect, the post says to try Invert or check for a Nexter Blocks update.
Table of Contents

Are you looking to add custom shape dividers in WordPress Gutenberg? These unique shapes, placed between sections or blocks of content, not only add visual interest but also help break up a webpage’s monotony.

With the Container block from the Nexter Blocks, you can easily add custom shape dividers between sections in WordPress.

To check the complete feature overview documentation of the Nexter Blocks Container block, click here.

Requirement – This block is a part of the Nexter Blocks, make sure it’s installed & activated to enjoy all its powers.

What It Does

Shape Divider adds a decorative SVG shape (wave, curve, triangle, and similar presets) to the top and/or bottom edge of a Container block, in place of a plain straight line between sections.

Why It Matters

Stacked sections with hard, straight edges can make a page feel like a list of boxes. A shape divider softens that transition without needing a designer to export a custom SVG or background image, and it stays editable from the block editor if you change the section’s background color later.

What You Get

Independent Top and Bottom divider tabs, a library of preset shapes for each, per-device width and height controls, a color picker for the shape, and Flip/Invert/Bring to Front toggles — all inside the Container block’s Style tab.

Capabilities

  • Top Divider / Bottom Divider – add a shape independently to either edge of the container, each with its own settings.
  • Color – set the shape’s fill color, independent of the container’s own background.
  • Width – control the shape’s width per device.
  • Height – control the shape’s height per device.
  • Flip – mirror the shape horizontally.
  • Invert – invert the shape’s design (peaks become troughs).
  • Bring to Front – raise the shape above overlapping content when it would otherwise render behind it.

How It Works

The Shape Divider renders as an absolutely positioned SVG layered on the Top or Bottom edge of the container. Because it is layered rather than baked into a background image, its color, width, and height can be changed independently for each device without re-exporting an asset, and Bring to Front simply raises its stacking order above sibling content.

How to Use It

Add the Container block with the appropriate layout to the page and follow the steps:

1. Go to Style > Shape Divider.

2. Select a shape from the Top Divider section under the Top tab. This adds the shape divider to the top of the container.

Selecting a Top Divider shape from the Container block’s Style tab

3. From the Color section, set the shape’s background color.

4. Adjust the shape’s Width and Height per device.

5. Enable Flip to mirror the shape, or Invert to invert its design.

6. If the shape divider renders behind any content, enable Bring to Front to raise it above.

7. To add a divider at the bottom of the container, repeat the same steps under the Bottom tab, which offers the same options as the Top tab.

Container section with a wave-style shape divider applied at the top edge
A finished shape divider applied to a Container section

Use Cases

  • Softening the transition between a hero section and the content below it with a wave or curve.
  • Breaking up long, stacked landing-page sections so they read as distinct visual blocks rather than one flat scroll.
  • Matching a section’s shape divider color to the following section’s background to create a layered, angled effect.

Limitations

  • Only the preset shape library is available from the Style tab; there is no field to upload a fully custom SVG shape.
  • The Flip toggle mirrors the shape but does not rotate it, so shapes that are not left-right symmetric may still need the Invert option combined with Flip to get a specific orientation.
  • A shape divider set to Bring to Front will render above any content placed directly inside that same container, so it needs to be re-checked if you add new content near the container’s top or bottom edge afterward.

Troubleshooting

  • The Flip toggle does not change the shape’s orientation: this matches a confirmed Nexter WP bug (ticket #18269, Shape Divider Flip setting not working) reported and under investigation as of this writing. If Flip has no visible effect, try the Invert toggle instead, or check for a Nexter Blocks update that resolves it.
  • The shape divider is hidden behind the section’s content: enable Bring to Front on that divider so its stacking order is raised above sibling content.
  • The shape divider looks stretched or too tall on mobile: set the Width and Height fields for the Tablet and Mobile device tabs separately — these values do not automatically scale down from the Desktop setting.

Share your Thoughts

Still in Doubt? Let’s Assist You

Have Feedback or Questions?

Join our WordPress Community on Facebook!

Related Frequently Asked Questions

Why is my shape divider not showing on the container?

The Shape Divider only works on the Container block from Nexter Blocks, so the block has to be installed and activated first. It renders as an SVG on the top or bottom edge of that container, not as a background image. If it still looks missing, the divider may be sitting behind nearby content, which is where Bring to Front matters.

How do I fix a shape divider that is hidden behind other content?

Bring to Front is the setting that fixes stacking problems. The divider is rendered as an absolutely positioned SVG, so it can end up behind sibling content inside the same container. Turning on Bring to Front raises its stacking order above that content. That matters most when you add text or blocks close to the container edge after setting the divider.

Can I use a custom SVG file for a shape divider in WordPress?

The Shape Divider uses a preset shape library from the Style tab, including wave, curve, triangle, and similar options. There is no field to upload a fully custom SVG shape. That makes it faster to edit inside the block editor, but it also means your design choices stay within the built-in presets.

What should I change if my shape divider looks stretched on mobile?

Width and Height are controlled separately for Desktop, Tablet, and Mobile, so mobile does not automatically inherit a scaled-down desktop size. That is why a divider can look too tall or oddly stretched on smaller screens. Adjusting those device tabs directly keeps the shape proportioned instead of relying on one desktop value for every breakpoint.

When should I use Flip or Invert on a shape divider?

Flip mirrors the shape horizontally, while Invert changes the design so peaks become troughs. That difference matters because Flip does not rotate the shape, so asymmetric presets may still point the wrong way unless you combine it with Invert. The page also notes a confirmed Nexter WP bug where Flip may not visibly change orientation.

What are good use cases for adding a shape divider between sections?

Shape dividers work best when you want sections to feel connected instead of stacked like boxes. Common uses include softening the transition from a hero section into the content below, breaking up long landing pages into distinct visual blocks, and matching the divider color to the next section’s background for a layered effect. Nexter Blocks makes that editable directly in WordPress Gutenberg.

Last reviewed: September 1, 2026

Related Docs