Pyle

Product Categories ​

What This Is ​

Product Categories organize your catalog into browseable sections. They help shoppers navigate the storefront and help your team keep products grouped in a way that makes sense.

Categories can also carry content and filtering behavior, not just labels.

When You Would Use It ​

Use Product Categories when you need to:

  • create storefront navigation structure
  • group similar products together
  • support category-based browsing and filtering
  • add category-specific content or images

Do not use categories when you really need a brand, product type, or collection. Categories are usually about browse structure, not every kind of product rule.

Before You Start ​

Before you create or edit a category, make sure:

  • you can access Settings > Categories in the admin
  • you know whether the category should have a parent category
  • you have the category name and image ready
  • you understand whether the category should expose product filters

How To Use It In The Admin ​

  1. Open Settings > Categories.
  2. Create a new category or edit an existing one.
  3. Set the main fields:
    • parent category if needed
    • category name
    • description
    • image
  4. In the edit flow, refine the storefront-facing fields:
    • slug
    • meta title
    • meta description
    • long-form content
  5. If the category should help shoppers filter products, add the attributes you want to expose and set their filter order and featured behavior.
  6. Save the category.

What It Changes In The Storefront ​

Categories are first-class storefront pages.

They affect:

  • category landing pages
  • storefront navigation
  • category-based browse flows
  • attribute filters shown to shoppers for that category

Changes to category names, images, content, or filters can directly change how shoppers discover products.

Common Tasks ​

Create a top-level category ​

Use this when you want a new main browse section for the storefront.

Create a child category ​

Use the parent category field when you want a nested category structure.

Add category filters ​

Use the attribute picker in the edit flow to choose which filters shoppers should see.

Update storefront content ​

Use the edit flow to update the category image, content, slug, and meta fields.

Update categories in bulk ​

Use Excel import/export when you need to review or update many categories and category relationships at once.

Rules, Limits, And Things To Watch ​

  • You cannot safely remove a category that still has products or child categories attached to it.
  • Category filters affect shopper browsing, so test filter changes carefully.
  • Categories can be part of both admin organization and shopper-facing navigation, so naming changes have broad impact.
  • Bulk category changes can also come from Excel or ERP-connected workflows, so teams should be clear about which source is authoritative.
  • Some homepage category presentation can come from storefront menu configuration instead of the category record alone.

Troubleshooting ​

I cannot delete a category ​

It is likely still attached to products or child categories.

I changed a category, but the storefront still feels wrong ​

Check both the category content and the assigned products. A category page can be correct while the product assignments are still incomplete.

Also check whether the storefront area you are testing is menu-config-driven rather than driven directly from the category record.

I do not see the filters I expected ​

Open the category edit flow and confirm the right attributes were added as filters.

Sources ​

  • packages/admin/src/Livewire/Admin/Settings/Categories/DataTable/CreateDialog.php
  • packages/admin/src/Livewire/Admin/Settings/Categories/DataTable/EditDialog.php
  • packages/admin/src/Livewire/Admin/Tools/Excel/ExportDialog/ProductExport.php
  • packages/framework/src/Actions/Import/Product/Sheets/ImportProductCategoryRows.php
  • packages/storefront/src/Livewire/Storefront/Home/Page.php
  • packages/storefront/src/Livewire/Storefront/Category/Page.php
  • packages/storefront/src/View/Components/Navigation/Bar.php
  • packages/framework/src/Http/Resources/Storefront/ProductCategoryResource.php