Products

What This Is

Products are the main catalog records you sell through Pyle. A product brings together the item name, SKU, category, brand, product type, pricing inputs, stock behavior, shipping details, and related media.

This is one of the main day-to-day records merchandisers and catalog operators work with.

When You Would Use It

Use Products when you need to:

• add a new sellable item
• update catalog details for an existing item
• control whether an item is active, discontinued, or featured
• adjust shipping, stock, or ordering-related fields
• connect the item to the right type, category, and brand
• prepare the item for any separate collection workflow your team uses

Do not use the product record when you only need to rename or restructure a category, brand, or product type. Those are managed separately.

Before You Start

Before you create or update a product, make sure:

• you can access the main Products area in the admin
• the brand, product type, and category already exist
• you know the bilingual product name you want to publish
• you understand that some related product details live in sub-sections such as attributes, images, documents, and videos
• the collection you want to assign already exists under Settings > Collections if you plan to set it now

How To Use It In The Admin

1. Open the main Products screen in the admin.
2. Create a new product if you are adding a new item, or open an existing product to edit it.
3. In the create dialog, set the basic fields:
   • active status
   • publish status
   • SKU
   • barcode if available
   • name
   • brand
   • product type
   • product category
4. After creation, use the product detail page to complete the rest of the setup:
   • descriptions
   • stock status and stock behavior
   • pricing details such as MSRP and quantity limits
   • shipping dimensions
   • product associations such as brand, type, category, and collection
5. Save the product.
6. Use the related blocks on the same page when you need to add attributes, images, documents, videos, cross-sells, or shipping classes.

What to pay attention to:

• SKU is the operational identifier teams usually search by.
• Active, Discontinued, and Featured each change the merchandising state in different ways.
• Publish Status controls whether a product is visible on the storefront independently of the active toggle. See the next section for details.
• The brand, type, and category choices affect downstream browse, shipping, and promotion behavior.
• The Collection dropdown in the associations section shows only collections that belong to the selected brand. Changing the brand resets the collection choice.
• When a collection is already assigned, a small icon link appears beside the field label. Click it to jump directly to that collection in Settings > Collections.

Publish Status

Every product has a publish status that works alongside the active toggle to control storefront visibility.

The three values are:

Status	Meaning
Published	The product can appear in storefront search, browse, and cross-sells.
Draft	The product is being prepared and is hidden from the storefront.
Unpublished	The product has been deliberately withdrawn from the storefront.

How it connects to the active toggle:

• Deactivating a product automatically forces the publish status to Unpublished.
• Activating a product automatically sets the publish status to Published.
• You can manually set a product to Draft while it is active to keep it out of the storefront without deactivating it.

A product appears on the storefront only when it is both active and published.

You can filter the products table by publish status using the Filter by publish status control.

The default publish status for new products is configurable at the platform level. In a standard installation, new products start as Published.

What It Changes In The Storefront

Products are first-class storefront records.

They affect:

• whether shoppers can open a product page
• what the shopper sees on the product page
• whether a product can appear in category, brand, and collection browse flows
• whether a product appears in search results and cross-sell recommendations
• whether product-group selectors appear for switching between related products
• whether the Buy Again button is available on a past-order item

A product must be both active and published to be visible to shoppers. Setting a product to Draft or Unpublished removes it from all storefront surfaces while keeping the product record intact in the admin.

Some shopper-facing changes are indirect. For example, changing category or collection context can affect filtering or grouped product selection rather than changing the product page text directly.

Common Tasks

Create a new product

Use the main Products screen and complete the initial create dialog, then finish the record on the product detail page.

Update pricing or shipping inputs

Use the product detail page to update MSRP, quantity limits, shipping dimensions, and stock behavior.

Change product classification

Use the association section on the product page to update the brand, product type, category, or collection.

If you change the brand, the collection field resets. Select the new collection from the filtered dropdown before saving.

Control storefront visibility with publish status

Use the Publish Status field on the product page to move a product between Draft, Published, and Unpublished without changing its active state.

To hide a product from the storefront while keeping it active, set its publish status to Draft or Unpublished.

Add supporting content

Use the product sub-sections to add images, documents, videos, and attributes.

Bulk manage products

Use Excel import/export when you need to create or update many products at once.

Rules, Limits, And Things To Watch

• A product must be both active and published to appear on the storefront.
• Deactivating a product automatically sets its publish status to Unpublished.
• Activating a product automatically sets its publish status to Published.
• A product depends on its catalog context. If the brand, type, or category is wrong, downstream browse and rules can be wrong too.
• Some related fields are not managed from the first create dialog. You often need the full product page after creation.
• The collection dropdown on the product page is filtered to the selected brand. If the expected collection is not listed, confirm the collection's brand assignment in Settings > Collections.
• Changing the brand on an existing product resets the collection field. Re-select the correct collection before saving.
• Some storefront behavior depends on related setup such as images, inventory, offers, or product groups.
• Bulk Excel workflows can create and update products, so teams should agree on which workflow is the source of truth.

Troubleshooting

I created a product, but it is incomplete

That is normal if you only used the create dialog. Open the product detail page and finish the shipping, stock, association, and supporting-content sections.

I changed a product, but the storefront still looks wrong

Check the related records too. Product pages depend on images, category context, offers, inventory, and sometimes product groups.

If the issue is collection-related, review the collection detail in Settings > Collections and confirm the product groups are configured correctly.

My product is not appearing in the storefront

First confirm the product is both active and has a publish status of Published. A product set to Draft or Unpublished will not appear in storefront search, browse, or cross-sells, even if it is active.

I cannot classify the product the way I want

Make sure the brand, product type, and category records already exist first.

I need to update many products at once

Use the Excel product export and import workflow instead of editing each product manually.

For a storefront-visibility checklist, see How to troubleshoot why a product is missing from the storefront.

Related Features

• Catalog & Merchandising
• Product Types
• Product Categories
• Brands
• Collections
• How to create and publish a product
• How to troubleshoot why a product is missing from the storefront

Sources

• packages/admin-panel/routes/admin-panel.php
• packages/admin-panel/src/Http/Controllers/ProductsIndexController.php
• packages/admin-panel/src/Http/Controllers/ProductShowController.php
• packages/admin-panel/resources/js/pages/products/index/index.tsx
• packages/admin-panel/resources/js/pages/products/show/index.tsx
• packages/framework/src/Actions/Import/Product/Sheets/ImportProductRows.php
• packages/framework/src/Listeners/Product/RemoveProductCollection.php
• packages/storefront/src/Livewire/Storefront/Product/Page.php
• packages/framework/src/Http/Resources/Storefront/ProductResource.php
• packages/framework/src/Enums/ProductPublishStatus.php
• packages/framework/src/Models/Product.php