=== Meta Box ===
Contributors: elightup, metabox, rilwis, f-j-kaiser, funkatronic, PerWiklander, ruanmer, tanng
Donate link: https://metabox.io/pricing/
Tags: custom fields, custom post types, post type, custom taxonomies, meta box
Requires at least: 6.5
Requires PHP: 7.4
Tested up to: 6.9.4
Stable tag: 5.12.0
License: GPLv2 or later

Meta Box plugin is a powerful, professional developer toolkit to create custom meta boxes and custom fields for your custom post types in WordPress.

== Description ==

### WordPress custom fields plugin

[Meta Box](https://metabox.io) is a professional framework that makes building and customizing a website with dynamic data and content in WordPress fun and easy.

Meta Box helps you add [custom fields](https://metabox.io/series/custom-fields/) and dynamic data to posts, pages, custom post types, forms and anywhere you want using over 40+ different field types such as text, images, file upload, checkboxes, and more.

On top of that, each WordPress custom field type has extensive internal options for unlimited content possibilities. Complete customization and control is just a few clicks away.

> **Meta Box Lite**
> We recommend using [Meta Box Lite](https://metabox.io/lite/), a feature-rich free UI version of Meta Box that provides UI and all free features for managing custom fields and dynamic content on WordPress, including post types, taxonomies, custom fields, and relationships.

### Create any type of custom fields in WordPress

That's right – any type. No matter where you need to insert custom data and features, Meta Box's WordPress custom fields have your back, and with infinite options to boot.

**Here are just a few of the data types you can customize:**

- Posts
- Pages
- Custom post types (you can also use our free plugin [MB Custom Post Types & Custom Taxonomies](https://metabox.io/plugins/custom-post-type/) to create custom post types and custom taxonomies)
- [Taxonomies](https://metabox.io/plugins/mb-term-meta/)
- [Settings pages or Customizer sections](https://metabox.io/plugins/mb-settings-page/)
- [User profile pages](https://metabox.io/plugins/mb-user-profile/)
- [Post comments](https://metabox.io/plugins/mb-comment-meta/)

### A wide-range of field types and options

Take your standard WordPress custom field and imagine it infinitely expanded. That's how many options Meta Box gives you:

- Meta Box supports [40+ built-in WordPress custom field types](https://docs.metabox.io/fields/) for all your needs including text, textarea, WYSIWYG editor, image, file, post, select, checkbox, radio buttons, date/time picker, taxonomy, user, oembed and more to come.
- Not enough? You can also [effortlessly create your own field type](https://docs.metabox.io/custom-field-type/).
- Meta Box supports cloning fields for most field types including the WYSIWYG editor field. It also supports [repeatable field groups](https://metabox.io/plugins/meta-box-group/).

### It's developer-friendly

As a developer, you have enough on your plate. You shouldn't have to create an entirely new system for each project. Use Meta Box to your full advantage.

You can use Meta Box and its custom fields for any custom post type in WordPress on as many websites as you want so you can use it on client projects as well.

- Has an ultra-lightweight, yet powerful API that won't overload your site.
- Add only what you need instead of getting stuck with a bundle of features you don't even want that bloat your site.
- Meta Box [easily integrates with any theme and plugin](https://docs.metabox.io/integration/), and supports Composer!
- We use the [native WordPress meta data storage](https://docs.metabox.io/database/) and functions for ease of use and lightning-fast processing.
- Has a lot of [actions](https://docs.metabox.io/category/actions/) and [filters](https://docs.metabox.io/category/filters/) so you can build or change a site's appearance and behavior in the plugin.

### Don't love coding? You're in luck!

If you prefer a more visual system to create custom fields in WordPress, please use [Meta Box Lite](https://metabox.io/lite/), a feature-rich free UI version of Meta Box that provides:

- All the power of Meta Box without touching a single line of code.
- Designer-friendly, lightweight and work at top-notch speeds.
- Export your custom fields and settings to PHP. Then, add it to a new site without needing to install this extension for an incredibly lightweight option.

### Free Extensions

- Migrations from [ACF](https://metabox.io/plugins/mb-acf-migration/) or [Toolset](https://metabox.io/plugins/mb-toolset-migration/).
- Integrations with all page builder plugins like [Elementor](https://metabox.io/plugins/mb-elementor-integrator/), [Beaver Builder](https://metabox.io/plugins/meta-box-beaver-themer-integrator/), Divi, Bricks, Brizy, etc.
- Integrations with SEO plugins like [Yoast SEO](https://wordpress.org/plugins/meta-box-yoast-seo/), [Rank Math](https://metabox.io/plugins/mb-rank-math/), or Slim SEO.
- [MB Builder](https://metabox.io/plugins/meta-box-builder/): Create custom meta boxes and custom fields in WordPress using a user-friendly drag-and-drop interface.
- [MB Comment Meta](https://metabox.io/plugins/mb-comment-meta/): Add WordPress custom fields to comments in WordPress.
- [MB Custom Post Types & Custom Taxonomies](https://metabox.io/plugins/custom-post-type/): Create and manage custom post types and taxonomies with UI.
- [MB Relationships](https://wordpress.org/plugins/mb-relationships/): Create as many connections as you want from post-to-post or page-to-page.
- [MB Rest API](https://metabox.io/plugins/mb-rest-api/): Pull all meta values from posts and terms into the WP REST API responses.
- [MB FacetWP Integrator](https://metabox.io/plugins/meta-box-facetwp-integrator/): Integrates Meta Box and FacetWP to make custom fields searchable and filterable.
- [MB Text Limiter](https://wordpress.org/plugins/meta-box-text-limiter/): Limit the number of characters or words entered for text and textarea fields.

### Premium Extensions

- [MB Admin Columns](https://metabox.io/plugins/mb-admin-columns/): Display WordPress custom fields in table columns in admin.
- [MB Blocks](https://metabox.io/plugins/mb-blocks/): Create custom Gutenberg blocks with PHP, using the same syntax in Meta Box.
- [MB Columns](https://metabox.io/plugins/meta-box-columns/): Display eye-catching custom fields in WordPress by putting them into 12-column grids.
- [MB Conditional Logic](https://metabox.io/plugins/meta-box-conditional-logic/): Add visibility dependency for custom meta boxes and custom fields in WordPress.
- [MB Custom Table](https://metabox.io/plugins/mb-custom-table/): Save custom fields to custom tables instead of the default meta tables to reduce your database's size and increase its performance.
- [MB Frontend Submission](https://metabox.io/plugins/mb-frontend-submission/): Create frontend forms for users to submit posts.
- [MB Geolocation](https://metabox.io/plugins/meta-box-geolocation/): Automatically and instantly populate location data with the power of the Google Maps Geolocation API.
- [MB Group](https://metabox.io/plugins/meta-box-group/): Create repeatable groups for better appearance and structure.
- [MB Include Exclude](https://metabox.io/plugins/meta-box-include-exclude/): Show or hide meta boxes by ID, page template, taxonomy, or custom function.
- [MB Revision](https://metabox.io/plugins/mb-revision/): Track changes to custom fields in WordPress with revisions. You can compare and restore the changes smoothly.
- [MB Settings Page](https://metabox.io/plugins/mb-settings-page/): Create settings pages for themes, plugins or websites with beautiful syntax.
- [MB Show Hide](https://metabox.io/plugins/meta-box-show-hide-javascript/): Toggle meta boxes by page template, post format, taxonomy and category.
- [MB Tabs](https://metabox.io/plugins/meta-box-tabs/): Painlessly create tabs for meta boxes with multiple styles and icons.
- [MB Template](https://metabox.io/plugins/meta-box-template/): Make defining custom meta boxes and WordPress custom fields way easier with templates.
- [MB Term Meta](https://metabox.io/plugins/mb-term-meta/): Add custom fields to categories, tags or custom taxonomies.
- [MB Tooltip](https://metabox.io/plugins/meta-box-tooltip/): Display help information for custom fields with tooltips.
- [MB User Meta](https://metabox.io/plugins/mb-user-meta/): Add custom fields to users.
- [MB User Profile](https://metabox.io/plugins/mb-user-profile/): Build login, register and edit profile forms for users.
- [MB Views](https://metabox.io/plugins/mb-views/): Outputting custom fields and build front-end templates for WordPress without touching theme files.

### Detailed Documentation

We provide regularly updated, and extensive [documentation](https://docs.metabox.io) as well as [tutorials](https://docs.metabox.io/tutorials/) on how to use MetaBox and custom fields in WordPress to your advantage as well as in the most efficient way possible.

Here are a few guides to quickly get you started with Meta Box and creating your own WordPress custom fields:

- [Introduction](https://docs.metabox.io/introduction/)
- [Custom post types](https://docs.metabox.io/custom-post-types/)
- [Custom fields](https://docs.metabox.io/custom-fields/)
- [Field settings](https://docs.metabox.io/field-settings/)
- [Displaying fields](https://docs.metabox.io/displaying-fields-with-code/)

### You might also like

If you like this plugin, you might also like our other WordPress products:

- [Slim SEO](https://wpslimseo.com) - A fast, lightweight and full-featured SEO plugin for WordPress with minimal configuration.
- [Falcon](https://wpfalcon.pro) - A lightweight companion for making WordPress faster, cleaner, and more secure.
- [GretaThemes](https://gretathemes.com) - Free and premium WordPress themes that clean, simple and just work.
- [Auto Listings](https://wpautolistings.com) - A car sale and dealership plugin for WordPress.

== Installation ==

We recommend using [Meta Box Lite](https://metabox.io/lite/), a feature-rich free UI version of Meta Box that provides UI and all free features for managing custom fields and dynamic content on WordPress, including post types, taxonomies, custom fields, and relationships.

To install Meta Box Lite, go to [this page](https://metabox.io/lite/) and download it.

If you want to use Meta Box, please follow these steps:

1. Visit **Plugins > Add New** inside your WordPress dashboard
1. Search for **Meta Box**
1. Click the **Install Now** button to install the plugin
1. Click the **Activate** button to activate the plugin

[Get started here](https://docs.metabox.io/introduction/).

== Frequently Asked Questions ==

== Screenshots ==
1. Text Fields
1. Basic Fields
1. Advanced Fields
1. File Image Upload Fields
1. Media Fields
1. Post Taxonomy Fields

== Changelog ==

= 5.12.0 - 2026-04-22 =

- New field type `link` that allows you to add a link with native WordPress experience (similar to ACF)
- Auto add child blocks for allowed blocks for the `block_editor` field

= 5.11.4 - 2026-03-30 =

- Add an internal hook for enqueuing custom blocks' assets for `block_editor` field

= 5.11.3 - 2026-03-24 =

- Add `toolbar_position` option for the block editor field, which accepts value `top` (default) or `contextual`. This option is for where to display editing toolbar for blocks.
- Fix saving an empty paragraph in the block editor field
- Fix validation error persisting after removing duplicate blocks
- Fix extra empty clone saved when calling `set_post_data()` during validation

= 5.11.2 - 2026-03-05 =

**Improvements for the block editor field:**

- Add breadcrumbs
- Fix compatibility with Block Visibility plugin
- Fix not loading 3rd-party blocks
- Improve the CSS

**Other changes:**

- Fix save time format for the datetime field
- Fix icon field dropdown broken display when SVG contains double quotes
- Fix path traversal in `ajax_delete_file` for security
- Fix timestamp should not be set for the time picker field

= 5.11.1 - 2026-02-02 =

**Improvements for the block editor field:**

- Add block inspector sidebar
- Add structure panel to show the list view of blocks
- Add fullscreen mode
- Add `height` settings (default is `300px`) and allow resizing the editor

**Fixes for the block editor field:**

- Fix cannot upload images for the image block
- Fix blank site editor when using the block editor field
- Fix custom rich text formats not working
- Fix conflicts with `image_advanced` and `file_advanced` fields

**Other changes:**

- Fix cannot create new terms with required date/time fields

= 5.11.0 - 2026-01-15 =

- Add new field type: `block_editor`. See more details on our [blog post](https://metabox.io/block-editor-field-type/) and [documentation](https://docs.metabox.io/fields/block-editor/).

= 5.10.19 - 2025-11-24 =

- Fix the `use` statement with non-compound name has no effect

= 5.10.18 - 2025-11-24 =

- Fix deprecation message for `datetime` field

= 5.10.17 - 2025-11-07 =

- WPML integration: fix error when filtering value for helper functions when no fields are found.

= 5.10.16 - 2025-11-05 =

- WPML integration: filter helper functions to get the translated IDs for `post` field
- Fix cloning `post` field not clearing the value

= 5.10.15 - 2025-10-06 =

- Add `marker_draggable` option for `map`/`osm` fields to disable changing the pin on the map.

= 5.10.14 - 2025-09-15 =

- Update dependencies

= 5.10.13 - 2025-08-14 =

- Fix `get_current_screen()` error for term meta

= 5.10.12 - 2025-08-13 =

- Fix Open Street Maps field not showing (sometimes) with conditional logic
- Enqueue assets for the iframed editor, to make all fields are rendered properly in the iframed editor

= 5.10.11 - 2025-07-15 =

Fix validation for blocks

= 5.10.10 - 2025-05-21 =
- Fix datetime field returns null
- Fix single image field not working with Polylang Pro
- Fix reveal password icon not working

= 5.10.9 - 2025-05-08 =
- Add button to toggle password (#1630)
- Add gesture handling support for OSM field (#1631)
- Datetime & select2: use user's locale instead of site's locale

= 5.10.8 - 2025-03-14 =
- Redesign the dashboard

= 5.10.7 - 2025-02-25 =
- Fix: max clone with clone empty start

= 5.10.6 - 2025-01-11 =
- Fix validation for dash ids
- Fix datetime fields not showing inline picker inside groups
- Fix `label_description` not working for `fieldset_text`
- Fix field label div still show when no field name but with `label_description`
- Remove `image_select` field's JS, styling with CSS only
- Add gap for key value inputs

= 5.10.5 - 2024-12-16 =
- Make validation for add new terms work
- Improve styling of meta boxes on the sidebar in the block editor
- Improve style of input with prepend and append
- Fix maps/osm fields and geolocation not working with subfields in groups
- Fix select advanced becomes normal select with cloneable setting
- Fix validation

= 5.10.4 - 2024-11-20 =
- OSM/Map fields: add support for select field type
- Add `$url` to `rwmb_oembed_not_available_string` filter
- Small CSS improvements for file input, background & button group
- Fix not returning value for helper functions for images saving in a custom folder and using a custom table

= 5.10.3 - 2024-10-30 =
- fix: std after saving
- fix: field set text save empty values
- fix: subfield's id

= 5.10.2 - 2024-09-26 =
- Fix issue with conditional logic
- Fix error when removing default taxonomy meta box in the front end or with the block editor
- Fix missing .hidden on the front end for `checkbox_tree`
- Fix required attribute for `select_tree`

= 5.10.1 - 2024-09-07 =
- Fix issue with `clone_empty_start` (validation, now showing data for the 1st clone, broken `text_list` field, etc.)

[See full changelog here](https://metabox.io/changelog/).

== Upgrade Notice ==
