/migrate-wpbakery-to-bricks

name: migrate-wpbakery-to-bricks
description: "Use when the user says 'migrate wpbakery to bricks', 'convert visual composer to bricks', or wants to modernize a WPBakery site onto Bricks. Parses WPBakery shortcodes, maps elements to their Bricks equivalents, and creates draft duplicates for review."
license: MIT
metadata:
  author: Respira for WordPress
  author_url: https://respira.press
  version: 2.2.0
  mcp-server: respira-wordpress
  category: migration

Migrate WPBakery to Bricks

**Version:** 2.2.0 **Updated:** 2026-09-13 **Freshly updated:** v2.1.0 adds design-token awareness: conversion writes now register the colors and typography they carry as named design tokens in Bricks' own global styles, and converted pages reference those tokens instead of carrying value copies. Reuse registered tokens instead of re-inlining raw values, and report the registration in the migration summary.

Converts WPBakery Page Builder pages to Bricks Builder. Parses WPBakery's shortcode-based content from post_content, maps each element to its Bricks equivalent, generates a migration plan for approval, and writes clean Bricks JSON to the target pages. Use this skill whenever someone wants to move from WPBakery to Bricks, modernize an older WPBakery site with Bricks, or switch page builders from WPBakery/Visual Composer to Bricks.

What This Skill Does

WPBakery is one of the most common legacy page builders — it comes bundled with thousands of ThemeForest themes and millions of sites still use it. Moving to Bricks is a significant modernization: from shortcode-based content in `post_content` to clean JSON in `_bricks_page_content_2`, from heavy frontend CSS/JS to Bricks' lightweight rendering, and from an aging interface to a modern visual editor.

This skill handles the format translation — parsing WPBakery's `[vc_*]` shortcodes, decoding its URL encoding and Design Options CSS, and generating proper Bricks JSON with correct element hierarchies and settings.

**Handles:**

• vc_row/vc_column → Bricks Section/Container elements
• vc_column_text → Bricks Text Basic element (parsed for headings, paragraphs)
• vc_single_image → Bricks Image element
• vc_btn/vc_button → Bricks Button element
• vc_video → Bricks Video element
• vc_separator → Bricks Divider element
• vc_empty_space → Bricks spacing (via container padding or dedicated spacer)
• vc_custom_heading → Bricks Heading element
• vc_gallery/vc_images_carousel → Bricks Gallery/Carousel element
• vc_toggle → Bricks Accordion item
• vc_accordion → Bricks Accordion element
• vc_tabs → Bricks Tabs element
• vc_raw_html/vc_raw_js → Bricks Code element
• vc_icon → Bricks Icon element
• vc_gmaps → Bricks Map element
• vc_progress_bar → Bricks Progress Bar element
• vc_row_inner/vc_column_inner → nested Bricks containers
• Design Options CSS → Bricks settings (background, padding, border)
• el_class/el_id → Bricks custom CSS classes and attributes

**Preserves:**

• All text content and HTML formatting
• Image URLs, alt text, captions
• Typography where explicitly set
• Color values from Design Options
• Spacing from Design Options
• Background colors and images
• Button labels, URLs, targets
• Video embed URLs
• Gallery image sets
• CSS classes (el_class) and IDs (el_id)

What This Skill Does NOT Do

• **Theme-bundled custom elements** — Many ThemeForest themes add custom WPBakery elements (team member, portfolio, testimonial, pricing, etc.). These are theme-specific shortcodes with no Bricks equivalent. They are flagged for manual recreation.
• **WPBakery addons** — Ultimate Addons for WPBakery, Starter Templates, Starter Sites, and other addon plugins add proprietary elements that cannot be auto-mapped.
• **vc_grid/vc_masonry_grid** — Post grid elements with complex queries. These need Bricks' Query Loop or posts element configured manually.
• **Revolution Slider / Layer Slider** — Often bundled with WPBakery themes but are separate plugins outside migration scope.
• **Complex Design Options** — WPBakery encodes CSS in a single attribute string. Background gradients, complex border configurations, and CSS filters may be partially extracted.
• **Frontend editor positioning** — Pixel-precise layouts from WPBakery's frontend editor may need spacing adjustment.
• **Templates** — WPBakery saved templates are not auto-converted to Bricks templates.

Requirements

• Respira for WordPress plugin installed and connected
• MCP connection active (desktop or WebMCP)
• WPBakery Page Builder plugin active (to ensure shortcodes are parseable)
• Bricks theme installed and active (to write target content)
• Read access to scan WPBakery content
• Write access to create duplicates with Bricks content

Trigger Phrase

• "migrate wpbakery to bricks"

Alternative Triggers

• "convert wpbakery to bricks"
• "switch from wpbakery to bricks"
• "migrate visual composer to bricks"
• "rebuild wpbakery pages in bricks"
• "move from wpbakery to bricks"
• "replace wpbakery with bricks"
• "modernize visual composer site"

Source Builder: WPBakery

WPBakery stores content as shortcodes in `post_content`:

[vc_row full_width="stretch_row" css=".vc_custom_123{padding:40px;background:#f5f5f5}"]
  [vc_column width="1/2" el_class="custom-class"]
    [vc_column_text]
      <h2>Heading</h2>
      <p>Paragraph content.</p>
    [/vc_column_text]
    [vc_single_image image="456" img_size="large"]
  [/vc_column]
  [vc_column width="1/2"]
    [vc_btn title="Click" style="flat" link="url:https%3A%2F%2Fexample.com||target:_blank"]
  [/vc_column]
[/vc_row]

Key WPBakery specifics:

• **Column widths as fractions**: `1/1`, `1/2`, `1/3`, `2/3`, `1/4`, `3/4`, `1/6`, `5/6`
• **Inner rows**: `[vc_row_inner][vc_column_inner]` for nesting
• **CSS attribute**: Encoded Design Options — `.vc_custom_XXXXX{property:value;...}`
• **Link encoding**: `url:https%3A%2F%2F...|title:...|target:_blank|rel:nofollow`
• **Full-width**: `full_width` attribute controls row stretching
• **el_cla