Fork if CMB2 with many added features for a clean UI.

Installs: 117

Dependents: 0

Suggesters: 0

Security: 0

Stars: 1

Watchers: 0

Forks: 534

Open Issues: 0



This is a maintained fork of the original CMB2 WordPress plugin. All original functional will be kept available within this fork.

Purpose of this fork

Sometimes pull request take a while or never get approved. This fork has any pull requests I have submitted already merged and ready to use.

Enhancements (non exhaustive)

  1. Drag sorting for repeatable fields. GitHub issue/pull request detail
  2. Drag sorting for groups. GitHub issue/pull request detail
  3. Support custom elements in group markup. GitHub issue/pull request detail
  4. Remove default taxonomy meta boxes from any meta box context. GitHub issue/pull request detail
  5. Fix rest_value_cb field parameter GitHub issue/pull request detail
  6. Fix custom groups without ids GitHub issue/pull request detail
  7. Support textarea_code within group, Gutenberg, sortable, and repeatable. GitHub issue/pull request detail


composer require lipemat/cmb2


require __DIR__ . '/vendor/autoload.php'

Original Readme

Contributors: Mat Lipe, jtsternberg, webdevstudios, zao, humanmade
Tags: metaboxes, forms, fields, options, settings
Requires at least: 3.8.0
Tested up to: 5.3.2
Stable tag: 2.7.0
License: GPLv2 or later
License URI:

Wordpress plugin Wordpress Wordpress rating

Complete contributors list found here:


CMB2 is a developer's toolkit for building metaboxes, custom fields, and forms for WordPress that will blow your mind. Easily manage meta for posts, terms, users, comments, or create custom option pages.

Download plugin on

CMB2 is a complete rewrite of Custom Metaboxes and Fields for WordPress. To get started, please follow the examples in the included example-functions.php file and have a look at the basic usage instructions.

You can see a list of available field types here.

If you are coming from the original "Custom Metaboxes and Fields for WordPress" plugin, please read this post for the CMB2 background story.


Development occurs on Github, and all contributions welcome. Please read the CONTRIBUTING doc for more details.

A complete list of all our awesome contributors found here:



If you are looking to provide language translation files, Please do so via WordPress Plugin Translations.

3rd Party Resources

Custom Field Types

Other Helpful Resources



If installing the plugin from

  1. Upload the entire /CMB2 directory to the /wp-content/plugins/ directory.
  2. Activate CMB2 through the 'Plugins' menu in WordPress.
  3. Copy (and rename if desired) example-functions.php into to your theme or plugin's directory.
  4. Edit to only include the fields you need and rename the functions.
  5. Profit.

If including the library in your plugin or theme:

  1. Place the CMB2 directory inside of your theme or plugin.
  2. Copy (and rename if desired) example-functions.php into a folder above the CMB2 directory OR copy the entirety of its contents to your theme's functions.php file.
  3. Edit to only include the fields you need and rename the functions (CMB2 directory should be left unedited in order to easily update the library).
  4. Profit.


Known Issues

  • Not all fields work well in a repeatable group.