Skip to content

Store Categories Page

Menu Location: Products > Online Store > Store


Overview

The Store page (store-cats.php) is where you organize the categories customers browse in your online store. Categories control the navigation tree shown on the shopfront and which products appear under each heading. A category can get its products in three different ways, and often uses a mix of them: automatically from a linked product classification, automatically from a "special flag" applied to products, or manually by picking individual products.

Primary Functions:

  • Create and organize store categories
  • Nest categories as parent/child (unlimited depth via the drag-and-drop Sort tool)
  • Set category status (Active/Inactive)
  • Add a category image and banner image
  • Write a category description
  • Set the category's URL
  • Link products into a category (automatically or manually)

Page Layout

Category List (left column)

A list of all top-level categories with their sub-categories indented underneath. Each row shows:

  • Category name (links to that category's edit panel)
  • A colored dot: green if Active, pale/red if Inactive
  • An "add new main category" button
  • A "set display order" link that opens the drag-and-drop Sort page

Category Edit Panel (middle column)

Appears when you click a category from the list:

  • Name
  • Parent (dropdown)
  • Include All From Classification / Include All From Secondary Classification
  • Description
  • An "Advanced" collapsible section (Special Flag, Show/Hide Graphics, sub-categories list, Delete Category)

Right-hand panels

When a category is selected, three more panel appear on the right:

  • Status - Active/Inactive dropdown, plus the "Always show" pin button
  • Category Image and Banner Image - upload/replace/remove
  • URL - the category's slug, editable
  • Products Linked to [category] - list of directly-linked products with an "Add or Edit Product Links" button and a "Remove All Product Links" button

Managing Categories

Creating a New Category

Steps (new top-level category):

  1. Click "add new main category" at the bottom of the category list
  2. Enter category Name
  3. Choose Status (Visible or Hidden)
  4. Click "Create New"

This also creates a matching top-level product classification with the same name if one doesn't already exist, so the category has something to attach products to.

Steps (new sub-category):

  1. Open the parent category, click "Add a new sub-category"
  2. Either pick an existing category from "Choose Existing Category" to nest it under this one, or fill in Name + Status under "Add New Category"
  3. Submit

Parent selection, description, image, and URL are set afterward by editing the new category, not at creation time.

Category Name

Edit the Name field on the category's edit panel and click Save & Update.

Category Description

The Description field (optional) is shown on the category's storefront page, unless "Show or Hide Category Image/Banner/Description" is set to Hide (see Advanced Settings below).


Category Hierarchy

Parent and Child Categories

Any category can be nested under another using the Parent dropdown on its edit panel (field name prod_parent), or by dragging it into another category on the Sort page. There is no fixed limit on nesting depth in the drag-and-drop Sort tool, though most stores keep things to a couple of levels for a clean menu.

Creating Subcategories

Steps:

  1. Open the parent category
  2. Click "Add a new sub-category"
  3. Fill in Name + Status, or link in an existing category
  4. Save

Moving Categories

Changing Parent:

  1. Open the category
  2. Change the Parent dropdown
  3. Click Save & Update

Promote to Top Level:

  1. Open the category
  2. Select "Top Level" in the Parent dropdown
  3. Save

You can also drag a category onto another one on the Sort page to re-nest it (see Display Order below).


Display Order

Category order is controlled from a separate page: click "set display order" on the Store page (store-cats-sort.php).

Drag and Drop:

  1. Drag a category by its handle icon
  2. Drop in the top quarter of another item to insert above it, the bottom quarter to insert below it, or the middle half to nest it inside as a child
  3. Changes save automatically, no separate "save" step

There is no manual numeric "display order" field exposed anywhere in the admin UI, ordering is set entirely by drag-and-drop.


Category Images

Adding Category Images

Steps:

  1. Open the category
  2. Use the Category Image or Banner Image uploader on the right
  3. Crop as prompted (the image picker enforces a 1:1 ratio for the category image and roughly 893:200 for the banner)
  4. To remove an existing image, click the small red X button next to it

Image Use Cases

Where category images/banners actually appear is controlled by your store's theme; the admin page itself only handles the upload/remove for the two image slots (Category Image, Banner Image).


Visibility Settings

Category Status

Active: category is visible in the store and reachable by customers.

Inactive: hidden from customers.

There are no separate "show in main menu" / "show in footer menu" toggles, Active/Inactive is the only visibility switch on this page.

Show or Hide Graphics

The Advanced section has a "Show or Hide Category Image/Banner/Description" setting. Setting it to Hide removes the image, banner, and description from the category's storefront page, showing only the products and sub-categories.

Automatic Product-Count Hiding

The storefront shows a product count next to each category name and automatically hides categories with zero products from customers (this count is recalculated roughly every 10 minutes, or immediately via the "Click here to update now" link that appears on this page after a change). There is no manual show/hide-count setting to configure.

Always Show (Pin)

The Status panel has an "Always show" pin button (thumbtack icon), directly under the status dropdown. It reads Pinned (green) or Not pinned.

Pinning a category keeps it in the shop even when it currently has no products. This matters for your core categories (for example Fruit and Vegetables): the count is based on the current week's menu, so while you are rebuilding the weekly menu a category can briefly count zero and disappear from the shop, then come back once the menu is filled in. Pinned categories never drop out.

  • Click the button once to pin, click again to unpin. It saves immediately, no page reload.
  • Pin only the handful of main categories customers always expect to see. Everything else should keep the normal rule, so customers never land on an empty section.
  • A pinned category still shows its normal products whenever it has some.

URL

The category's URL slug is shown and editable in the URL panel (click EDIT, type the new slug, Save URL). Only letters, numbers, and dashes are allowed. A new category's slug is auto-generated from its name.


Advanced Settings

Click "Advanced" on a category's edit panel to reveal:

Special Flag (sale, featured, etc): pick a flag from shop_flags; any product tagged with that flag is automatically part of this category.

Show or Hide Category Image/Banner/Description: see above.

Sub Categories Linked Under [category]: a read-only list of this category's direct children, plus an "Add a new sub-category" link.

Delete Category: permanently removes this category from the store. There's no undo, and you're asked to confirm. The built-in "Checkout Upsells" system category cannot be deleted.

Include All From Classification

On the main edit panel (not inside Advanced), two dropdowns let a category automatically pull in products:

  • Include All From Classification - every product under the chosen top-level product classification becomes part of this category automatically
  • Include All From Secondary Classification - same idea, from a second classification

Lightspeed Sync

If your store syncs with Lightspeed, an extra panel lets you check "Do NOT sync this category from Lightspeed". Turning this on unlinks every product currently in the category from Lightspeed (their Kiva prices/stock/listings are untouched) and stops new Lightspeed products from landing in this category. Unchecking it resumes syncing for new products going forward; already-unlinked products stay unlinked until they come through from Lightspeed again.


Managing Products in Categories

There are three ways products end up in a category:

  1. Include All From Classification / Secondary Classification (see above) - automatic, based on the product's classification.
  2. Special Flag (see Advanced Settings) - automatic, based on a flag applied to the product.
  3. Manual linking - either from the category side or the product side:
  4. From the category: click "Add or Edit Product Links..." in the "Products Linked to [category]" panel. This opens a checklist of products (filterable by show all/active/inactive/current week, and a text filter box); check or uncheck products, then "Add Products To Category".
  5. From the product: on the product's edit page, the "Alternate Store Categories" panel lists every category as a checkbox ("List this product outside of its main category"); check the ones you want and "Save Store Cats".

Removing Products

Click "Remove All Product Links" in the "Products Linked to [category]" panel to clear every manually-linked product from that category at once (this does not touch products included automatically via classification or special flag).

Viewing Category Products

The "Products Linked to [category]" panel lists each directly-linked product's name and an active/inactive badge, with a link to open that product for editing.


Common Use Cases

Use Case 1: Create Basic Category Structure

Goal: Set up organized store navigation

Steps:

  1. Click "add new main category" and create top-level categories such as "Vegetables", "Fruits", "Meat & Poultry", "Dairy & Eggs", "Pantry Items"
  2. Open each and add a description
  3. Upload a category image for each
  4. Set the order you want on the Sort page
  5. Make sure each is set to Active

Result: An organized store navigation tree.

Use Case 2: Add Seasonal Category

Goal: Highlight seasonal products temporarily

Steps:

  1. Create category "Summer Harvest"
  2. Add a description and image
  3. Drag it to the top position on the Sort page
  4. Link in summer products (via Add/Edit Product Links, Include All From Classification, or a Special Flag)
  5. After the season, set Status to Inactive

Result: Seasonal products prominently featured, easily hidden when season ends.

Use Case 3: Organize with Subcategories

Goal: Create detailed vegetable organization

Steps:

  1. Create parent category "Vegetables"
  2. Add sub-categories under it: "Leafy Greens", "Root Vegetables", "Squash & Gourds", "Tomatoes & Peppers"
  3. Link products into each sub-category
  4. Leave "Vegetables" Active; sub-categories appear nested under it automatically

Result: Detailed organization without cluttering the top level.

Use Case 4: Hide a Category Without Deleting It

Goal: Stop showing a category to customers while keeping its product links intact

Steps:

  1. Open the category
  2. Set Status to Inactive
  3. Save

Result: Category and its links stay in the system but customers no longer see it. (There is no separate "internal only, still browsable" state, Inactive hides it completely.)

Use Case 5: Reorganize Category Order

Goal: Move a category to the top

Steps:

  1. Click "set display order" to open the Sort page
  2. Drag the category to the top of the list (drop in the top quarter of the item above it)
  3. Order saves automatically

Result: The category now appears first.


Troubleshooting

Category Not Appearing to Customers

Check:

  1. Status is Active, not Inactive
  2. The category has at least one product linked (via classification, special flag, or manual link); categories with a product count of zero are automatically hidden from customers
  3. The product count is recalculated roughly every 10 minutes, use the "Click here to update now" link on this page to force it sooner
  4. Clear your browser cache and refresh

Products Not Showing in Category

Check:

  1. If relying on Include All From Classification/Secondary Classification, confirm the product is actually filed under that classification
  2. If relying on a Special Flag, confirm the flag is applied to the product
  3. If manually linked, open "Add or Edit Product Links..." and confirm the product's checkbox is checked
  4. Check the product's own active/permanent/current-week status on the product edit page

Cannot Drag to Reorder Categories

Check:

  1. You're on the Sort page (store-cats-sort.php), not the main Store page
  2. You're dragging from the handle icon
  3. Try a different browser or check for JavaScript errors in the console
  4. Disable browser extensions that might interfere

Subcategory Not Nesting Correctly

Check:

  1. Open the sub-category and confirm the correct Parent is selected in the dropdown
  2. Save, then refresh the category list
  3. On the Sort page, make sure you dropped it in the middle (nest) zone of the target category, not the top/bottom (reorder) zones

  • Products (product_classifications_active.php) - the master product list; a product's classification drives automatic category membership
  • Sort (store-cats-sort.php) - drag-and-drop category ordering and nesting, reached via "set display order" on this page
  • Add/Edit Product - each product's "Alternate Store Categories" panel links it into extra categories beyond its main classification

Best Practices

Category Organization

  1. Keep nesting shallow enough to stay easy to navigate, most stores use 1-2 levels
  2. Limit top-level categories so the storefront menu stays scannable
  3. Use sub-categories to organize without cluttering the top level
  4. Name categories from the customer's perspective

Naming Conventions

  1. Be consistent with naming style
  2. Avoid overly clever names, clarity wins
  3. Keep names brief but descriptive

Visual Presentation

  1. Use consistent, high-quality category and banner images
  2. Update seasonal category images regularly
  3. Crop images to the ratios the picker requests (1:1 for the category image, roughly 893:200 for the banner)

Maintenance

  1. Deactivate categories that are no longer relevant instead of deleting them, so you keep the option to reuse them
  2. Use "Remove All Product Links" to clear out a category before repurposing it
  3. Review the "Products Linked to" panel periodically to make sure the right products are attached

Quick Reference Card

Task Action/Location
Create new top-level category "add new main category" button
Create sub-category Open parent > "Add a new sub-category"
Edit a category Click its name in the category list
Set category status Right-hand Status panel
Keep a category visible even when empty Right-hand Status panel > "Always show" pin button
Upload category/banner image Right-hand image panels
Edit category URL Right-hand URL panel > EDIT
Reorder or re-nest categories "set display order" link > drag and drop
Change a category's parent Edit panel > Parent dropdown, or drag on Sort page
Auto-fill from a classification Edit panel > Include All From Classification
Auto-fill from a special flag Advanced > Special Flag
Manually link/unlink products "Add or Edit Product Links..." button
Remove all linked products "Remove All Product Links" button
Delete a category Advanced > Delete the category

FAQs

Can a product be in multiple categories?

Yes. Its main classification can drive one category automatically, and the product's own "Alternate Store Categories" panel (or a category's "Add or Edit Product Links") can link it into others.

What happens to products if I delete a category?

Deleting a category removes its own placement in the store, it does not delete the products or the product classification. Products linked to it through Include All From Classification, a Special Flag, or the product's own Alternate Store Categories checkboxes are unaffected records-wise, but they'll no longer show up under a category that no longer exists.

How deep can I nest sub-categories?

The drag-and-drop Sort tool doesn't enforce a hard limit, but keep it shallow, deep hierarchies make store navigation harder to use.

Why isn't my category showing to customers?

Check that Status is Active and that it has at least one linked product (the storefront hides categories with a product count of zero, which recalculates roughly every 10 minutes). If it's a core category that should always be visible, pin it with the "Always show" button in the Status panel.

What's the difference between Inactive and deleting?

Inactive hides the category from customers while keeping it and its product links in the system so you can reactivate it later. Deleting removes the category's placement permanently.

How do I merge two categories?

There's no merge tool. Re-link the products from one category into the other (via Add/Edit Product Links, Include All From Classification, or Alternate Store Categories), then delete the now-empty category.


Recent Updates

October 2026 - Added the "Always show" (pin) button to the Status panel. Pinning a category keeps it in the shop even when it has no products that week, useful for core categories like Fruit and Vegetables that can briefly count zero while the weekly menu is being rebuilt.


End of Documentation

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