Need help with PHPageBuilder?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

267 Stars 81 Forks MIT License 557 Commits 19 Opened issues


A drag and drop page builder to manage pages in any PHP project.

Services available


Need anything else?

Contributors list

# 121,283
517 commits



PHPagebuilder is a drag and drop pagebuilder to manage pages in any PHP project.

PHPagebuilder can be used as an ultra lightweight CMS to quickly spin up new websites, or can be integrated into existing projects or your favorite frameworks (such as this version for Laravel). The server-side code does not depend on any other libraries and is blazing fast. It includes an optional website manager with a Bootstrap UI and integrates the most popular open source drag and drop pagebuilder: GrapesJS. This package is made with customization in mind, allowing you to configure, disable or replace any of its modules.

Table of Contents

How does it help me?

Whether you are a novice or an experienced web developer, PHPagebuilder can make your life easier if you find yourself in any of the following:

  • You just want to create a basic website that you can easily manage from any device.
  • You get lost installing, configuring, updating or simply using feature abundant CMS systems like Wordpress, Drupal.
  • You don't like the limited page editors in CMSs you've tried.
  • You want to build a custom website for a client within a few hours.
  • Your clients get lost in feature abundant admin panels like Drupal.
  • You hate to rely on messy plugins for features you can write in no-time in plain PHP yourself, but still want to have some admin functionality to allow other people to manage the websites you create.
  • You would like to have advanced functionality (search functionality, views displaying data of remote sources, etc.) easily manageable by your clients.


Page Builder

PHPagebuilder features a page builder built on GrapesJS. PageBuilder

Website Manager

A basic website manager is included with a Bootstrap UI. This website manager offers basic functionality to add or remove pages and to edit page settings like page title or URL. Clicking the edit button will open the page builder. Website Manager

You don't want to use the website manager? No worries, it is included for people who want to use PHPagebuilder directly out of the box. Read here how to disable or replace the website manager.


To install PHPagebuilder you either follow the quick start path, for quickly spinning up a new website, or you integrate it in your own framework or favorite project structure.


  • PHP version >= 7
  • A cool project

Quick start :rocket:

If you want to quickly start a new project with drag and drop page management functionality, you can download the boilerplate project structure and follow the steps over there.

Integrate into existing project or framework

Add code with Composer

If you are using Composer for managing PHP dependencies, you can simply run:

composer require hansschouten/phpagebuilder

Next, the PHPagebuilder can be initialised using the following PHP code: ```PHP requireonce _DIR__ . '/vendor/autoload.php';

$config = require DIR . '/config.php';

$builder = new PHPageBuilder\PHPageBuilder($config); $builder->handleRequest(); ```

should contain a copy of
, filled with your settings.

Add code without Composer

Are you not using Composer? No worries, this project is written in plain PHP without any dependencies, so it can be directly included in any PHP project!

Just download the latest release into a separate folder inside your project (we named the folder:


Next, you simply include the following code in the PHP file that should launch the page builder:

$installationFolder = __DIR__ . '/phpagebuilder';
require_once $installationFolder . '/src/Core/helpers.php';

$config = require DIR . '/config.php';

$builder = new PHPageBuilder\PHPageBuilder($config); $builder->handleRequest();

should contain a copy of
, filled with your settings.

Configure a database

If you use PHPagebuilder out of the box, it requires a database for storing your pages. Just create a database and run the queries from

. Next, add the database credentials to your config file.

Create a theme


contains a config key
in which a
are specified. To create a new theme, add a new folder to the configured themes folder. The name of this folder will be the identifier of the theme, which can be used to select the theme in the
theme > active_theme

A theme should have the following folder structure:

  • /blocks
    The blocks folder contains a sub folder for each block that can be used in the page builder. The folder of a single block contains a
    or a
    . If a
    is used, the block content (the html elements) are fully editable inside the page builder. If
    is used, the block can be rendered with server-side logic (PHP) and hence the html content itself cannot be changed from within the page builder.
  • /layouts
    The layouts folder contains a sub folder for each page layout. A page layout contains a
    file which defines the base html structure with all stylesheets and scripts needed for the blocks dragged on this type of page. Each layout requires the string:
    = $body ?>
    on the location at which the html blocks need to be added in the page layout.
  • /public
    The public folder contains all assets (css, javascript, images, etc) that should be publicly accessible. The
    shortcode can be used to point to a file in the public folder of the currently active theme. For instance the file
    can be loaded via

Blocks inside blocks

Include a block into a block or layout file

A shortcode can be used to include a block inside another block or into a layout file. For instance, adding the shortcode:

[block slug="header"]
includes the block:
inside each page that uses the

Nested blocks in the page builder

To allow dropping blocks into a block in the page builder, a blocks container should be added. To add a blocks container, simply add

at the desired location in a block view file. The following html syntax allows dropping blocks inside a bootstrap container element:
An alternative method is adding the
attribute to a html element, as shown in this example:

Customize PHPageBuilder

PHPagebuilder is build with customization in mind. It comes with an extensive example config file in wich you can easily adapt the pagebuilder to your needs.

PHPagebuilder consists of four modules (Auth, Website Manager, Pagebuilder, Routing) each of which you can disable or replace with your own implementation. To replace a module with your own implementation, implement the corresponding Contract and replace the default class by your own class in the config file.

Customize the Website Manager

Disable the module

Do you already have admin login functionality in your project? Then you can disable the website manager module by setting

in your config. Next, you use or implement the page create/edit/remove functionality in your project and then directly launch the pagebuilder. You can render the pagebuilder from your project by using the

Replace the module

If you want to use the CMS routing functionality of PHPagebuilder, but you want to have a different website manager, you can replace the website manager for your own implementation. Make sure leave

in your config, implement the WebsiteManagerContract and add your own class to your config file.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.