

Product Fields overview and schema management (Product Groups and fields).
Luma Product Fields is a lightweight, WooCommerce-native way to add searchable, sortable product specifications that are simple to manage in admin and easy for customers to compare.
Use it to create your own product fields, update values quickly in both the product editor and inline list view, and present product specs in a clear, consistent format.
You can optionally use Product Groups to assign different sets of fields to different types of products, so each product only shows the specs that matter.
It’s fast, intuitive, and built specifically for WooCommerce — ideal for stores that want better product pages without extra complexity.
And if you ever need custom behavior, it is also developer-friendly and extendable.
Luma Product Fields lets you define and display custom product specification fields such as:
These fields are designed for product specification data — the kind of structured details customers compare before buying.
For taxonomy-based fields (like Single Select, Checkboxes, and Autocomplete), you can enable clickable values on the product page.
Example: if a product has “Material: Merino”, customers can click “Merino” and view other products with the same spec value.
This makes your specification table not only informative, but also a smart discovery path for shoppers.
If you are moving from older field setups, Luma Product Fields includes built-in migration tools to bring legacy values into a cleaner structured field system.
Migration controls are available in WooCommerce settings (Tools tab), including unit alias support for smoother matching when older unit labels differ.
You can start simple with one shared field set for all products, then grow into Product Groups when your catalog gets broader.
Add Custom Fields
Define the fields your products need. Core field types include:
Autocomplete – suggest existing terms, allow new (taxonomy-backed)
Each field has:
A label
cm, g, mm, kg) shown in admin and frontend
(Optional) Create Product Groups (field sets by product type)
A Product Group lets you assign a specific set of fields to a specific type of product.
Think of it as “field sets”, not categories.
Examples:
Yarn: needle size, fiber composition, gauge
Key points:
You can use the plugin without Product Groups (for example a single global field schema), but Product Groups make it easier to maintain different spec sets for different product types.
Assign Products (if using Product Groups)
When a product is assigned to a Product Group, it automatically receives the fields defined for that group.
Edit Values Easily
Automatic Frontend Display
The plugin outputs a clean, structured specification section (the Additional Information tab) on product pages:
Graceful fallback if some values are missing
In settings, you can opt to also show values like SKU, Product Tags, weight, dimensions, categories, and WooCommerce-native GTIN in the same table.
The frontend output can be customized using hooks and filters.
For advanced use cases, developers can fully override or replace the rendering logic via theme or plugin code.
Most stores can be up and running in minutes:
Quick examples:
Start with a small set, then expand once you see what customers actually use.
Settings (Tabbed UI)
Under WooCommerce Settings Products Luma Product Fields, settings are grouped into tabs:
Built-in package weight and package size tooltip texts are editable in settings.
The plugin works on block themes (for example Twenty Twenty-Four), but the taxonomy term archives for linkable fields are currently rendered via a PHP template for maximum compatibility.
Technical note: Because these archives are rendered via a custom PHP template (not a native block template), the template explicitly enqueues block/global styles and renders the theme header/footer template parts early so block themes keep expected typography and navigation layout.
This means some “pixel-perfect parity” details (for example button styles and some typography that would normally be applied by native Woo/blocks) may differ.
Full “pure blocks / block template” parity for these archives is planned in a future version.
Luma Product Fields is designed to be SEO-friendly:
WooCommerce-native design
No external field frameworks — just clean, optimized product metadata.
Lightweight and fast
Focused solely on product data, not general-purpose content fields.
Variation-aware
Variation-specific fields are supported out of the box.
Automatic frontend output
No templates or shortcodes needed, with optional overrides.
Powerful admin workflow
Inline editing saves hours of product management time.
Shoppable specs with linkable values
Turn key specification values into clickable paths to related products.
Developer-friendly
Class-based, namespaced, and hookable. Register custom field types, override rendering, hook into formatting, and integrate with third-party logic.
Future-proof schema
Product Groups let you enforce consistent data structures across similar products.