How to Troubleshoot Why a Product Is Missing From the Storefront

What This Task Does

This task helps you figure out why a product that exists in the admin does not appear where shoppers expect it to appear in the storefront.

Use it when a product is missing from search results, browse pages, or the product page itself and you want to check the most likely catalog, activation, and shopper-visibility causes first.

Before You Start

Make sure:

• you can access the Products area in the admin
• you know the product name or SKU
• you know which storefront view is missing the product, such as search, category browsing, or direct product-page access
• you know the shopper context that matters, such as province, stock availability, or customer-specific restrictions

If the product was edited recently, remember that storefront search can update asynchronously after model changes.

Steps

1. Open the product in the admin Products area.
2. Confirm the product is active.
3. Check whether the product is discontinued or otherwise marked in a way that would keep shoppers from seeing it as available.
4. Confirm the core catalog fields are set correctly:
   • SKU
   • product name
   • brand
   • product type
   • primary category
5. Check whether the product has the storefront-facing content it needs, such as images, pricing inputs, inventory-related data, and any related records your storefront depends on.
6. Open the storefront search page and search by the product name or SKU.
7. If the product still does not appear, compare the shopper context:
   • province or shipping location
   • stock availability
   • customer-specific restrictions
8. If the product should appear in category, brand, or collection browsing, verify that the shopper is using the right browse path and that the product belongs in that path.
9. If the product was changed recently, wait for the search index to catch up before assuming the storefront state is wrong.

What Happens Next

If the product was missing because of activation, classification, stock, or shopper-context settings, fixing those values should make it visible in the storefront once the related search and browse views refresh.

If the product was changed recently, the storefront may need time to reflect the update because search results are built from indexed data, not from a direct live read of the admin form.

Common Mistakes

• checking only the storefront and not the admin product record
• forgetting that inactive or discontinued products will not behave like active catalog items
• assuming the product page alone controls storefront visibility
• overlooking province-based availability, pricing, or stock filters
• overlooking customer-specific restrictions
• expecting a just-updated product to appear immediately before the search index refreshes

Related Guides

• Catalog & Merchandising
• Products
• Search
• How to create and publish a product
• How to classify a product with type, category, brand, and collection

Sources

• packages/admin/src/Livewire/Admin/Products/CreateProductDialog.php
• packages/admin/src/Livewire/Admin/Products/DataTable.php
• packages/admin/src/Livewire/Admin/Product/Page.php
• packages/framework/src/Models/Product.php
• packages/framework/src/Actions/FastSearch/SearchProducts.php
• packages/storefront/src/Livewire/Storefront/Search/Page.php
• packages/storefront/src/Livewire/Storefront/FastSearch/Wrapper.php
• packages/storefront/src/Livewire/Storefront/Navigation/SearchForm.php
• packages/framework/src/Models/Traits/PyleSearchable.php
• packages/framework/src/Listeners/SyncSearchable.php