Documentation Catalog, products & swatches

06 / Merchandise

Catalog, products & swatches

Build a native WooCommerce catalog that works with Purlia product cards and filters.

For Purlia 1.0.14 min readUpdated 4 Nov 2026

Organize your collection

Create product categories for your actual merchandise. The sample store uses Yarn, Knitting & Crochet Kits, Needles & Hooks and Patterns. Update header and homepage category links if your category names or slugs differ. Set useful product names, descriptions and images before featuring products on a homepage.

Create the global attributes

Display nameSlugUsed by Purlia
ColorcolorColor swatches, variation choices and the Color filter
FiberfiberFiber specifications and the Fiber filter
Yarn weightyarn-weightProduct specifications and the Yarn weight filter
  1. Open Products → Attributes and create the global attributes you need.
  2. Choose Configure terms for an attribute and add your values, such as Mulberry, Sage or DK.
  3. For Color terms, set their Swatch color using the theme’s color field and save.
  4. Assign these global attributes to products. A per-product text attribute with the same name is not a substitute for the global Color taxonomy when you want its swatches/filter.
Global product attributes table showing Color, Fiber and Yarn weight
Products → Attributes: the global attribute names and slugs used by Purlia. Choose Configure terms to manage their values. Select the image to view it at full size.
Color term editor with the Mulberry swatch color set to hexadecimal 742d45
Edit a Color term and set its Swatch color. Mulberry is an illustrative demo value; use the actual shades you sell. Select the image to view it at full size.

Add a simple product

For a tool or kit without choices, create a Simple product. Fill in its name, price, category, description, short description, image and gallery. Configure stock and shipping data for the actual item, then publish and inspect the product page. Keep sample inventory separate from stock you sell.

Add a yarn with color variations

  1. Create a product and choose Variable product.
  2. Assign its global Color values and mark Color as used for variations. Save the attributes.
  3. Create the variations you intend to sell. Each needs a price and an available stock status. Add a variation image if its color should show a different photograph.
  4. Set a default color if you want the product to open with a choice selected. Publish, then select another color on the frontend and check the purchase button.
  5. Test two quantities and an unavailable variation on staging before selling.

Further reading: WooCommerce variable products.

Variable product Attributes panel showing Color values and Used for variations checked
Product data → Attributes: assign global Color values and enable Used for variations before creating the variations. Select the image to view it at full size.
Expanded Mulberry variation showing SKU, stock management, regular price and stock quantity
Product data → Variations: expand one variation to set its price, inventory and image. The price and stock shown are demo data. Select the image to view it at full size.

Show product specifications

Purlia’s specification area reads the product’s attributes. Missing values are omitted; you do not need to fill every field.

AttributeExample content
Fiber / Yarn weightMerino wool / DK
Skein size100g
Length220m / 240yd
Needles4–4.5mm / US 6–7
Gauge22 sts × 30 rows / 10cm

Use your real supplier specifications. Purlia demo measurements are sample content. Keep short descriptions useful for customers rather than repeating every technical attribute.

Edit the catalog and filters

Edit the Product Catalog template in the Site Editor for the Shop layout. Its sidebar uses native WooCommerce filter blocks, not a classic Widgets sidebar. The price, attribute and availability controls read the catalog’s actual data. Keep their product-filter structure intact when restyling.

  • If a filter has no choices, assign the corresponding global attribute values to published products.
  • A zero-price preview product can extend the catalog’s price range down to zero.
  • The result count and sort control use native WooCommerce behavior.
  • Test filters on mobile: open Filter products, make a selection, Apply and confirm the result count.

Reviews and pagination

Manage product reviews with WooCommerce’s review settings and WordPress comment moderation. The review list and its page navigation inherit Purlia styling. WordPress Discussion settings affect paginated comments; test the product after changing pagination. Do not import sample demo reviews as genuine customer feedback.

WordPress Discussion settings showing threaded comments and three comments per page
Settings → Discussion: comment pagination controls. Three comments per page is a demo setting, not a requirement for your store. Select the image to view it at full size.
Your store guide