Products → Product Categories uses the Grid 3×3 icon. The list table shows only Name, Level, Parent, Label template, and row actions; it does not display Leasable/Financeable or availability restrictions after save. Category and label-template writes are separate. Delete has no confirmation and does not clean category IDs from label-template settings in this component. The approved Harbor & Hearth route rendered a recovery error, so no screenshot is published.

Before you beginSearch first to avoid duplicate products or reference values. Confirm whether the change is business-wide or location-specific.

Step by step

  1. Go to Products → Product Categories, identified by the Grid 3×3 icon. Confirm the active business and wait for loading to finish. Categories are ordered by sort_order then name; locations, registers, and active product label templates are loaded for the editor.
  2. Treat the loaded table cautiously because the fetch function ignores query errors. An empty “No categories yet” table can appear after a failed categories query, while location/register/template option lists can also silently be empty. Confirm connectivity and another known catalog source before adding records to an unexpectedly empty page.
  3. Read each row’s indented Name, stored Level, resolved Parent name, and label-template name or Default. The table does not show category availability or Leasable/Financeable state, so open the exact row to verify those fields.
  4. Choose Add category to open `/catalog/categories/new`, or choose a row/pencil to open `/catalog/categories/<category ID>`. The editor is route-backed; closing it navigates to the category list.
  5. Enter a required trimmed Name. The page has no visible uniqueness check, description, image, color, slug, status, sort-order editor, search, filter, or drag-and-drop hierarchy control. Use a stable distinct name and verify downstream product/Sell labels.
  6. Choose None (top-level) or a Parent category. Parent choices exclude the current category and categories whose stored level is 3 or higher. Saving computes Level as parent.level + 1, or 1 with no parent, which supports at most three levels through the normal picker.
  7. Do not assume the picker prevents every cycle. When editing, it excludes only the current ID—not that category’s descendants. A level-one category can potentially be assigned beneath its own level-two descendant, producing a circular/inconsistent hierarchy. Map ancestors/descendants first and never select a child or descendant as parent.
  8. Set Leasable / Financeable only under approved financing policy. It defaults on for a new category and when an old row has no is_leasable value. The helper specifically references Katapult lease-to-own eligibility; it does not prove PayTomorrow eligibility, provider approval, customer qualification, or that every product/category consumer enforces it.
  9. Choose Product label template. Store default means this component removes the category ID from every loaded active product label template. Choosing a template means it adds the ID to that template and removes it from every other loaded active product template. This is category-to-template membership stored inside each template’s settings.categoryIds—not a label_template_id column on the category.
  10. Only active templates with template_source `product` appear. A template marked Default can also be selected explicitly and is labeled (Default); this differs from Store default, which selects no specific template association. Products in the category preselect the associated template during supported label printing; verify actual print selection/output.
  11. Use Availability restrictions when at least one location or register loaded. Available everywhere stores both available ID arrays as null. Only selected locations stores a normalized location-ID array and null registers; Only selected registers stores a normalized register-ID array and null locations.
  12. For a restricted scope, choose at least one location/register. Clear empties the draft and Save is blocked until an allowed target is selected or scope returns to Available everywhere. Switching scope clears the IDs from the other scope immediately in the draft.
  13. Register choices show register name and available location name; confirm both. A register restriction is more specific than a location restriction and does not automatically include other registers at that location. Category policy combines with product, register, location, tenant, and channel availability rules.
  14. Choose Add category or Save once. The category row write happens first. For a new category, sort_order becomes the current maximum plus one. For an edit, name, parent, computed level, leasable state, and availability arrays are updated.
  15. After the category row succeeds, CentriPOS concurrently updates every loaded active product label template whose category membership must change. These template updates are not one transaction and can partially succeed. If one fails, the category remains created/updated and the page reports that the label template did not update; the dialog remains open.
  16. After a template partial-failure warning, do not click Save repeatedly. Inspect the category row and every relevant template’s categoryIds because the category can temporarily belong to multiple templates or none. Reconcile with a controlled authorized fix and record before/after membership.
  17. On full success, wait for Category added or Category updated, then the dialog closes and all four lists refetch. Reopen the exact category to verify hidden Leasable and availability values; verify its row Name/Level/Parent/Label template and confirm one intended template association only.
  18. Assign the category on representative products, then test Sell at an allowed and disallowed location/register, POS/online availability as applicable, a Katapult-eligible test cart if authorized, and product-label template preselection/print. Do not use a real financing applicant merely to test the category flag.
  19. Use Trash only after mapping assigned products, direct child categories, deeper descendants, availability, financing behavior, labels/templates, saved carts, online store, reports, integrations, and network/master catalog. The button immediately sends a hard delete with no confirmation dialog.
  20. Deletion can fail due to database dependencies; the raw error is shown. On success it says Deleted, logs a category_deleted activity request, and refetches. This component does not remove the deleted category ID from label_templates.settings.categoryIds, so audit and clean stale membership through an authorized process. There is no restore control.
  21. No screenshot is published. The real Amelia Grant Harbor & Hearth `/catalog/categories` inspection rendered “This view needs a refresh”; the error-state capture was rejected rather than represented as a working list or replaced with another screen.

Screen and contract reference

Control or areaWhat it means
Grid 3×3 iconExact CentriPOS Products navigation icon for Product Categories.
NameRequired trimmed category name with no visible uniqueness check.
LevelStored/computed hierarchy depth shown in the table.
ParentOptional category with stored level below 3; descendants are not excluded automatically.
Three levelsNormal picker/computation supports levels 1–3.
Cycle riskEditor excludes self but not descendants; never parent a category beneath its child.
Leasable / FinanceableKatapult-oriented stored category flag, hidden from the list after save.
Store defaultNo specific active product-template category association.
Explicit templateCategory ID stored in one template settings.categoryIds and removed from others.
Default template labelAn explicitly selectable active template whose is_default flag is true; distinct from Store default.
Available everywhereBoth availability ID arrays stored null.
Only selected locationsNormalized allowed location IDs; requires at least one.
Only selected registersNormalized allowed register IDs; requires at least one.
ClearEmpties restricted IDs and blocks Save until a target or Everywhere is chosen.
Add / SaveCategory row write followed by concurrent label-template membership updates.
Partial template failureCategory persists while one or more separate template writes may have succeeded/failed.
Sort orderNew category receives current maximum sort_order + 1; no manual reorder UI.
Table boundaryShows Name, Level, Parent, and Label template only—not availability or leasable state.
TrashImmediate hard delete with no confirmation and no restore control.
Stale template category IDDelete does not clean label-template settings in this component.
Silent load errorsQueries ignore returned errors and can render empty option/list states.
No public screenshotRejected real Harbor & Hearth recovery-error capture; no substitute or fabrication.

Expected result

The category appears once in a noncircular level-1-to-3 hierarchy; hidden leasable and location/register availability values are reopened and verified; exactly the intended active product-label template contains its ID after the separate nontransactional writes; representative products behave correctly in Sell, financing, and label printing; and no stale template membership or dependency remains after an authorized deletion.

Troubleshooting

  • Confirm whether you are editing a product, variant, shared master record, or location-specific value.
  • Search for an existing product, SKU, UPC, attribute, or tag before creating a duplicate.
  • Preview labels, pricing, and availability in the intended location before broad publication.

More guides

Build an itemized payment in MoneyUse Products or Amount & description to build one receipt, attach the customer, and follow the appropriate payment or service-estimate workflow.
Take a one-time payment in Virtual TerminalReview a one-time amount, tax and contact at the correct payment station, use its verified secure checkout, and recover the original receipt after an uncertain result.
Review booking payments, refunds and earned careKeep a booking’s customer payments, unused advances, completed care, cancellation fees and refunds distinct, then read a correctly scoped accrual report.
Configure booking properties and customer pagesSet accommodations, service packages, availability, required intake and payment terms, then review the correctly branded booking page before sharing it.