=== 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: 5.9
Requires PHP: 7.1
Tested up to: 6.7.2
Stable tag: 5.10.8
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.
- [Slim SEO Schema](https://wpslimseo.com/products/slim-seo-schema/) - An advanced, powerful and flexible plugin to add schemas to WordPress.
- [Slim SEO Link Manager](https://wpslimseo.com/products/slim-seo-link-manager/) - Build internal link easier in WordPress with real-time reports.
- [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.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.)

= 5.10.0 - 2024-08-19 =

**Highlights:**

This version introduces new parameter for field: `clone_empty_start` that makes cloneable groups **not** showing inputs at first. When users want to enter data, they'll need to click the "+ Add new" button. This feature updates the UI and makes it cleaner.

See more details on our [blog post](https://metabox.io/clone-empty-start/).

Other changes:

- Replace `sprintf` with string concatenation in `RWMB_Field::show` to fix issues when `$field['before']` or `$field['after']` contains special characters (`%`). Props Daniel Haim.
- Fix mismatch filter params for `rwmb_meta` when no fields are found.

= 5.9.11 - 2024-07-10.0 =
- Make validation work for blocks
- Fix JavaScript validation error in site editor
- Set default minute step = 5 for datetime/time pickers
- Security fix for ajax getting posts

= 5.9.10 - 2024-07-02 =
- Fix modal not updating URL (when add new)
- Security fix for ajax get posts/users

= 5.9.9 - 2024-06-20 =
- Fix show hide checkbox tree
- Fix default value not display as selected time
- Fix datetime field not removing value when set inline & timestamp = true

= 5.9.8 - 2024-05-08 =
- Fix activation error on ajax request since WordPress 6.5

= 5.9.7 - 2024-04-18 =
- Revert fix for Meta Box Conditional Logic

= 5.9.6 - 2024-04-17 =
- Add progress bar for field `file_upload`
- Force returned value of sanitize color to string
- Enqueue assets for FSE and widget (with block editor) screens
- Fix jumping layout for Meta Box Conditional Logic
- Fix errors when using cloneable map/osm fields

= 5.9.5 - 2024-03-26 =
- Add `save_format` settings to `time` field
- Field icon SVG not displaying

= 5.9.4 - 2024-02-27 =
- Fix security issue when users set object id in the helper functions where they don't have permission to view (such as private posts)

= 5.9.3 - 2024-02-02 =

**Highlights:**

Fix security issue of the output shortcode `[rwmb_meta]` not escaping. Users can disable escaping (to revert the previous behavior) by adding this snippet:

`add_filter( 'rwmb_meta_shortcode_secure', '__return_false' );
// or
add_filter( 'rwmb_meta_shortcode_secure_{$field_id}', '__return_false' );`

Other changes:

- Fix compatibility with PHP 8.3
- Fix not showing more than 10 saved users or terms

= 5.9.2 - 2024-01-22 =
- Validation: fix PHP warning when fields has non-consecutive keys
- Icon field: fix custom icon not working
- Update jQuery Validation to 1.20.0. Props Maarten.
- Prepare css to be inlined. Props Maarten.

= 5.9.1 - 2023-12-25 =
- Fix preview posts not working in the block editor in WP 6.4.
- Icon field: allow to set relative path/URL for settings
- Icon field: add support for scanning CSS file (`icon_css` setting) and parsing CSS class
- Autocomplete field: fix not saving first value if the value is 0 (integer).

= 5.9.0 - 2023-11-22 =

**Highlights:**

Add new `icon` field type, which supports Font Awesome Free, Font Awesome Pro and custom icon set. Can be used with icon font with CSS file or with SVGs. See the [plugin docs](https://docs.metabox.io/fields/icon/) for how to use it.

The `icon` field type will be added to the new version of Meta Box Builder soon, which will allow you to configure its settings with UI.

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

== Upgrade Notice ==
