$2a

Editor URL format: https://example.com/wp-admin/post.php?post={ID}&action=elementor

### Step 2: Choose Editing Method

| Change Type | Method | Risk |

|-------------|--------|------|

| Text content updates | WP-CLI search-replace | Low (with backup) |

| Image URL swaps | WP-CLI meta update | Low (with backup) |

| Widget styling | Browser automation | None |

| Add/remove sections | Browser automation | None |

| Layout changes | Browser automation | None |

| Template application | Browser automation | None |

**Rule of thumb**: If you're only changing text or URLs within existing widgets, WP-CLI is faster. For anything structural, use the visual editor via browser.

### Step 3a: Text Updates via WP-CLI

**Always back up first**:

wp @site post meta get {post_id} _elementor_data > /tmp/elementor-backup-{post_id}.json

**Pre-flight checklist**:

- Back up the postmeta (above)

- Dry run the replacement

- Verify the dry run matches expectations (correct number of replacements)

- Execute

- Flush CSS cache

- Verify visually

**Simple text replacement**:

Dry run

wp @site search-replace "Old Heading Text" "New Heading Text" wp_postmeta \

--include-columns=meta_value --dry-run --precise

Execute (after confirming dry run looks correct)

wp @site search-replace "Old Heading Text" "New Heading Text" wp_postmeta \

--include-columns=meta_value --precise

**After updating**, clear Elementor's CSS cache:

wp @site elementor flush-css

If the `elementor` WP-CLI command isn't available:

wp @site option delete _elementor_global_css

wp @site post meta delete-all _elementor_css

**What's safe to replace**:

Safe
Risky

Headings text
HTML structure

Paragraph text
Widget IDs

Button text and URLs
Section/column settings

Image URLs (same dimensions)
Layout properties

Phone numbers, emails
CSS classes

Addresses
Element ordering

### Step 3b: Visual Editing via Browser Automation

For structural changes, use browser automation to interact with Elementor's visual editor.

**Login flow** (skip if already logged in via Chrome MCP):

- Navigate to `https://example.com/wp-admin/`

- Enter username and password

- Click "Log In"

- Wait for dashboard to load

**Open the editor**:

- Navigate to `https://example.com/wp-admin/post.php?post={ID}&action=elementor`

- Wait for Elementor loading overlay to disappear (can take 5-10 seconds)

- Editor is ready when the left sidebar shows widget panels

**Edit text content**:

- Click on the text element in the page preview (right panel)

- The element becomes selected (blue border)

- The left sidebar shows the element's settings

- Under "Content" tab, edit the text in the editor field

- Changes appear live in the preview

- Click "Update" (green button, bottom left) or Ctrl+S

**Edit heading**:

- Click the heading in the preview

- Left sidebar > Content tab > "Title" field

- Edit the text

- Optionally adjust: HTML tag (H1-H6), alignment, link

- Save

**Change image**:

- Click the image widget in the preview

- Left sidebar > Content tab > click the image thumbnail

- Media Library opens

- Select new image or upload

- Click "Insert Media"

- Save

**Edit button**:

- Click the button in the preview

- Left sidebar > Content tab: Text (label), Link (URL), Icon (optional)

- Style tab: colours, typography, border, padding

- Save

**Using playwright-cli**:

playwright-cli -s=wp-editor open "https://example.com/wp-admin/"

Login first, then navigate to Elementor editor

playwright-cli -s=wp-editor navigate "https://example.com/wp-admin/post.php?post={ID}&action=elementor"

Or Chrome MCP if using the user's logged-in session.

### Step 4: Manage Templates

**List saved templates**:

wp @site post list --post_type=elementor_library --fields=ID,post_title,post_status

**Export a template** (browser):

- Navigate to: `https://example.com/wp-admin/edit.php?post_type=elementor_library`

- Hover over the template > "Export Template"

- Downloads as .json file

**Import a template** (browser):

- Navigate to: `https://example.com/wp-admin/edit.php?post_type=elementor_library`

- Click "Import Templates" at the top

- Choose file > upload .json

- Template appears in the library

**Apply a template to a new page**:

- Create the page: `wp @site post create --post_type=page --post_title="New Page" --post_status=draft`

- Open in Elementor via browser

- Click the folder icon (Add Template)

- Select from "My Templates" tab

- Click "Insert"

- Customise and save

**Duplicate an existing page via WP-CLI**:

Get source page's Elementor data

SOURCE_DATA=$(wp @site post meta get {source_id} _elementor_data)

SOURCE_CSS=$(wp @site post meta get {source_id} _elementor_page_settings)

Create new page

NEW_ID=$(wp @site post create --post_type=page --post_title="Duplicated Page" --post_status=draft --porcelain)

Copy Elementor data

wp @site post meta update $NEW_ID _elementor_data "$SOURCE_DATA"

wp @site post meta update $NEW_ID _elementor_edit_mode "builder"

wp @site post meta update $NEW_ID _elementor_page_settings "$SOURCE_CSS"

Regenerate CSS

wp @site elementor flush-css

**Apply template between pages via WP-CLI**:

Get source data

SOURCE=$(wp @site post meta get {source_id} _elementor_data)

SETTINGS=$(wp @site post meta get {source_id} _elementor_page_settings)

Apply to target

wp @site post meta update {target_id} _elementor_data "$SOURCE"

wp @site post meta update {target_id} _elementor_edit_mode "builder"

wp @site post meta update {target_id} _elementor_page_settings "$SETTINGS"

Clear cache

wp @site elementor flush-css

### Step 5: Verify

Check the page status

wp @site post get {post_id} --fields=ID,post_title,post_status,guid

Get live URL

wp @site post get {post_id} --field=guid

Take a screenshot to confirm visual changes:

playwright-cli -s=verify open "https://example.com/{page-slug}/"

playwright-cli -s=verify screenshot --filename=page-verify.png

playwright-cli -s=verify close

## Critical Patterns

### Elementor Data Format

Elementor stores page content as JSON in `_elementor_data` postmeta. The structure is:

Section > Column > Widget

Each element has an `id`, `elType`, `widgetType`, and `settings` object. Direct manipulation of this JSON is possible but fragile -- always back up first and prefer `search-replace` over manual JSON editing.

### CSS Cache

After any WP-CLI change to Elementor data, you must flush the CSS cache. Elementor pre-generates CSS from widget settings. Stale cache = visual changes don't appear.

wp @site elementor flush-css

OR if elementor CLI not available:

wp @site option delete _elementor_global_css

wp @site post meta delete-all _elementor_css

### Global Widgets

Global widgets are shared across pages. Editing one updates all instances.

List global widgets

wp @site post list --post_type=elementor_library --meta_key=_elementor_template_type \

--meta_value=widget --fields=ID,post_title

**Caution**: Replacing text in a global widget's data affects every page that uses it.

### Elementor Pro vs Free

Feature
Free
Pro

Basic widgets
Yes
Yes

Theme Builder
No
Yes

Custom fonts
No
Yes

Form widget
No
Yes

WooCommerce widgets
No
Yes

Dynamic content
No
Yes

Theme Builder templates (header, footer, archive) are stored as `elementor_library` post type with specific meta indicating their display conditions.

### Common Elementor WP-CLI Commands

If the Elementor CLI extension is available:

wp @site elementor flush-css # Clear CSS cache

wp @site elementor library sync # Sync with template library

wp @site elementor update db # Update database after version change