Luma Product Fields

描述

Luma Product Fields is a lightweight, WooCommerce-native way to add searchable, sortable product specifications that are easy 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 merchants who want better product pages without extra complexity.

No coding is required to get started.

Try it in 10 minutes

1. Add 3 to 5 buyer-facing fields in WooCommerce → Product Fields.
2. Fill values on a few products (or use inline editing).
3. Open a product page and confirm your specs are clearer and easier to compare.

If you like the result, expand gradually with Product Groups and migration tools.

Why store owners choose Luma Product Fields

• Turn messy product details into clear, buyer-friendly specification tables
• Update specs faster with spreadsheet-style inline editing across many products
• Show only relevant fields per product type to keep admin screens focused
• Make taxonomy-based values clickable so shoppers can discover similar products
• Keep your catalog consistent with reusable field definitions and repeatable workflows

What this plugin does

Luma Product Fields lets you define and display custom product specification fields such as:

• Dimensions
• Material composition
• Technical specs
• Sewing/knitting details
• Difficulty levels
• Packaging information
• Color codes or systems
• Brand metadata
• Any custom structured detail your products require

These fields are designed for product specification data — the kind of structured details customers compare before buying.

Standout feature: linkable specification values

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.

Migration tools for existing catalogs

If you are moving from older field setups, Luma Product Fields includes built-in migration tools to move legacy values into cleaner structured product fields.

You can run migration from Products → Migration tools (or from the Tools tab in plugin settings), including unit alias support for smoother matching when older unit labels differ.

Included migration tools:

• Category Mapper: map product category paths into taxonomy-backed Product Fields.
• Name Extractor: extract structured numeric values from product and variation names.

How it works

You can start simple with one shared field set for all products, then grow into Product Groups when your catalog gets broader.

1. Add Custom Fields

   Define the fields your products need. Core field types include:

• Text field – simple free text
• Number – numeric value (sortable, supports units)
• Integer – whole number (sortable, supports units)
• Range (Min–Max) – two numeric values (supports units)
• Single select – dropdown from predefined terms (taxonomy-backed)
• Checkboxes – multiple predefined options (taxonomy-backed)

• Autocomplete – suggest existing terms, allow new (taxonomy-backed)

  Each field has:

• A label

• A unique slug
• A field type
• Data type (text/number)
  • Variation support (where relevant)
• Multi-value support (on relevant field types)
• Optional unit label (for example cm, g, mm, kg) shown in admin and frontend
  • Units can be managed in WooCommerce → Settings → Products → Luma Product Fields
• Optional frontend description (shown as a tooltip on the product page)
• Optional clickable links for taxonomy-based values, taking the customer to a listing of products with the same term
• An option to mark the field as backend-only (never shown on the frontend)

1. (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:

• Cameras: ISO range, sensor size, video resolution
• Lenses: focal length, aperture, mount type

• Yarn: needle size, fiber composition, gauge

  Key points:

  • A product can belong to one Product Group at a time.
  • A field can be assigned to multiple Product Groups.
  • Product Groups are not product categories; they decide which fields appear in admin for that product.

  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.

1. Assign Products (if using Product Groups)

   When a product is assigned to a Product Group, it automatically receives the fields defined for that group.

2. Edit Values Easily

• A dedicated panel in the product edit screen shows all fields for that product, with units and clear admin descriptions.
• Fields hidden from frontend are visibly marked in admin editors and list views.
• Variation fields are grouped under a dedicated Product fields section title in variation edit panels.
• A spreadsheet-style inline editor lets you edit values, sort, and search without opening products one by one.
• The Product Fields overview screen supports drag-and-drop ordering with automatic save feedback.

1. Automatic Frontend Display

   The plugin outputs a clean, structured specification section (the Additional Information tab) on product pages:

• No theme editing required
• Works with any WooCommerce theme
• Variation values override product-level values
• Only fields with values are shown
  • Taxonomy-based values can be rendered as clickable links to matching products
• Backend-only fields are hidden automatically
• Unit labels are rendered next to numeric values
• Optional tooltips from the field’s frontend description can be shown

• 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.

  Most stores can use the default frontend output without theme edits.

How do I use this plugin? (quick start)

Most stores can be up and running in minutes:

1. Go to WooCommerce → Product Fields and add 3–8 fields you know customers care about.
2. Open a product and fill in values in the Product Fields panel.
3. Use inline editing to update many products quickly.
4. Visit a product page and confirm your specs look clear and complete.
5. (Optional) If you already have legacy text/meta specs, run migration in WooCommerce → Settings → Products → Luma Product Fields → Tools to convert them into structured fields.
6. (Optional) Create Product Groups if different product types need different field sets.

Quick examples:

• Camera store: Sensor Size, ISO Range, Video Resolution, Lens Mount
• Yarn shop: Fiber Content, Gauge, Needle Size, Weight Category
• Furniture shop: Material, Assembly Required, Weight Capacity, Dimensions

Start with a small set, then expand once you see what customers actually use.

1. Settings (Tabbed UI)

   Under WooCommerce → Settings → Products → Luma Product Fields, settings are grouped into tabs:

   • General: frontend title, optional built-in rows, and built-in tooltip controls
   • Style: row separators, layout mode (auto/grid), and label/value weight
   • Units: editable units and editable migration aliases
   • Tools: migration tool switch and quick link

   Built-in package weight and package size tooltip texts are editable in settings.

Block themes (FSE)

Luma Product Fields includes a dynamic Luma Product Fields block for single product templates in block themes.

The block uses the same rendering rules as the plugin and includes graceful fallback when no product context is available.

The plugin works on block themes (for example Twenty Twenty-Four). Taxonomy term archive pages for linkable fields are currently rendered with a compatibility template.

Most merchants will not need to configure anything extra for this.

SEO & structured data

Luma Product Fields is designed to be SEO-friendly:

• All values are stored as standard product metadata and rendered as regular HTML, so they are easily crawlable.

Why choose this plugin?

• 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.

• No-code setup for merchants
  You can create fields, assign values, and publish cleaner specs without custom development.

• 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.

• Future-proof schema
  Product Groups let you enforce consistent data structures across similar products.

Features

• Custom product specification fields
• Optional Product Group–based field schemas
• Inline editing with AJAX
• Drag-and-drop field ordering in the Product Fields overview screen
• Multi-value support (where relevant)
• Variation support (some field types only)
• Automatic frontend rendering
• Optional taxonomy-based fields with linkable values
• Frontend tooltips via field descriptions
• Backend-only fields for internal metadata
• Tabbed settings UI (General, Style, Units, Tools)
• Frontend table style/layout controls (plain/divider/striped, auto/grid, bold toggles)
• Built-in package weight/size tooltip settings with editable text
• Unit labels for numeric fields and compatible types
• Settings-based unit editor (add/remove unit slugs and labels)
• Legacy migration tool in settings (Tools tab)
• Editable unit aliases for migration matching
• Field editor improvements (radio type selection, initial values for new taxonomy fields, value persistence on validation errors)
• Frontend-hidden fields are visibly marked in admin product/variation fields and list views
• Template override support
• Fully extendable through actions & filters