Products → Products uses the Package icon. The page loads active and inactive products for the current tenant, then filters and sorts them in the browser. Search/filter values are shareable URL state, but selection and expanded rows are local state. Several controls mutate records immediately. Export always writes every loaded product—not only the filtered/selected rows—and includes supply price even when the screen hides costs. Import, Composites, and network Publish appear only for an enterprise/HQ tenant; network Publish is distinct from the selected-product Online Store actions.

Harbor & Hearth Products screen showing product search, catalog filters, import and export controls, and product cards in CentriPOS
Harbor & Hearth live CentriPOS demo
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 → Products, identified by the Package icon. Confirm the active CentriPOS business and read “<filtered> of <total> items in catalog.” The default Status is Active, so the first number can be smaller than the total even before you type a search.
  2. Wait for the product loader to finish. No products match your search appears when a nonblank search produces zero rows. No products yet can also mean the current filters produce zero rows, not necessarily that the tenant has no loaded products; choose Clear filters and All products before concluding the catalog is empty.
  3. Search product name, product SKU, barcode, variant name, variant SKU, variant supplier code, or variant attribute values. Every whitespace-separated token must occur somewhere in the combined lowercased product/variant text, but the tokens do not need to occur in the same field or variant.
  4. Use Brand, Category, Tag, Supplier, Type, and Status filters. Multiple selections within Brand/Category/Tag/Supplier use any-match logic; different filter groups all must pass. Supplier matching comes from supplier price-list entries, not only a product’s visible base vendor field.
  5. Type supports Standard, Variable, and Bundle (stored as composite). Status supports All products, Active, Inactive, POS enabled, POS disabled, Published online, and Not published. Not published means publish_status is anything other than exactly `published`, including hidden and missing values.
  6. Variant filters can arrive in the URL as repeated `variantAttribute` and `variant` values. Attribute filters require one variant to contain every selected attribute key. Value filters require one variant to match every selected attribute/value pair exactly after lowercase normalization. The visible chips can be cleared separately with Clear variant filters.
  7. Understand URL persistence. Search uses `q`; Brand, Category, Tag, Supplier, Type, Variant, and Variant Attribute can repeat; nondefault Status is stored. Opening/closing a product editor preserves these list parameters and attempts to restore the prior product/scroll position. A shared URL does not grant catalog permissions.
  8. Choose Clear filters to reset search, all catalog/variant filters, and Status to Active. The list is always sorted by product name A–Z using case-insensitive natural numeric order, then SKU; “Sorted A-Z” is informational and has no alternate list-sort control.
  9. Read a product card. It can show image, name, minimum enabled-variant retail price as From, permission-sensitive minimum enabled-variant vendor cost, displayed margin, stock, category names, Standard/Variable/Bundle type, SKU, Inactive, HQ source, variant count, and a franchisee-only recommended retail price.
  10. Cost and margin are hidden when the profile’s cost-visibility permission says to hide them. Do not treat an absent cost as zero. Export currently still includes supply_price and calculated margin for all loaded products regardless of this card-level hideCosts state, so only authorized users should export and the downloaded file must be protected.
  11. For a variable product, card Retail and Vendor Cost use the minimum positive retail/supply price among enabled variants when present; “From” indicates that rollup. The displayed margin combines those two minima even if they come from different variants. Inspect the expanded variant/product detail before pricing decisions.
  12. Stock follows the active app location ID when present; otherwise it sums location_stock across all returned locations. An untracked item shows ∞ Stock. A tracked quantity below 10 is styled as warning, but 10 is only this visual threshold—not a configured reorder rule. Choose the Stock link to open Live Inventory expanded to the product.
  13. Choose the row or chevron to expand the embedded Product Quick View. Cost-visible users can select Base cost or returned supplier price-list cost bases there; missing retail/base/selected cost, no price book, low margin below 35%, and 50%+ margin are diagnostic badges, not automatic price changes.
  14. Choose Edit to open `/catalog/products/<product ID>` while preserving list search. Add Product opens `/catalog/products/new`. Save/cancel behavior belongs to the product editor; returning to the list attempts to center the edited product or restore prior scroll. Verify the correct ID and persisted record.
  15. Treat Active/Inactive and POS badges as immediate row actions. Clicking Active toggles `is_active`; clicking POS toggles `sell_pos`; there is no confirmation and no success toast, only an error toast if the update fails. Reload and verify before assuming the catalog or register changed. Active and POS are independent.
  16. Select product checkboxes only for intentional bulk work. The header checkbox in the bulk bar selects or clears every product in the current filtered result—not every loaded product—based on whether selected count equals filtered count. Existing selections are not automatically cleared when filters change, so the selected count can include products no longer visible. Use Clear selection and rebuild it after any filter change.
  17. Under Actions → Categories or Tags, Add upserts the selected product relationships and Remove deletes them immediately with no confirmation. Empty option lists mean no categories/tags are available. Wait for Categories updated or Tags updated, then inspect representative selected products.
  18. Under Actions → Online Store, Publish online sets publish_status `published` and sell_online true. Unpublish (draft) sets `draft` and sell_online false. Set hidden sets `hidden` and sell_online false. These are immediate selected-product database updates with no confirmation; verify the storefront behavior and do not confuse them with network publication.
  19. Under Actions → Pricing, Enable or Disable custom price at sale immediately updates allow_custom_price for every selected ID. This changes whether authorized checkout users can enter a custom price; it does not set a price, create a discount, or limit by register. Test permissions and receipt/audit behavior with a controlled sale.
  20. Delete products opens a browser confirmation naming only the selected count. Confirming hard-deletes those product rows. The UI says denormalized sales and inventory history remains with a Deleted note, but there is no restore action. Audit variants, inventory, open/saved sales, online listings, bundles, supplier lists, labels, integrations, and historical reporting before deletion.
  21. Use Export → XLSX or CSV with care. The export ignores search, filters, and selectedIds and serializes every product in the loaded `products` array. It includes name, SKU, product type, brand, supply price, retail price, calculated margin, inventory/POS/online/active flags, barcode, description, categories, and tags; it omits variant rows, supplier price-list detail, stock quantities, and images.
  22. The XLSX/CSV export filename is `products-export` and the success message reports the total loaded product count. CSV is written through the workbook library from the same single Products sheet. Check row count and protect cost/barcode/description data before sharing.
  23. Import and Composites appear only for an enterprise/HQ tenant. Import receives a location map built from every tenant location name with spaces converted to underscores; duplicate normalized names can overwrite one another in that map. Preview and validate a backup/export, location columns, products, variants, warnings, and counts before any controlled import.
  24. Network Publish appears only for enterprise/HQ with child tenants. Choose one franchisee or All franchisees, then Publish. All runs one RPC sequentially per child and sums returned counts; a later failure does not roll back earlier franchisees. This is master-catalog synchronization, not online-store publishing. Audit each target and do not retry blindly after partial failure.
  25. A franchisee product with source_product_id shows HQ and can show HQ recommended retail. That badge does not prove every field is current, locked, or safe to overwrite; inspect Master Catalog/network synchronization rules before local edits.
  26. Use the real Amelia Grant Harbor & Hearth screenshot to orient to `/catalog/products` at 1440×900. It is the exact loaded Products list capture recorded in the approved manifest. No import, export, bulk mutation, product editor, network publish, deletion, customer, or transaction action was performed for the screenshot.

Screen and contract reference

Control or areaWhat it means
Package iconExact CentriPOS Products navigation/page identity.
Filtered of total countBrowser-filtered rows versus every loaded active/inactive product.
SearchAll whitespace tokens must appear somewhere in combined product and variant search text.
Brand / Category / Tag / SupplierAny-match within each group; all active groups must pass.
Supplier filterDerived from supplier price-list entries.
TypeStandard, Variable, or Bundle/composite.
StatusAll, Active, Inactive, POS enabled/disabled, Published online, or Not published.
Not publishedAny publish_status other than exactly published, including hidden/missing.
Variant AttributeRequires one variant containing every selected attribute key.
Variant valueRequires one variant matching every selected attribute/value pair.
URL stateq and repeated filter parameters persist through editor routing.
Sorted A-ZFixed name natural sort then SKU; no alternate list sort.
Vendor Cost / MarginPermission-hidden on cards but currently still included in export.
From price/costMinimum positive values among enabled variants; may not represent the same variant.
StockActive-location quantity when a location exists, otherwise all-location sum.
∞ StockInventory tracking is off.
Stock linkWorking Live Inventory link expanded to the product.
Expand rowEmbedded Product Quick View and cost/price-book diagnostics.
Edit / Add ProductRoute-backed product editor preserving list URL state.
Active badgeImmediate is_active toggle with no confirmation/success toast.
POS badgeImmediate sell_pos toggle with no confirmation/success toast.
SelectionLocal set that can retain hidden IDs after filters change.
Select allCurrent filtered rows only.
Categories / TagsImmediate bulk relationship add/remove.
Online Store bulk actionImmediate publish_status and sell_online update for selected IDs.
Custom price at saleImmediate allow_custom_price update for selected IDs.
Delete productsConfirmed hard delete with no restore control.
Export XLSX / CSVEvery loaded product, not filtered/selected rows; includes supply cost and no variant/stock detail.
Import / CompositesEnterprise/HQ-only catalog ingestion workflows.
Publish Products to NetworkEnterprise/HQ child-tenant RPC, sequential by child for All and nontransactional across targets.
HQ badge / recommended retailProduct linked to a source master; not complete synchronization proof.
Harbor & Hearth screenshotReal approved loaded `/catalog/products` capture with no mutation or sensitive workflow opened.

Expected result

The intended product is identified by product/variant evidence and the active URL filters; displayed price/cost/stock scope is understood, selected IDs are rebuilt after filter changes, each immediate row/bulk mutation is verified on the exact products, exports are treated as all-loaded-product cost-bearing files rather than filtered downloads, and any HQ network publication is audited target by target for partial completion.

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.