> ## Documentation Index
> Fetch the complete documentation index at: https://help.hoopai.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Product Catalog
> Add products to your store, configure product types, write descriptions, upload media, and set SEO details.
The product catalog is the foundation of your store. Every item you sell — whether a physical good, digital download, or service — starts as a product in **Payments > Products**. From there, you choose which products appear in your store, configure their details, and manage them from a central location.
## Product types
The HoopAI platform supports four product types:
**Physical products** are items that need to be shipped to the customer. When creating a physical product, you can specify dimensions and weight for shipping rate calculations. Physical products support inventory tracking, variant options (size, color, material), and shipping profiles.
**Digital products** are downloadable files delivered to the customer after purchase. You can upload up to 10 files per product variant, with each file up to 100 MB. Supported file formats include images, audio, video, documents, and ZIP archives. Customers receive an email with a download link after checkout.
**Service products** represent non-shipped offerings such as consultations, coaching sessions, or custom work. Service products do not require shipping information or inventory tracking.
**Free products** have a zero-dollar price and are useful for lead magnets, sample downloads, or items bundled with other purchases.
## Creating a product
Click **Payments** in the left sidebar and select **Products**. Click **+ Create Product** in the top-right corner.
Fill in the **Product Title** — keep it clear and descriptive for both customers and search engines. Write a detailed **Description** using the rich text editor, which supports formatting, bold and italic text, bullet lists, and alignment options. Upload product images and videos. Images work best at 1024 x 1024 pixels and should not exceed 10 MB per file.
Choose between Physical, Digital, or Service in the **Product Type** field. For digital products, you will upload files at the variant level after creating the product.
Select a **Product Tax Code** if you want automatic tax calculations applied at checkout. You can choose whether tax is included in the displayed price or shown separately.
Define at least one price. Each price has a name, type (one-time or recurring), and amount. You can optionally add a **Compare-at price** to show customers the original price alongside a discounted price.
If your product comes in multiple options (for example, sizes or colors), add variants by creating option names and values. Each variant can have its own price. See the Product Variants guide for full details.
Fill in the **SEO Title** and **SEO Description**. When a product is toggled to appear in the store, these fields populate its search engine listing automatically.
Toggle **Include in online store** to ON. Only products with this toggle enabled will appear on your store's Product List page.
Click **Save**. The product is now in your catalog and visible in the store if the toggle is on.
## Product media
Each product supports multiple images and videos. Best practices:
* Use square images (1024 x 1024 px recommended) for consistent display on the Product List grid.
* Add multiple angles or views as separate images — customers can scroll through them on the Product Details page.
* Video content is displayed alongside images and can show the product in use or demonstrate features.
## Product descriptions
The rich text editor lets you format descriptions with:
* **Bold** and *italic* text for emphasis
* Bullet and numbered lists
* Text alignment (left, center, right)
* Headings to structure longer descriptions
Well-written descriptions that include product benefits, dimensions, materials, and use cases tend to improve conversion rates significantly.
## Bulk management
When managing a large catalog, use the **Bulk Actions** feature on the Products page. Select multiple products and apply changes across all of them at once, including:
* Toggling store visibility on or off
* Assigning to a collection
* Updating pricing
* Archiving or deleting products
Keep your product titles concise and keyword-rich. These titles appear on the Product List page, in the cart, on the Thank You page, and in order confirmation emails — consistent naming prevents customer confusion.
## Product status and visibility
Products can be in different states:
| Status | Description |
| -------------------------- | -------------------------------------------------------------------------------------------------- |
| **Active (store visible)** | Toggle on — product appears in the store |
| **Active (store hidden)** | Toggle off — product can still be sold via payment links or funnels, just not visible in the store |
| **Archived** | Product is removed from all active lists but historical order data is preserved |
## Bulk product editing (spreadsheet view)
For large catalogs, use the spreadsheet-style bulk editor to update multiple products simultaneously:
1. Go to **Payments > Products** and click **Bulk Edit** (or select multiple products and choose **Edit**).
2. A spreadsheet view opens with editable columns for name, price, compare-at price, inventory, status, and collection.
3. Click any cell to edit its value directly.
4. Changes are saved when you click **Save All** or navigate away and confirm.
The bulk editor is significantly faster than opening each product individually when you need to update pricing, inventory, or visibility across many products.
***
## Product labels and ribbons
Add visual labels (also called ribbons or badges) to product cards on the store's product list page to draw attention:
| Label | Use case |
| --------------- | ------------------------------------ |
| **Sale** | Products with a compare-at price set |
| **New** | Recently added products |
| **Best Seller** | Top-performing products |
| **Limited** | Low-stock or limited-edition items |
| **Custom** | Any text you define |
To add a label, open the product editor and look for the **Label** or **Ribbon** field. Enter the label text — it appears as a badge overlay on the product image in the store.
***
## Cost price and margin tracking
Track your profit margins by entering the cost price for each product:
1. Open a product in the editor.
2. Find the **Cost per item** field (under pricing or in an advanced section).
3. Enter the cost you pay for the product (wholesale cost, manufacturing cost, or supplier cost).
4. The platform calculates and displays your **margin** and **markup** based on the retail price minus the cost price.
This data helps you make informed pricing decisions and appears in revenue reports for margin analysis.
***
## Bulk import products
Import an entire product catalog from a CSV file:
1. Go to **Payments > Products** and click **Import**.
2. Download the CSV template to ensure correct formatting.
3. Fill in the template with your product data (name, description, price, type, SKU, inventory).
4. Upload the completed CSV and review the import preview.
5. Click **Import** to create all products.
See [Import & export](/payments/import-export) for the full CSV column reference and detailed import instructions.
Products created in Payments > Products are shared across the entire platform. The same product can be sold through the store, a funnel order form, a payment link, or an invoice — you do not need to create separate products for each channel.