docs/user/manage-products/product-metafields.mdx
Product Metafields allow you to add custom attributes to products beyond the default fields included in Spree. Whether you want to display additional product specifications on the storefront, store internal merchandising notes, or support advanced integrations, metafields give you complete flexibility directly from the admin dashboard.
Unlike legacy product properties, metafields are structured, scalable, and work seamlessly with imports, APIs, and storefront display settings.
Product metafields are ideal when you need to:
Because metafields can be created and managed entirely from the dashboard, they reduce development time and eliminate the need for database changes or code deployments.
To create a new product metafield, navigate to Settings → Metafield Definitions.
Click New Metafield Definition to open the metafield creation form.
Complete the form fields as described below.
The display name shown in the admin panel and (optionally) on the storefront.
Example:
Used to group metafields and avoid naming conflicts.
The unique identifier for the metafield (combined with the namespace).
Example:
For product metafields, select Product.
To learn more about creating metafields for other resources, see <u>Metafields</u>.
Each metafield must have a type. Selecting the appropriate type ensures your data is structured correctly.
Single-line text values.
Examples:
Multi-line text without formatting.
Examples:
Formatted content with styling options.
Examples:
Numeric values.
Examples:
True/false values.
Examples:
Structured data or multiple related values.
Examples:
Choose where the metafield should appear:
If displayed on the storefront, metafields can be used within your theme to enhance the Product Detail Page (PDP).
Once the definition is created, you can assign values to individual products.
To add metafield values for individual products:
This method is ideal for updating a small number of products.
You can also import metafields via CSV.
Use this format:
metafield.namespace.key
Example:
Fill in the values for each product.
This is especially useful when enriching large product catalogs.
Please refer to the following support articles for more information about product imports:
Here are some practical examples of how merchants use product metafields:
Product Properties are no longer supported in the latest version of Spree. Product Metafields provide a more flexible, scalable, and structured solution for managing custom product attributes.
If you previously relied on properties for product enrichment, metafields are now the recommended approach.
Product metafields give you the flexibility to tailor your product data model to your business - without relying on developers - while keeping your catalog structured, scalable, and integration-ready.