Categories

---

Before You Begin

Make sure you have:

• An active Konfiwear account with admin or owner access

• A plan for your category hierarchy (recommended: 2–3 levels deep)

• Optional: thumbnail images for your top-level categories (PNG, JPEG, or WebP)

⚠️ Important: Categories in the Assets module create the customizer's navigation tree. They are separate from the category text field on individual products, which is a flat tag used for filtering in the admin product list.

---

Setup Instructions

1. Navigate to Categories

Go to Assets → Categories from the sidebar, then click the Categories tab. The page opens with either a list view (expandable tree) or a grid view (drill-down cards).

Caption: The Categories page showing the tree view with root and nested categories.

2. Create your root categories

Click Add Category. Fill in the details:

Click Save. Repeat for each root category.

3. Add child categories

For each root category, add children to build the second level:

• From the list view — Click the + icon on a root row, or select Add Child from the dropdown menu

• From the grid view — Click Add Child on the card footer

The dialog opens with the parent pre-selected. Enter the name, optional image, and save.

Caption: A two-level category tree with Sport as root, Football as level 1, and Jerseys/Shorts as level 2.

4. Reorder categories

Use Move Up and Move Down from each row or card's action menu to arrange siblings in the display order you want. Reordering only affects siblings at the same level.

💡 Tip: Place your most popular categories first. If Football accounts for 60% of your orders, put it above Basketball and Running.

5. Upload category images

Images are optional but recommended for root categories. They appear in the grid view and give customers a visual anchor when browsing.

1. Create or edit a category

2. Use the image upload area in the dialog

3. Select a square or 4:3 ratio image

4. The image uploads to cloud storage and is saved to the category

---

Verify It Works

1. Confirm your categories appear in the correct hierarchy on the Categories page

2. Open the customizer at /c/your-slug and verify the category navigation displays correctly

3. Click through the tree to ensure all levels are visible and drill-down works

✅ Done! Your category tree is set up. Customers navigating your customizer will see this hierarchy when browsing products.

---

Managing Categories

⚠️ Important: Hiding a parent category automatically hides all its descendants. Showing a parent restores the entire branch. Use this for seasonal collections or categories under development.

---

Recommended Hierarchy Structure

Why two to three levels? Deeper trees add clicks without adding clarity. Most customers know the sport and garment type — two levels gets them there. A third level is useful only if you have many variations within a garment type.

---

Troubleshooting

Categories don't appear in the customizer Check that the categories are enabled and that your customizer is active for the account. Also verify that products are assigned to these categories.

Child categories aren't visible Expand the parent in the list view, or click into the parent in the grid view. Also check that the parent's enabled status is on — disabled parents hide all children.

Images don't display Verify the upload completed in the edit dialog. Supported formats are PNG, JPEG, and WebP. The image must be publicly accessible.

💡 Tip: If you're still experiencing issues, contact our support team at support@konfiwear.com or use the live chat in your dashboard.

---

Next Steps

Now that your categories are set up:

• → Understanding the Assets Module — Learn about the other asset types (colors, fonts, positions, sizes)

• → Product Setup Guide — Assign categories to your products

• → Managing Colors in Konfiwear — Configure the color swatches your customers see per zone