Create a definition
Open Settings > Metafield definitions.
Choose Add definition.
Choose what the field applies to, such as Products, Customers, or Orders.
Enter a clear name and an optional description for your staff.
Enter a namespace and key, such as
detailsandcare. The namespace groups related fields and the key names this field within it. Namespaces that start withapp:are reserved for installed apps. Neither can be changed later.Choose the value type and add any validation rules you need.
Choose storefront, search, filter, or translation options when they are available for that field.
Save the definition, then add values to the resources it applies to.
Available value types include text, numbers, true or false, dates, date and time, URLs, choices, JSON, files, and product or variant references. Some types can also store a list of values. Store Admin shows only the options supported by the selected resource and value type.
Use names shoppers and staff can understand
The definition name is shown to staff in Store Admin. It is not automatically used as a storefront label. If your theme displays the field, choose the shopper-facing label in the theme or storefront experience that presents it.
Edit a definition
You can change the name, description, validation rules, display order, and supported visibility or translation settings later. What the field applies to, its namespace and key, and its value type remain fixed so saved values and connected integrations keep the same meaning.
Editing a choice label keeps the saved choice selected. Existing choice keys stay fixed in the form. Stricter validation applies when a value is next saved; existing values are not rewritten automatically.