What this page is

This guide explains how to manage your product catalog using the Products admin screen. It matches your site theme and can be viewed without logging in, but all actions described here require an Owner or Staff user in the real app.

Quick start

1. Open the Products list
2. Select Add Product to create a new item.
3. Fill out the Basics, set Base Price, and save.
4. Come back to add Categories, Images, and Attachments.
5. Toggle Active to control visibility to buyers.

The Products list

The list shows SKU, Name, Price, Available, Updated, and Active columns. You also get Edit and Enable or Disable actions.

• Search: type part of a SKU or Name, then press Search.
• Sort: click a column header to sort by that field. Clicking again flips the direction.
• Page size: choose how many rows to show. Maximum is 200 per page.
• Availability: the Available column comes from your inventory view that totals all warehouses.
• Pager: use First, Prev, Next, Last to move around large catalogs.

Tip: Use consistent SKUs so search finds items fast.

Add or edit a product

1. Choose Add Product or click Edit on a row.
2. Complete the Basics section:
   • SKU and Name are required.
   • Description, Unit of Measure, and Case Pack Qty are optional.
   • Weight and Length/Width/Height accept whole numbers.
   • Base Price must be a non-negative number with up to 2 decimals.
   • Active controls visibility in buyer portals and exports.
3. Click Create Product or Save Changes.

If you see an error like "SKU and Name are required" or "Base Price must be a non-negative number," fix the field and save again.

Categories

Use Categories to group products for navigation and filtering.

1. Open a product in Edit mode.
2. In the Categories section, tick the boxes you want.
3. Click Save Categories.

Only active categories for your tenant are shown. Saving replaces the full set of categories for that product.

Images

Add multiple images and control their display order.

1. Open a product in Edit mode and scroll to Images.
2. Choose a file and set optional Alt Text and Sort Order.
3. Click Add Image. The system converts uploads to WebP for fast loading.

Allowed image types

• jpg, jpeg, png, gif, webp

Notes

• After conversion, the original file may be removed and the WebP used in the site.
• Use the Delete button on a row to remove an image.

Attachments and spec sheets

Upload extra files like safety sheets, sell sheets, or technical PDFs. You can add a friendly Title for each file.

1. Open the product and go to Attachments and Spec Sheets.
2. Use Upload Attachment for general files or Upload Spec Sheet for a PDF spec.
3. Optionally set Sort Order during upload where shown. Titles are optional and can match the file name if left blank.

Allowed attachment types

• pdf, doc, docx, xls, xlsx, csv, txt, rtf, odt, ppt, pptx, zip, jpg, jpeg, png, gif, webp

Storage

Use Delete to remove a file. This also removes it from disk.

Enable or disable a product

Use Toggle Active on the Edit page, or the Enable or Disable button on the list. Disabled items remain in your database but are hidden from buyers and exports that honor the flag.

Import products by CSV

Use the Import CSV button on the list page to upload new or updated products in bulk. After import, you can still fine-tune each product here for images, attachments, and categories.

Sorting, searching, and paging details

• Sort keys: sku, name, price, qty, updated.
• Direction: ascending or descending, flips when you click the header again.
• Search: matches SKU or Name contains.
• Page size: default 25, up to 200.

Validation rules you will see

• SKU and Name are required.
• Base Price cannot be negative and must have 0 to 2 decimals.
• Case Pack Qty, Weight, and dimensions accept whole numbers only. Leave blank if not used.

How inventory shown here works

The Available column on the list uses your inventory view that aggregates by product across all warehouses. If the number looks off, check your warehouse stock, reservations, and recent transactions.

Common tasks and tips

• Update pricing: Edit the product, change Base Price, and Save Changes.
• Reorder images: Set Sort Order and re-upload or adjust as needed.
• Clean up: Use Delete on images or attachments you no longer want to display.
• Categories not showing: Make sure the category is active in your Categories admin.

Troubleshooting

• Saved but not visible to buyers: Ensure the product is Active. Also confirm buyer price rules are not overriding availability in front-end pages.
• Image upload fails: Confirm the file type is allowed and under your web server size limit. Try a smaller image.
• Attachment upload fails: Verify the extension is allowed and that the title is under 500 characters.
• Strange numbers in Available: Check recent inventory transactions and reservations. Imports can also update on hand values.