Luma Retail Solutions

Luma Product Fields

Structured, searchable, WooCommerce-native product specifications.

Luma Product Fields is a lightweight, WooCommerce-native way to add structured product specifications to your store.

Define your own specification schema, manage values efficiently in the product editor or via inline editing, and display specs automatically on the frontend — without introducing heavy general-purpose field frameworks.

It is designed for stores that rely on detailed, consistent product data.

What This Plugin Does

Luma Product Fields lets you define and display structured product specifications such as:

  • Dimensions
  • Material composition
  • Technical specifications
  • Sewing or knitting details
  • Difficulty levels
  • Packaging information
  • Color systems and codes
  • Brand metadata
  • Any structured product detail your catalog requires

These fields are not WooCommerce attributes. They do not affect variations, stock, or layered navigation. They are purpose-built for specification data.

How It Works

You can use a single global field schema for all products, or define different schemas using Product Groups.

1. Define Custom Fields

Create the specification fields your products need.

Supported field types include:

  • Text
  • Number (sortable, supports units)
  • Integer (sortable, supports units)
  • Range (Min–Max)
  • Single Select (taxonomy-backed)
  • Checkboxes (taxonomy-backed, multi-value)
  • Autocomplete (taxonomy-backed, supports new terms)

Each field supports:

  • Label and unique slug
  • Data type (text or numeric)
  • Variation support (meta-based field types)
  • Multi-value support (where relevant)
  • Optional unit label (cm, g, mm, kg, etc.)
  • Optional frontend tooltip description
  • Optional clickable term links (taxonomy-backed fields)
  • Backend-only mode (hidden on frontend)

You can also create purely internal fields (e.g., vendor SKU or internal notes).

2. (Optional) Use Product Groups

A Product Group defines which fields apply to which product types.

Examples:

  • Yarn
  • Fabric
  • Tools
  • Electronics
  • Books
  • Equipment

Key principles:

  • A product can belong to one Product Group.
  • A field can belong to multiple Product Groups.
  • Product Groups are not categories — they are a schema layer for the admin UI.

If you do not need multiple schemas, you can skip Product Groups entirely.

3. Edit Values Efficiently

Product Edit Screen

A dedicated panel inside the product editor:

  • Shows all relevant fields
  • Supports variation overrides
  • Displays unit labels inline
  • Shows helpful tooltips
  • Supports multi-value inputs

Inline Editor (Spreadsheet View)

Edit specifications quickly across many products:

  • One-click editing
  • Numeric sorting
  • Fast searching
  • No need to open each product

This significantly reduces product management time.

4. Automatic Frontend Display

Product specifications are automatically rendered in the Additional Information tab:

  • No theme editing required
  • Works with any WooCommerce theme
  • Variation values override product-level values
  • Only populated fields are shown
  • Unit labels render correctly
  • Taxonomy-based values can link to term archives
  • Backend-only fields remain hidden
  • Optional tooltips for extra clarity

For advanced setups, developers can override templates or hook into rendering logic.

Block Themes (FSE)

The plugin works with block themes (e.g., Twenty Twenty-Four).

Currently, taxonomy archives for linkable fields are rendered via a PHP template to ensure compatibility with block styling and template parts.

Full native block-template parity is planned in a future release.

SEO & Structured Data

All values are stored as standard WooCommerce product metadata and rendered as regular HTML.

This makes them:

  • Crawlable
  • Indexable
  • Compatible with SEO tools

Structured data integrations and schema mappings can be added via a future SEO extension.

Why Choose Luma Product Fields?

WooCommerce-Native Architecture

No external field frameworks. Clean, optimized product metadata.

Lightweight & Focused

Built specifically for product specifications — not general content.

Variation-Aware

Supports variation-level data where applicable.

Automatic Output

No shortcodes required.

Efficient Admin Workflow

Inline editing dramatically improves productivity.

Developer-Friendly

Fully class-based, namespaced, and hookable.
Register custom field types, override rendering, and integrate with external systems.

Future-Proof Schema Layer

Product Groups help enforce consistent data structures across product types.

Feature Overview

  • Custom product specification fields
  • Optional Product Group-based schemas
  • Inline editing with AJAX
  • Numeric and taxonomy-aware sorting
  • Multi-value support
  • Variation support
  • Automatic frontend rendering
  • Optional taxonomy-backed linkable values
  • Tooltip support
  • Backend-only internal fields
  • Unit labels
  • Template override support
  • Fully extendable through actions and filters

Who It’s For

  • Stores with detailed product catalogs
  • Technical, craft, fashion, or equipment retailers
  • Agencies building WooCommerce solutions
  • Businesses requiring structured, consistent product data
  • Stores that need something lighter and more focused than ACF

Roadmap & Extensions

The core plugin is designed to support future extensions, including:

  • SEO & structured data integration
  • Advanced filtering and faceted navigation
  • Export and feed integrations
  • ERP and automation integrations

The architecture is prepared for modular expansion.

Requirements

  • WordPress 6.0+
  • WooCommerce 8.0+
  • PHP 8.0+