[ Close ] Introducing Carbon Fields Version 3 - now with Gutenberg Blocks Support


Documentation > Complex Field > Data Storage

Data Storage

Complex field values are saved in the database in multiple rows – a row per field per group.

To be able to distinguish which value for field is, a special format of the keys (meta_key or option_name) is adopted:

{complex_field_name}_{group_name}-{field_name}_{number}, where


Name of the complex field, as passed to Field::make()


Name of the group as passed to add_fields(), or "" if only one group is present.


Name of the field in the group, as passed to Field::make()


Identifies the number of the row this value is part of.


Both the complex field name and its subfield name will be prefixed with an underscore.

Thus, the key format becomes: _{complex_field_name}_{group_name}-_{field_name}_{number}

Excited about Carbon Fields? Spread the word!