Divi Page Cloning Workflow

Prerequisites

• Divi theme active (Divi 4 or Divi 5)
• Royal MCP Pro installed and licensed (see Getting Started)
• MCP client connected to your site (Claude.ai, Claude Desktop, ChatGPT, Cursor, etc.)
• Source Divi page to clone (any page with _et_pb_use_builder=on or [et_pb_* shortcodes / divi/* blocks)
• Cap: edit_posts minimum, plus read_post on the source

The full clone workflow

Clone Divi page 42 as "Services V2 Test" using divi_clone_page.

{
  "isError": false,
  "content": [
    { "type": "text", "text": "Cloned Divi post 42 → 4291 (\"Services V2 Test\", format=divi_4_shortcodes, shortcodes=17, blocks=0)." }
  ],
  "structuredContent": {
    "new_post_id": 4291,
    "source_post_id": 42,
    "new_title": "Services V2 Test",
    "new_status": "draft",
    "format_detected": "divi_4_shortcodes",
    "shortcode_count": 17,
    "block_count": 0,
    "edit_url": "https://yoursite.com/wp-admin/post.php?post=4291&action=edit"
  },
  "undo": {
    "token": "<64-character-hex-token>",
    "expires_at": "2026-08-08T14:23:15Z",
    "ttl_hours": 72
  }
}

On post 4291, replace the text "Web Design" with "SEO Consulting" using divi_replace_text.

On post 4291, replace "web design services" with "SEO consulting services" using divi_replace_text.

On post 4291, replace "Get a Design Quote" with "Get an SEO Audit" using divi_replace_text.

On post 4291, swap image https://yoursite.com/wp-content/uploads/2024/hero-webdesign.jpg for https://yoursite.com/wp-content/uploads/2026/hero-seo.jpg using divi_replace_image.

On post 4291, swap https://yoursite.com/wp-content/uploads/2024/testimonial-jane.jpg for https://yoursite.com/wp-content/uploads/2026/testimonial-mark.jpg using divi_replace_image.

Undo the clone with token <64-character-hex-token> using royal_mcp_undo_last_operation.

Common scenarios

Portfolio-wide template duplication

For "clone this landing page across 20 client sites," you're actually running the workflow 20 times — once per site. The Pro tool doesn't cross site boundaries. What DOES help across sites is exporting the Divi library entry from one site and importing it via divi_import_template on the others (see the divi_import_template tool ref). That's a different workflow — library-based, not clone-based.

A/B test variants of a landing page

Clone the page N times with different titles ("Landing V1", "Landing V2", "Landing V3"), retarget each with the variant copy/imagery, publish them behind an A/B test plugin. Each clone gets its own undo token — keep a note of which token maps to which variant so you can bulk-clean losing variants later.

Seasonal campaign duplication

Clone the year-ago page, run divi_replace_text to swap year references and dates, run divi_replace_image for updated imagery. Same workflow, ~5 minutes end-to-end per page.

Rebrand mid-flight

Company name changed. Clone every published Services / About / Contact / Landing page, run text replacements for the old name → new name, run image replacements for old logo → new logo, review each clone, publish and unpublish the originals in the same session. The 72-hour undo tokens give you a safety window in case a rebrand copy pass missed something.

Common issues

source_not_divi error on a page you're sure is Divi

The tool checks for _et_pb_use_builder=on meta OR [et_pb_* shortcodes / divi/* blocks in post_content. If a page was created via a starter template but never saved through the builder, the meta flag may not be set. Open the page in the Divi builder once and click Save — that seeds the flag — then retry the clone.

source_content_invalid refusal

The clone tool validates Divi 4 shortcode structure before writing (matched open/close tags, valid module names). Refusal means the source content is malformed and cloning would propagate the malformation. Fix the source in the Divi builder first, then retry.

Featured image not carried over

Divi's _et_pb_* meta doesn't include the WordPress _thumbnail_id post meta (that's a core WP field, not a Divi one). If you want the featured image on the clone too, use wp_set_featured_image after the clone completes:

Set the featured image of post 4291 to attachment ID 1234 using wp_set_featured_image.

Retarget didn't hit a specific field

divi_replace_text walks text-bearing widget settings (title, text, content, buttonText, body, header, subtitle, caption, alt, title_text, description, placeholder). If your text lives in a module setting outside that list (e.g. custom code widget's raw HTML), the replace won't touch it. For those cases: edit manually in the Divi builder after cloning, or use wp_update_post for a whole post_content rewrite (destructive — keep the undo token handy).

Still Stuck? Two-Step Support Path

If the clone workflow isn't running the way you expected, work through these two steps in order.

Step 1: Start with the Royal MCP Troubleshooting Guide

Royal MCP Troubleshooting — Start Here covers MCP-layer issues.

For Pro-specific patterns:

• Builder session detected — if the clone fails because someone has the source or destination open in the Visual Builder
• Undo token errors
• Pro tool returned upgrade prompt with valid license

Step 2: Email priority support

If you've worked through Start Here and the relevant Pro-specific doc and the clone still isn't working, email priority support from your purchase email address at support@royalplugins.com. Priority email support is included with your license — typical response within 24 hours. Never include your license key in email; we look it up from your purchase address.