Search Over 30,000 FREE Plugins from the Official WordPress Plugin Directory Repository

Carbon Fields

WordPress developer-friendly custom fields for post types, taxonomy terms, users, comments, widgets, options and more.

Developer-oriented library for WordPress custom fields for all types of WordPress content.

Carbon fields is a plugin that can be used as a library for easy creation of custom fields in the WordPress administration panel.

Custom fields can be created for post types, taxonomy terms, users, comments, options, navigation menus and even widgets.

Supports PHP5.3 or higher.

Usage, Documentation & Resources

Author htmlburger
Contributors htmlburger, m1r0, kamenarov,, pkostadinov, panchev, tyxla, xsisqox, catahac, avakul, dilirity, sstoqnov, kaloyanivanov, brutalenemy666, magadanski_uchen, germozy
Tags advanced, association, checkbox, comment, comment meta, custom, custom field, Custom Widget, dropdown, field, file, image, magic fields, map, more fields, nested fields, option, options, Post, post meta, radio, relationship, repeater, rich text, select, simple fields, Taxonomy, term, term meta, text, textarea, theme options, type, user, user-meta, widget, wysiwyg
  1. carbon-fields screenshot 1

    Simple Post Meta container with a Rich Text field.

  2. carbon-fields screenshot 2

    Post Meta container with 2 side-by-side fields - text field and select field.

  3. carbon-fields screenshot 3

    Complex (repeater) field with several fields within it.

  4. carbon-fields screenshot 4

    Nested complex field - repeatable field groups within repeatable field groups.

  5. carbon-fields screenshot 5

    Custom widget with a set ot preferred custom fields.

  6. carbon-fields screenshot 6

    Example that contains most of the available fields, nested fields included.

  1. Install Carbon Fields either via the plugin directory, or by uploading the files to your server.
  2. Activate the plugin.
  3. That's it. You're ready to go! Please, refer to the Usage & Documentation section for examples and how-to information.


  • Improved GUI! Big thanks to @holmar and @georgknabl for the great contribution! (preview)
  • Added Brazilian Portuguese (pt_BR) translation (thanks to @elvishp2006).
  • Many bugfixes and improvements.


  • Introduced the Complex Field vertical tabbed layout.
  • Allow fields with the same name to be used in different Carbon Containers.
  • Added German (de_DE) translation (thanks to @AlexBa).
  • Added Swedish (sv_SE) translation (thanks to @fhqvst).
  • Added Russian (ru_RU) translation (thanks to @andrewostrin).
  • Added Spanish (es_ES) translation (thanks to @fitodac).
  • Performance improvements.
  • Some i18n improvements.
  • Few bugs squashed.


  • Introduced the Complex Field tabbed layout (example).
  • Added Portuguese (pt_PT) translation (thanks @pedro-mendonca).
  • Allow saving empty complex field groups.
  • Added a filter for the Google Maps API key.
  • Minor improvements and fixes.


  • Ensured compabitility with the WordPress Coding Standards.
  • Introduced new Time field type.
  • Introduced new Date_Time field type.
  • Enhanced the Composer configuration.
  • Fixed an issue with handling numeric indexes in Predefined_Options_Field field types.
  • Fixed several issues with set_width() in nested or sibling Complex fields.
  • Fixed issue with attaching user_meta container under certain conditions.
  • Enhanced post_meta container to use page post type when calling the show_on_page_children(), show_on_page() and show_on_template() methods.
  • Added French translation.
  • Introduced interface for managing header template for Complex field groups.
  • Introduced a filter for the save button on the theme_options container.
  • Renamed the textdomain to be compatible with the one, used in GlotPress.
  • Added new tests.
  • Performed various other code and UI fixes and improvements.


  • Removed Attachment field type, with backwards compatibility.
  • The File and Image field types now save the attachment ID by default.
  • Introduced File_Field::set_value_type() to easily change the saved value type.
  • Added a Vagrantfile.
  • Added some Field and Container tests.
  • Renamed Date_Field::set_options() to Date_Field::set_datepicker_options().
  • Introduced an abstract Predefined_Options_Field base for Select, Radio and Set field types.
  • Added proxy Container, Field and Widget for shorter use statements.
  • Introduced an abstract Scripts_Field base for Header Scripts and Footer Scripts field types.
  • Introduced an abstract Meta_Datastore base for all meta datastore classes.
  • Performed various other code fixes and improvements.


  • Initial version.

Q. What is the minimum supported PHP version?

A. The plugin supports PHP 5.3 and higher.

Q. I don't know much about PHP. Where is the administration interface for creating containers and fields?

A. There is no admin interface. Containers and fields are created programatically, please refer to the Usage & Documentation section for more information.

Q. Can I create custom widgets with custom fields?

A. Yes, you can! Creating custom widgets with your preferred fields is now greatly simplified.

Q. Can I create theme options pages and subpages?

A. Yes, sir! You can create as many theme options pages and subpages with your preferred custom fields.

Q. Can I create repeatable sets of fields?

A. Absolutely. We call them Complex Fields - fields that contain other fields. You can even create complex fields with multiple sets of fields. Then, when creating a repeatable entry, you can select which set of fields to use.

Q. Can I nest complex (repeatable) fields? If yes, how many levels deep?

A. Yes, you can nest the fields, at an unlimited depth. The only limit is your imagination. :)

Q. Is Carbon Fields completely free?

A. Yes.

Q. Can I use Carbon Fields for commercial purposes?

A. Sure, go ahead! It is completely open source.

Version 1.5

Requires WordPress version: 4.0 or higher

Compatible up to: 4.7.2

Last Updated 14 Dec 2016

Date Added: 01 Feb 2016

Plugin Homepage


4.8 stars
15 ratings


Not Enough Data

Works: 0
Broken: 0