# htmlburger/carbon-fields

WordPress Custom Fields Library ✨

Repository: https://github.com/htmlburger/carbon-fields
Canonical: https://ross.abutalabs.com/products/carbon-fields
Homepage: https://carbonfields.net/
Language: PHP
License: NOASSERTION
License Family: other
Topics: custom-fields, wordpress-admin
Last push: 2026-08-26T08:59:16+00:00

## Health v2 (maintenance only)
Score: 95/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 99, release rhythm 87, longevity 100
- inputs: {"age_days": 3892, "days_push": 7, "days_rel": 7, "gap_med": 34, "n_releases_24m": 4}
- flags: no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1546, forks 258 (observed 2026-08-28T04:05:01.641986+00:00)

## What it is
Carbon Fields is a developer-oriented PHP library for creating custom fields in the WordPress admin panel, installable via Composer. It supports fields for posts, taxonomy terms, users, comments, options pages, navigation menus, widgets, and Gutenberg blocks using a declarative, expressive API.

## Use cases
- add custom fields to WordPress post types
- create theme options pages in WordPress
- build Gutenberg blocks without writing JavaScript
- create repeatable nested field groups in WordPress admin
- add custom fields to taxonomy terms, users, and comments
- build custom WordPress widgets with fields
- add fields to WordPress navigation menu items

## When to choose
- you are a PHP/WordPress developer who prefers defining fields in code rather than a GUI
- you need custom fields across many WordPress content types including widgets and nav menus
- you want a free, fully-featured alternative to freemium custom field plugins
- you want to create Gutenberg blocks declaratively in PHP

## When to avoid
- you need a point-and-click admin interface for building fields without coding
- your project is not WordPress-based
- you are not comfortable working with PHP and Composer

## Facets
- artifact type: library
- maturity: active
- function: ui-components, form-handling, templating
- domain: cms, web-development, developer-tools
- platform: php, self-hosted
- tags: wordpress, custom-fields, metaboxes, gutenberg-blocks, theme-options, composer-package, web-server

## Member repositories
- htmlburger/carbon-fields (main) score 95

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:01.641986+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T04:30:33.992451+00:00, confidence not recorded.
  - readme: https://github.com/htmlburger/carbon-fields (fetched 2026-08-28T04:05:01.641986+00:00, sha 898ca93d8ad5)
  - homepage: https://carbonfields.net/ (fetched 2026-08-29T11:31:42.190990+00:00, sha 3a0f90a395fc)
  - site_page: https://carbonfields.net/about (fetched 2026-08-29T11:31:42.199857+00:00, sha 1ff064b67350)
  - site_page: https://docs.carbonfields.net (fetched 2026-08-29T11:31:42.201740+00:00, sha 18be45fbddce)
  - site_page: https://carbonfields.net/faq (fetched 2026-08-29T11:31:42.203670+00:00, sha cbf0832d65a6)
- Data as of 2026-08-30T08:39:29.467469+00:00.