Stable tag: 0.8.0
Requires at least: 6.4
Tested up to: 7.1
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
Tags: custom fields, metadata, meta boxes, custom post types
Contributors: automattic, GaryJ
A code-only developer plugin for registering custom fields on posts, pages, custom post types, users and comments.
Custom Metadata Manager gives developers a single, consistent API for adding custom fields to any object type in WordPress: post, page, any custom post type, user and comment. Rather than offering a point-and-click interface, it follows the WordPress approach of registering content in code, so your fields live alongside the rest of your theme or plugin.
Fields are grouped into metaboxes, stored through the standard WordPress metadata APIs, and remain available even if the plugin is later deactivated. You can render fields with the built-in field types or supply your own display and sanitisation callbacks, and you can include or exclude fields and groups for specific objects, either by ID or through a callback.
This approach is particularly useful when working across multiple environments (local, staging and production), because your field definitions travel with your code and need no database synchronisation.
- Install through the WordPress admin, or upload the plugin folder to your
/wp-content/plugins/directory. - Activate the plugin through the Plugins menu in WordPress.
- Add the code to register your custom groups and fields to your theme's
functions.phpor your own plugin. - Enjoy.
Custom Metadata Manager is a developer-focused plugin: you register your fields and groups in code, typically from a theme's functions.php or your own plugin. The full API reference — object types, registering fields and groups, include and exclude rules, multifields and worked examples — is documented in DEVELOPERS.md.
- A custom metabox added to the post editing screen.
- Custom fields registered against a user profile.
- Grouped fields displayed in a metabox with descriptions.
Because the UI approach has been done many times before, and a code-based approach aligns more closely with the existing WordPress model for registering content, such as post types and taxonomies.
This is a developer feature aimed at site builders. The main benefit becomes clear when you work across multiple environments (development, staging and production): you can replicate interfaces and features without worrying about database synchronisation.
We are namespacing our public functions, and you should too. The x_ prefix keeps the plugin's functions from clashing with anything else in WordPress core, themes or other plugins.
See DEVELOPERS.md for full instructions, and the custom_metadata_examples.php file for worked examples.
Contributions are welcome. Please read CONTRIBUTING.md for how to set up a local environment, run the tests and submit a pull request.
Please report bugs and request features through the GitHub issue tracker.
Custom Metadata Manager is maintained by Automattic, and was originally created by Stresslimit. Thank you to the many community contributors who have helped shape the plugin.
The full version history is recorded in CHANGELOG.md.
This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License, version 2 or later, as published by the Free Software Foundation. It is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the LICENSE file for the full licence text.