Title: Custom Metadata Manager Author: Mohammad Jangda Published: October 18, 2010 Last modified: August 21, 2026 --- Search plugins ![](https://ps.w.org/custom-metadata/assets/banner-772x250.png?rev=3657970) ![](https://s.w.org/plugins/geopattern-icon/custom-metadata_fcfcfc.svg) # Custom Metadata Manager By [Mohammad Jangda](https://profiles.wordpress.org/batmoo/) [Download](https://downloads.wordpress.org/plugin/custom-metadata.0.8.0.zip) * [Details](https://pcd.wordpress.org/plugins/custom-metadata/#description) * [Reviews](https://pcd.wordpress.org/plugins/custom-metadata/#reviews) * [Installation](https://pcd.wordpress.org/plugins/custom-metadata/#installation) * [Development](https://pcd.wordpress.org/plugins/custom-metadata/#developers) [Support](https://wordpress.org/support/plugin/custom-metadata/) ## Description 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. ### Usage 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](https://pcd.wordpress.org/plugins/custom-metadata/DEVELOPERS.md?output_format=md). ### Contributing Contributions are welcome. Please read [CONTRIBUTING.md](https://pcd.wordpress.org/plugins/custom-metadata/CONTRIBUTING.md?output_format=md) for how to set up a local environment, run the tests and submit a pull request. ### Support Please report bugs and request features through the [GitHub issue tracker](https://github.com/Automattic/custom-metadata/issues). ### Credits Custom Metadata Manager is maintained by [Automattic](https://automattic.com), and was originally created by [Stresslimit](https://stresslimit.com). Thank you to the many [community contributors](https://github.com/Automattic/custom-metadata/graphs/contributors) who have helped shape the plugin. ### License 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](https://pcd.wordpress.org/plugins/custom-metadata/LICENSE?output_format=md) file for the full licence text. ## Screenshots [⌊A custom metabox added to the post editing screen.⌉⌊A custom metabox added to the post editing screen.⌉[ A custom metabox added to the post editing screen. [⌊Custom fields registered against a user profile.⌉⌊Custom fields registered against a user profile.⌉[ Custom fields registered against a user profile. [⌊Grouped fields displayed in a metabox with descriptions.⌉⌊Grouped fields displayed in a metabox with descriptions.⌉[ Grouped fields displayed in a metabox with descriptions. ## Installation 1. Install through the WordPress admin, or upload the plugin folder to your `/wp-content/ plugins/` directory. 2. Activate the plugin through the Plugins menu in WordPress. 3. Add the code to register your custom groups and fields to your theme’s `functions. php` or your own plugin. 4. Enjoy. ## FAQ ### Why a code-based approach instead of a UI? 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. ### Why isn’t the function just `add_metadata_field`? Why the `x_` prefix? We are [namespacing our public functions](https://andrewnacin.com/2010/05/11/in-wordpress-prefix-everything/), and you should too. The `x_` prefix keeps the plugin’s functions from clashing with anything else in WordPress core, themes or other plugins. ### How do I use this plugin? See [DEVELOPERS.md](https://pcd.wordpress.org/plugins/custom-metadata/DEVELOPERS.md?output_format=md) for full instructions, and the `custom_metadata_examples.php` file for worked examples. ## Reviews ![](https://secure.gravatar.com/avatar/294705243ebabf5d0363bbc1a30aa668314b8a822edd4ab2b250bf5640d09344? s=60&d=retro&r=g) ### 󠀁[Very good for simple development](https://wordpress.org/support/topic/very-good-for-simple-development/)󠁿 [tantaluspl](https://profiles.wordpress.org/tantaluspl/) July 10, 2017 If all you need is adding few custom metaboxes here and there to couple them with some other functionalities, this is a very clean solution. Saved me a ton of work! [ Read all 5 reviews ](https://wordpress.org/support/plugin/custom-metadata/reviews/) ## Contributors & Developers “Custom Metadata Manager” is open source software. The following people have contributed to this plugin. Contributors * [ Mohammad Jangda ](https://profiles.wordpress.org/batmoo/) * [ Automattic ](https://profiles.wordpress.org/automattic/) * [ Gary Jones ](https://profiles.wordpress.org/garyj/) [Translate “Custom Metadata Manager” into your language.](https://translate.wordpress.org/projects/wp-plugins/custom-metadata) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/custom-metadata/), check out the [SVN repository](https://plugins.svn.wordpress.org/custom-metadata/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/custom-metadata/) by [RSS](https://plugins.trac.wordpress.org/log/custom-metadata/?limit=100&mode=stop_on_copy&format=rss). ## Changelog The full version history is recorded in [CHANGELOG.md](https://pcd.wordpress.org/plugins/custom-metadata/CHANGELOG.md?output_format=md). ## Meta * Version **0.8.0** * Last updated **9 hours ago** * Active installations **700+** * WordPress version ** 6.4 or higher ** * Tested up to **7.1** * PHP version ** 7.4 or higher ** * Language * [English (US)](https://wordpress.org/plugins/custom-metadata/) * Tags * [custom fields](https://pcd.wordpress.org/plugins/tags/custom-fields/)[custom post types](https://pcd.wordpress.org/plugins/tags/custom-post-types/) [meta boxes](https://pcd.wordpress.org/plugins/tags/meta-boxes/)[metadata](https://pcd.wordpress.org/plugins/tags/metadata/) * [Advanced View](https://pcd.wordpress.org/plugins/custom-metadata/advanced/) ## Ratings 4.4 out of 5 stars. * [ 3 5-star reviews ](https://wordpress.org/support/plugin/custom-metadata/reviews/?filter=5) * [ 1 4-star review ](https://wordpress.org/support/plugin/custom-metadata/reviews/?filter=4) * [ 1 3-star review ](https://wordpress.org/support/plugin/custom-metadata/reviews/?filter=3) * [ 0 2-star reviews ](https://wordpress.org/support/plugin/custom-metadata/reviews/?filter=2) * [ 0 1-star reviews ](https://wordpress.org/support/plugin/custom-metadata/reviews/?filter=1) [Your review](https://wordpress.org/support/plugin/custom-metadata/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/custom-metadata/reviews/) ## Contributors * [ Mohammad Jangda ](https://profiles.wordpress.org/batmoo/) * [ Automattic ](https://profiles.wordpress.org/automattic/) * [ Gary Jones ](https://profiles.wordpress.org/garyj/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/custom-metadata/)