CMB2 is a developer's toolkit for building metaboxes, custom fields, and forms for WordPress that will blow your mind.
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github More updating of links/language to reflect organizational change Apr 4, 2017
css Update the draggable state's border style Jun 10, 2018
images Fix WP VIP PHPCS in images/index Apr 3, 2017
includes Qa/phpcs cleanup (#1179) Oct 20, 2018
js make repeatable fields drag sortable Jun 1, 2018
languages Update translations to what is in the translation repos May 29, 2018
tests Update tests with data-hash attributes May 25, 2018
.gitattributes s/ for consistency with other OS projects Jun 1, 2016
.gitignore Ignore apigen and add grun task for it Mar 3, 2016
.scrutinizer.yml update scrutinizer.yml May 22, 2018
.travis.yml move after_script stuff to separate bash script May 22, 2018 Fix PR urls in changelog Oct 22, 2018 Updated translation section in Oct 10, 2017
Dockunit.json Add more dockunit test environments Feb 19, 2015
Gruntfile.js Add proper banners to css files and clean up inline comment style Mar 29, 2018 Add 3 custom field types from @scottsawyer to readme resources. Closes Oct 8, 2018
bootstrap.php Change to initate CMB2 hookup via "cmb2_init_hookup_{$cmb_id}". Allow… Aug 10, 2017
composer.json Cleanup contributors May 29, 2018
coverage.clover update coverage clover May 21, 2018
example-functions.php document inline/hierarchical taxonomy radio/multicheck types in examp… May 24, 2018
index.php More phpcs fixes Mar 1, 2017
init.php Cleanup contributors May 29, 2018
package.json Bump to 2.4.2 for bug-fix release May 29, 2018
phpunit.xml.dist ignore example-functions.php in coverage May 22, 2018
readme.txt add our minimum required php version to the readme Oct 19, 2018


Gitter Travis Scrutinizer Code Quality Scrutinizer Coverage Project Stats


Contributors: jtsternberg, webdevstudios, zao, humanmade
Tags: metaboxes, forms, fields, options, settings
Requires at least: 3.8.0
Tested up to: 4.9.6
Stable tag: 2.4.2
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.