Products Module

The Products module is the foundation of your Konfiwear customizer. Every garment your customers can configure starts here. This guide gives you a complete overview of what the Products module does, how it's structured, and how each section connects

What Is a Product?

A product in Konfiwear represents a single garment type that your customers can customize in the 3D customizer. Each product carries everything the customizer needs to render it: a 3D model, a thumbnail image, pricing tiers, available sizes, and the full customizer configuration (zones, allowed colors, pattern settings, and feature flags).

Products are scoped to your account — every product belongs to one account and is only visible to users with access to that account.

Key Concepts

Concept

What It Means

Product Code

A unique identifier within your account (lowercase, numbers, hyphens, underscores). Used internally for lookups and API references.

Source

Either custom (you created it from scratch) or library (you started from a Konfiwear library template).

Enabled / Disabled

Controls visibility. Disabled products are hidden from your customers but retain all configuration.

Display Order

Determines the sequence products appear in your catalog. Lower numbers appear first.

Product Data Structure

Every product contains four core data sections, each managed through its own card on the product detail page:

Section

What It Stores

Why It Matters

Assets

Thumbnail image, 3D model (GLB), ambient occlusion texture, base pattern image

Powers the visual experience — the 3D preview and customizer rendering

Pricing

Quantity-based pricing tiers with min/max ranges and per-unit price

Drives quote calculations and lets you offer volume discounts

Sizes

Available size codes (S, M, L, XL, 2XL, etc.) with optional per-size sewing pattern SVGs

Defines what your customers can order and feeds production output

Customizer Config

Zones, allowed colors, pattern toggles, feature flags

Controls exactly what customers can modify in the 3D customizer

💡 Tip: Each section can be edited independently — saving changes to pricing does not affect your assets or sizes configuration.

Navigating the Products Module

The Products List

Navigate to Products from your account sidebar. You'll see a table of all your products with the following capabilities:

Search by product name, code, or category
Filter by category or status (enabled/disabled)
Sort and paginate through your catalog
Click any row to open the product detail page

Caption: The Products list page with search, filters, and the product table.

The Product Detail Page

Click any product to open a two-column detail view:

Left column — Product info (name, code, description, status), asset uploads, and category assignment
Right column — 3D preview, pricing tiers, and size configuration

Every editable section has a pencil icon or action button. Changes are saved individually per card and take effect immediately.

Caption: The product detail page with editable cards organized in a two-column layout.

How Products Connect to Other Modules

Module

Relationship

Categories

Each product has a category field (e.g., hoodie, soccer-jersey) used for filtering and navigation

Designs

Designs define the zones and link groups that load when a customer selects a design for a product

Colors

The customizer config on each product can restrict which colors are available

Patterns

Pattern overlays are applied per-zone in the customizer; the product controls whether patterns are enabled

Quotes

When a customer submits a configuration, it creates a quote linked to the product

Billing

Your plan determines how many active products you can maintain

⚠️ Important: Disabling a product hides it from your customers but does not delete it. All configuration, assets, and pricing are preserved and can be re-enabled at any time.

3D Preview

If your product has a GLB model uploaded, the product detail page renders a live 3D preview that you can rotate and zoom. If no 3D model is present, the thumbnail image is shown instead. If neither exists, a placeholder icon appears.

Tips & Best Practices

Use consistent product codes — adopt a naming convention like jersey-soccer-v2 or hoodie-pullover-classic to keep your catalog organized as it grows
Upload a thumbnail first — even before the 3D model, a thumbnail gives your team a visual reference in the product list
Start with pricing — configure at least one pricing tier before enabling a product so your customers see accurate quotes
Use display order — set meaningful display order values to control the sequence customers see in your catalog