Product Attributes¶

Menu Location: Products > Settings > Product Attributes (beta!)

Last Updated: 2026-07-27

Overview¶

Product Attributes lets you define a named list of values that can be attached to a product as a customer-facing option (think "Color: Blue/Green/Red" or a free-text personalization field). This page is where you create the attribute name and its list of values.

This page is marked (beta!) in the menu, and that label is accurate: the tool for linking a defined attribute to a specific product is not currently available in the product editor. In practice this page today lets you build and maintain attribute/value lists, but there is no working screen to attach them to a product or show them in your store. Treat it as attribute-list housekeeping rather than a live storefront feature until Kiva Logic wires up product assignment.

Page Layout¶

Header Section¶

Add New button - opens a blank form to create a new attribute
Search box - standard search across the attribute list

Main Content Area¶

Table of all product attributes with columns:

Attr Name - the attribute's name (max 32 characters)
Attr Type - a numeric code (see "Attr Type Field" below); no friendly label is shown here
Edit / Delete - standard record actions

There is no "Product Count" or "Visible to Customers" column on this page.

Attr Type Field¶

Each attribute has an Attr Type number. There is no dropdown for this on the current form, so you have to know the number to enter:

Value	Meaning
`1`	Attribute uses a dropdown of the Values you define below
`2`	Attribute is a free-text input (no predefined values)
`3`	Attribute is a free-text input with price add-ons (used for letter/number personalization-type products)

Creating a Product Attribute¶

Steps:

Click "Add New"
Enter Attr Name (up to 32 characters)
Enter Attr Type (1, 2, or 3 - see table above)
Save
Re-open the new attribute to add Values (see below) - the Values panel only appears once the attribute already exists

Editing a Product Attribute and Its Values¶

Opening an existing attribute for edit shows two things:

The standard Attr Name / Attr Type fields
A separate "Values for the Product Attribute" box listing up to 20 text fields, one per value (e.g., for a "Color" attribute you'd type "Blue", "Green", "Red" into separate boxes)

How saving Values works (Save Product Attribute Options button):

Type a value into an empty box to add it
Change the text in an existing box to rename that value
Clear a box and save to delete that value
Values are listed sorted numerically-then-alphabetically by their text

Deleting a Product Attribute¶

Clicking Delete on an attribute shows the standard confirmation prompt and removes the attribute record immediately. There is no product-count warning, no cascading cleanup of that attribute's Values, and the deletion cannot be undone.

Attributes vs. Tags¶

Product Tags (admin-edit.php?table=product_tags) is a separate, simpler feature: a free-form tag name plus a Featured Filter yes/no flag that controls whether the tag shows in the shop sidebar filter when Featured Filter mode is enabled in Settings. Tags are live on the storefront today.

Product Attributes, by contrast, are meant for a predefined name + value list (like a real dropdown), but as noted above, nothing currently connects an attribute to a product or to the storefront.

Troubleshooting¶

Duplicate or messy Values¶

If a Values list ends up with near-duplicate entries (e.g., "USA" and "U.S.A."), edit the attribute and directly retype the value box to the value you want to keep, then clear any duplicate box and save.

Deleted a Value by mistake¶

There is no undo. Re-open the attribute and retype the value into an empty box, then save.

Nothing shows up for customers¶

This is expected today - the page does not yet include a way to attach an attribute to a product, so defining attributes and values here has no visible effect in your store.

Products (product_classifications_active.php) - the product list/editor (attribute assignment is not available here yet)
Product Tags (admin-edit.php?table=product_tags) - free-form, live storefront tags
Product Classifications (product_classifications.php) - product category hierarchy
Store Categories (store-cats.php) - online store organization

Best Practices¶

Use consistent naming for both the attribute name and its values (e.g., "Gluten-Free" not "GlutenFree")
Keep values concise and avoid near-duplicates ("USA" vs "U.S.A.")
Note your Attr Type choice somewhere (1/2/3) since the form itself doesn't label the numbers

Quick Reference Card¶

Task	Action/Location
Create new attribute	Click "Add New" > enter Attr Name + Attr Type > Save
Add/edit/remove values	Edit the attribute > type into the Values boxes > "Save Product Attribute Options"
Delete an attribute	Click delete > confirm
Attach an attribute to a product	Not currently available

FAQs¶

What's the difference between attributes and tags?¶

Product Tags are free-form labels shown in the shop sidebar (with a "Featured Filter" toggle) and are live today. Product Attributes are a beta feature for defining a name + value list; there is currently no way to attach that list to a product.

What do the Attr Type numbers mean?¶

1 = dropdown of your defined Values, 2 = free-text input, 3 = free-text input with price add-ons for letter/number-style personalization products.

Can I change an attribute's type after creating it?¶

Yes, the Attr Type field is editable like any other field on the form - there's no built-in warning about data loss, so double-check before changing it.

Can I delete an attribute?¶

Yes, delete is immediate with a standard confirmation prompt. It does not warn you about, or clean up, any Values under that attribute.

Change Log¶

2026-07-27¶

Rewritten against actual source (kiv/admin-edit.php case product_attr, kiv/database_schema/product_attr.sql, product_attr_opt.sql) after the previous version described fields and workflows (Visible to Customers, Required, Display Order, product-to-attribute assignment, store filtering, permissions tiers) that do not exist in the code
Documented the real Attr Type numeric codes and the real Values-editing mechanism
Noted that product-to-attribute assignment is not currently available, matching the page's "(beta!)" label

2026-03-01¶

Initial documentation created

End of Documentation

For additional help, contact your system administrator or Kiva Logic support.