Nest and combine shortcodes safely
Container elements expect particular child shortcodes. Preserve this hierarchy when reviewing or moving raw builder content.
Core page structure
[vc_row]
[vc_column]
[web_title title="Section title"]
[vc_column_text]Section copy[/vc_column_text]
[/vc_column]
[/vc_row]
A Row contains Column elements. An Inner Row belongs inside a column and contains Inner Column elements. Visible content belongs inside a column rather than directly inside a row.
Component families
| Parent | Expected child |
|---|---|
web_accordion |
web_accordion_content |
web_carousel |
web_carousel_content |
web_gmap |
web_gmap_marker, web_gmap_route, or web_gmap_dynamic_route |
web_modal |
web_modal_content |
web_offcanvas |
web_offcanvas_content |
web_parallax_scene |
Parallax layer shortcodes |
web_pricing_list |
web_pricing_list_item |
web_slider |
web_slide |
web_tabs |
web_tabs_content |
web_interactive_infography |
web_infography_spot |
audio_playlist |
audio_item |
Finder compatibility elements have their own finder, row, column, content and field hierarchy. Preserve builder-generated nesting when maintaining an existing Finder; use Faceted Search for new filtering experiences.
Edit nested content
- Duplicate the current content before a large raw edit.
- Identify every opening and closing shortcode.
- Keep child tags inside their documented parent.
- Keep rows and columns balanced.
- Update the page.
- Reopen the component in Page Builder.
- Verify both the builder canvas and the public page.
Avoid fragile combinations
- Do not place the same modal, off-canvas or slider ID more than once.
- Avoid placing one interactive container inside another unless the visitor interaction remains clear.
- Do not use repeated empty gaps or text blocks to create layout.
- Do not wrap a complete results component in another component that also owns pagination or filtering.
- Keep script-only or data-only helper elements beside the visible component that consumes them.
Troubleshooting
If raw shortcode text appears publicly, first check the exact tag spelling and closing tag. If a child disappears, confirm it remains inside the expected parent and that its parent is not hidden by device visibility.