web_separator Shortcode
The web_separator shortcode renders the separator component.
The attributes below match the current Page Builder controls and public output. Use raw syntax only for reviewed content that cannot be maintained through the visual controls.
Usage
[web_separator]Attributes
| Attribute | Default | Accepted values | Purpose |
|---|---|---|---|
separator_type |
split |
split, regular |
Select the type of separator. |
separator_content |
icon |
icon, image |
Select split separator content. Available when separator_type is split. |
separator_icon |
— | Registered library/icon code |
Decorative passive SVG in Split/Icon mode. |
separator_image |
— | Local attachment ID or its library URL | Current image metadata in Split/Image mode. Missing, private or trashed attachments are omitted. |
separator_text |
— | Text with safe inline emphasis, spans or links | Optional split text. Scripts, event handlers and arbitrary HTML are not supported. |
separator_text_tag |
span |
span, h1, h2, h3, h4, h5, h6 |
Select the type of separator. Available when separator_type is split. |
separator_width |
small |
small, medium, full |
Select the width of separator. |
separator_thickness |
1 |
Integer 1–10 | Border thickness in pixels, constrained to existing helpers. |
separator_style |
solid |
solid, dashed, dotted, double, groove, ridge, inset, outset |
Select the width of separator. |
separator_color |
— | Numeric palette slot 1–15 | Colors line, text and icon; empty inherits. |
device_visibility |
— | Space-separated web-hide-on-lg, web-hide-on-md, web-hide-on-sm, web-hide-on-xs |
Hides the corresponding independent device ranges. |
accessible_name |
— | Plain text | Optional accessible separator/group name. |
image_decorative |
false |
yes, true, 1, on to enable |
Empty image alt text and hidden decorative semantics. Otherwise reads current library alt text. |
el_id |
— | Valid unique HTML ID | Optional separator anchor without #. |
el_class |
— | String unless stated otherwise | If you wish to style particular content element differently, then use this field to add a class name and then refer to it in your css file. |
Verification
Inspect web_separator at every layout breakpoint and confirm its child content keeps a logical source and visual order. Pay particular attention to separator_type and separator_content.
Regular mode ignores split artwork/text without removing their stored values. Split headings retain heading semantics. The shortcode uses existing theme helpers and no separate module CSS or JavaScript. It remains available when the Legacy Page Builder interface is disabled. Library metadata changes appear on the next uncached render; cached pages may need refreshing.
For new block content, use Separator in Gutenberg.