bricks_clone_page

Phase 4IntermediateComplexity: 5/10

Duplicate a page with all content, settings, and fresh element IDs

Overview

Duplicates a Bricks page with all content, settings, and element structure. Creates a new page with fresh element IDs to avoid conflicts. Copies all Bricks content areas (content, header overrides, footer overrides) and page settings. Useful for creating page variants, A/B tests, or using an existing page as a starting template.

Key Features

Full content duplication

Copies all Bricks content areas including main content, header overrides, and footer overrides.

Fresh element IDs

Generates new unique element IDs in the cloned page to prevent conflicts with the source.

Page settings preserved

Copies page-level settings like SEO metadata, custom CSS, and scripts.

Configurable output

Set a custom title, slug, and status for the cloned page.

When to Use

When creating a variant of an existing page (e.g., A/B test, seasonal version)
When using an existing page as a starting template for a new page
When you need to duplicate complex page structures without rebuilding from scratch
When migrating content between similar pages with the same layout

Prerequisites

Source page must exist and have Bricks content
You should know the source page ID (use bricks_list_pages to find it)

When NOT to Use

When you only need to copy a single section — use bricks_copy_section instead
When you want a template that can be applied to multiple pages — use bricks_create_template instead
When the source page has placeholder content you would need to replace entirely — start fresh with bricks_create_page

Parameters

4 Total Parameters2 Required2 Optional

source_idnumberREQUIRED

Source page ID to clone.

new_titlestringREQUIRED

Title for the cloned page.

new_slugstringoptional

URL slug for the cloned page. Auto-generated from title if omitted.

new_statusstringoptional

Status for the cloned page.

Default: draft Values: draft, publish, pending, private

Code Examples

Warning: Undefined array key "example_description" in /var/www/vhosts/mcpbricksbuilder.wecode.swiss/httpdocs/wp-content/themes/bricks/includes/elements/code.php(236) : eval()'d code on line 10

Deprecated: preg_replace(): Passing null to parameter #3 ($subject) of type array|string is deprecated in /var/www/vhosts/mcpbricksbuilder.wecode.swiss/httpdocs/wp-includes/kses.php on line 2018

Clone the homepage as an A/B test variant

JSON

{
  "tool": "bricks_clone_page",
  "params": {
    "source_id": 33,
    "new_title": "Homepage - Variant B",
    "new_slug": "home-variant-b",
    "new_status": "draft"
  }
}

Response

{
  "page_id": 210,
  "title": "Homepage - Variant B",
  "slug": "home-variant-b",
  "status": "draft",
  "element_count": 47
}

Common Mistakes

Warning: Undefined array key "fix_description" in /var/www/vhosts/mcpbricksbuilder.wecode.swiss/httpdocs/wp-content/themes/bricks/includes/elements/code.php(236) : eval()'d code on line 47

Deprecated: preg_replace(): Passing null to parameter #3 ($subject) of type array|string is deprecated in /var/www/vhosts/mcpbricksbuilder.wecode.swiss/httpdocs/wp-includes/kses.php on line 2018

Warning: Undefined array key "wrong_code" in /var/www/vhosts/mcpbricksbuilder.wecode.swiss/httpdocs/wp-content/themes/bricks/includes/elements/code.php(236) : eval()'d code on line 48

Warning: Undefined array key "right_code" in /var/www/vhosts/mcpbricksbuilder.wecode.swiss/httpdocs/wp-content/themes/bricks/includes/elements/code.php(236) : eval()'d code on line 49

The cloned page is an exact copy — remember to update text, images, and links that should differ from the source page.

Warning: Undefined array key "fix_description" in /var/www/vhosts/mcpbricksbuilder.wecode.swiss/httpdocs/wp-content/themes/bricks/includes/elements/code.php(236) : eval()'d code on line 47

Deprecated: preg_replace(): Passing null to parameter #3 ($subject) of type array|string is deprecated in /var/www/vhosts/mcpbricksbuilder.wecode.swiss/httpdocs/wp-includes/kses.php on line 2018

Warning: Undefined array key "wrong_code" in /var/www/vhosts/mcpbricksbuilder.wecode.swiss/httpdocs/wp-content/themes/bricks/includes/elements/code.php(236) : eval()'d code on line 48

Warning: Undefined array key "right_code" in /var/www/vhosts/mcpbricksbuilder.wecode.swiss/httpdocs/wp-content/themes/bricks/includes/elements/code.php(236) : eval()'d code on line 49

Always clone as "draft" first to avoid duplicate published pages. Review and customize before publishing.

Tips & Warnings

Best practice: Always clone as draft status, review the content, customize what needs to change, then publish. This avoids accidentally having two identical published pages.

SEO note: Duplicate content across two published pages can harm SEO. Make sure to either differentiate the content or keep the variant as draft/private.

Return Values

Field	Type	Description
`page_id`	number	The new cloned page ID.
`title`	string	Title of the cloned page.
`slug`	string	URL slug of the cloned page.
`status`	string	Publication status of the cloned page.
`element_count`	number	Number of elements copied to the new page.

Related Tools

Technical Details

Tool ID

bricks_clone_page

API Endpoint

/bricks-mcp/v1/pages/{source_id}/clone

HTTP Method

POST

Namespace

pages-elements

Source File

pages/utilities.ts

Version

1.0

Min Bricks Version

1.9

Requires Auth

Yes

Changelog

v1.0

Initial release

20250101