BeTheme Content Migrator

Simple WordPress plugin to convert BeTheme custom content into standard post content.

★ 0stars

Install

Download source zip No release zip yet

This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/kylendowns/betheme-migrator/archive/refs/heads/main.zip

No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.

Convert BeTheme builder content stored in post meta into clean, readable post_content for standard WordPress usage. Not affiliated with BeTheme.

Adds a Tools page in wp-admin to run a one-click migration.
Finds posts/pages (and selected custom post types) that have BeTheme builder data saved in post meta under the mfn-page-items key.
Decodes the stored data and extracts:
- Rich text/HTML from content blocks.
- Image URLs and converts them into normalized (wrapped in <a>) tags.
Writes the resulting HTML into the native post_content field.
Provides a post-run summary (processed, updated, skipped, errors).

It does not migrate 1:1 BeTheme layouts, styling, or advanced components (e.g., sliders, buttons, grids, animations).
It does not guarantee perfect visual parity; it focuses on extracting core readable content (text and images).
It does not alter themes, templates, or page builder settings.
It does not remove BeTheme data from post meta; it only populates post_content.
It does not handle shortcodes or custom modules beyond basic content and image extraction.

Download the plugin from GitHub.
In WordPress Admin, go to Plugins > Add New > Upload Plugin, upload the zip, then Activate.

Back up your database. _**This operation updates postcontent at scale.
In WordPress Admin, go to Tools > BeTheme Content Migrator.
Select which post types to process.
Choose whether to overwrite existing post_content (recommended if you want to replace any existing content with extracted content).
Click Run Migration.
Review the summary and any error samples shown.

Notes:

Only posts that have the mfn-page-items meta will be processed.
If “Overwrite existing post_content” is unchecked, posts with non-empty content will be skipped.

Always test on a staging site first.
Back up before running.
Run in batches if your site is very large (you can limit selected post types and re-run as needed).
After migration, review key pages to confirm results.

Will this break BeTheme?
- No. It does not remove or modify the original BeTheme meta data; it populates post_content. You can still use BeTheme if desired.
Will the migrated content look identical?
- Not necessarily. This plugin focuses on extracting readable text and images, not reproducing layout/styling.
Can I undo the migration?
- Not automatically. Restore from a backup to revert post_content changes.
Does it migrate custom fields or builder-specific widgets?
- No. It targets main content and images.

This plugin is provided as-is. For issues or ideas, open an issue in your project repository or contact the author if contact info is provided within the plugin metadata.