Migration Guide

If you’re running a version of Page Builder Framework < 1.7, manual action is required to update to the new version in the WordPress repository.

Users of the Premium Add-On will see the following message after they’ve updated the Add-On to the latest version.

This version is compatible only with the latest version of Page Builder Framework which is now available from the WordPress repository. To update to the latest version of Page Builder Framework, a manual update is required.

Important! Before we get started, make sure you back up your WordPress database!


  1. navigate to Appearance -> Themes in your WordPress admin and hit “Add New” at the top left, next to the headline
  2. search for “Page Builder Framework” and click install
  3. if you’re using a child theme, follow the instructions under “Migration”
  4. if you were not using a child theme before, activate Page Builder Framework

Now you’ve successfully installed the current version of Page Builder Framework and the migration message above should be gone. Now, lets start the migration.


The next step is, installing the migration tool that moves the settings from the old version to the new version of Page Builder Framework.

You can download the migration tool here or from your account area.

Using the migration tool is simple.

  1. navigate to Appearance -> Migration
  2. choose wether you’re using a child-theme or not
  3. check “Soft Migration”
  4. hit save

That moves the existing settings over to the new version of Page Builder Framework.

You get 2 options here:

  • Soft Migration – leaves your old settings for Page Builder Framework in the database
  • Hard Migration – removes your old settings for Page Builder Framework in the database

It’s important to first run a soft migration, in case something goes wrong. That way you can always switch back for troubleshooting.

If the soft migration was successful and your site looks just like it did before, it’s recommended to run the hard migration as well, to remove old theme related data from your database.

Note: This process is the same on a WordPress multisite and only needs to be executed once from the main site of your network. The changes will automatically apply to all subsites.

Please deactivate and delete the migration plugin after the migration process.

Manual Changes (child-theme only)

We’re almost done!

Although I’ve tried to keep this process as simple as possible, there’s one line of code we have to edit manually if we are using a child theme. Assuming your child theme is still activated,

  1. navigate to Appearance -> Editor
  2. change Template from wpbf to page-builder-framework in your style.css
  3. hit update
  4. done!

In Closing

You’ve successfully moved to the new version of Page Builder Framework and the migration message above should be gone.

You’ll now be able to receive automatic updates, just like before. It is now save to delete the old version (1.6.x) of Page Builder Framework from your WordPress installation.

If you have any questions or need help with this migration process, feel free to create a support ticket and reach out to me. I’m here to help!

Click the button below to load the video from YouTube.

Load Video
Page Builder Framework

A Page Builder’s best friend.

Sign up for the Newsletter

Get notified about the latest features and updates.

Join the Community

Cookie Preference

Please select an option. You can find more information about the consequences of your choice at Help. Privacy Policy | Imprint

Select an option to continue

Your selection was saved!



To continue, you must make a cookie selection. Below is an explanation of the different options and their meaning.

  • Accept cookies:
    All cookies such as tracking and analytics cookies.
  • Reject tracking cookies:
    No cookies except for those necessary for technical reasons are set.

You can change your cookie setting here anytime: Privacy Policy. Imprint