This is the official API documentation for WPBakery Page Builder, providing comprehensive guides and references for developers working with the plugin. The documentation covers custom element development, parameter settings, hooks, filters, and advanced customization techniques.
This documentation is designed for developers who want to:
- Create custom elements and add-ons for WPBakery Page Builder
- Extend and customize the page builder functionality
- Integrate WPBakery with themes and other plugins
- Understand the core API and architecture
WPBakery API documentation is built with Docusaurus, a modern static website generator. Documentation is written in Markdown, making it easy to contribute.
- Fork this repository on GitHub
- Clone your forked repository to your local machine:
git clone https://github.com/YOURUSERNAME/wpb-docs-new.git
- Navigate to the project directory:
cd wpb-docs - Initialize and start development
yarn installyarn startThis command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server.
yarn buildThis command generates static content into the build directory and can be served using any static contents hosting service.
This documentation uses Algolia DocSearch for search functionality.
Copy
.env.exampleto.env.local:cp .env.example .env.local
Add your Algolia Admin API key to
.env.local(never commit this file!)
Indexing runs automatically after every deploy to main (see .github/workflows/deploy.yml), so you don't need to index manually after merging changes.
To index manually (e.g. while testing locally):
yarn run index-algoliaOr build and index together:
yarn run build-and-indexSecurity Note: The Admin API key should only be stored in .env.local (gitignored) or as a CI/CD secret. Never commit it to the repository.
CI setup: For the automatic indexing step to run, configure these in the repository's Settings → Secrets and variables → Actions:
ALGOLIA_ADMIN_KEY(secret, required) — the Algolia Admin API keyALGOLIA_APP_ID(variable, required) — the Algolia Application IDALGOLIA_INDEX_NAME(variable, optional) — defaults towp_kbSITE_URL(variable, optional) — the canonical site URL. Drives the Docusaurusurl(sitemap/canonical links), the generatedCNAMEcustom domain file, and the URLs of indexed Algolia records. Currentlyhttps://kb-new.wpbakery.com; on domain switch day update this variable tohttps://kb.wpbakery.comand re-run the deploy workflow. When unset, builds fall back tohttps://kb.wpbakery.com(Algolia indexing script falls back tohttp://localhost:3000)
Using SSH:
USE_SSH=true yarn deployNot using SSH:
GIT_USER=<Your GitHub username> yarn deployIf you are using GitHub pages for hosting, this command is a convenient way to build the website and push to the gh-pages branch.
- WPBakery Page Builder - Official website
- Customer Center - Support and resources
- Docusaurus Documentation - Learn more about Docusaurus
Documentation content is maintained by the WPBakery team.