> ## 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.

# Products

> Create and manage products in the HoopAI Platform — physical, digital, free, and subscription-based — with inventory tracking, collections, and customer reviews.

<div style={{position: "relative", paddingTop: "56.25%", marginBottom: "1.5rem"}}>
  <iframe src="https://player.mediadelivery.net/embed/622351/254dde73-0b90-411b-8098-1c438bd7bae4?preload=true" loading="lazy" style={{border: "none", position: "absolute", top: 0, height: "100%", width: "100%"}} allow="accelerometer; gyroscope; autoplay; encrypted-media; picture-in-picture" allowFullScreen={true} />
</div>

The Products section is your central catalog for everything you sell. Products you create here are available across invoices, payment links, order forms, documents, and your online store. You can manage pricing, inventory, variants, digital delivery, collections, and customer reviews — all from one place.

Navigate to **Payments → Products** to get started.

## Products overview

The products table lists all your products with:

<Frame caption="Products dashboard">
  <img src="https://mintcdn.com/hoopai-84ec0cdc/CS0bauo8Tbx8zu0U/images/payments-products-overview.png?fit=max&auto=format&n=CS0bauo8Tbx8zu0U&q=85&s=d6a0f40732e317d43bb0f78d9c0fb7fb" alt="Products overview" width="1586" height="240" data-path="images/payments-products-overview.png" />
</Frame>

| Column           | Description                        |
| ---------------- | ---------------------------------- |
| **Image**        | Primary product thumbnail          |
| **Name**         | Product display name               |
| **Type**         | Physical, digital, or free         |
| **Last updated** | Date the product was last modified |

### Importing products

You can populate your catalog from external sources without creating products one by one:

* **Import as CSV** — Upload a spreadsheet of products in bulk. Use this when migrating from another system.
* **Import from Stripe** — Pull your existing Stripe product catalog directly into the HoopAI Platform, keeping both systems in sync.

### Filters

Use the **Filters** button to narrow the product list by:

* **Collection** — show only products in a specific collection
* **Store visibility** — show only products available in (or hidden from) your stores
* **Source** — filter by where the product originated (manually created, imported from Stripe, etc.)

***

## Creating a new product

<Frame caption="Creating a product — set name, price type, images, and inventory tracking options">
  <img src="https://mintcdn.com/hoopai-84ec0cdc/CS0bauo8Tbx8zu0U/images/payments-invoices-new.png?fit=max&auto=format&n=CS0bauo8Tbx8zu0U&q=85&s=69f5a0078c4e20dc3675f9648ebe66ec" alt="Create product" width="1910" height="903" data-path="images/payments-invoices-new.png" />
</Frame>

<Steps>
  <Step title="Start a new product">
    Go to **Payments → Products** and click **+ Add product**.
  </Step>

  <Step title="Set the product name and description">
    Enter a clear product name. In the description field, explain what the customer is buying — this appears on checkout pages and invoices.
  </Step>

  <Step title="Set the price">
    Choose the pricing type:

    * **One-time** — a single charge
    * **Recurring** — a subscription billed on a set interval (daily, weekly, monthly, annual)
    * **Free** — no charge (useful for lead magnets or trial access)

    For recurring products, set the billing interval and trial period (if applicable).
  </Step>

  <Step title="Add images">
    Upload product images. The first image becomes the primary thumbnail shown on checkout and store pages.
  </Step>

  <Step title="Configure product type">
    * **Physical product** — enable shipping and set the weight and dimensions
    * **Digital product** — upload the file the customer receives after purchase
    * **Free product** — no payment required; useful for gated content or free trials
  </Step>

  <Step title="Enable inventory tracking (optional)">
    Toggle on **Track inventory** and enter the stock quantity. The platform will reduce the available count with each sale and can display "Out of stock" when inventory reaches zero.
  </Step>

  <Step title="Set the &#x22;Compared at&#x22; price (optional)">
    Enter a higher **Compared at** price to show a crossed-out original price alongside the sale price — a visual cue that communicates a discount to shoppers.
  </Step>

  <Step title="Save">
    Click **Save**. The product is now available to use in invoices, payment links, order forms, and your store.
  </Step>
</Steps>

***

## Digital products

Digital products are files (PDFs, videos, zip archives, software licenses, etc.) that are delivered to the customer automatically after purchase.

<Note>
  Digital product delivery is available exclusively for orders placed through eCommerce stores. Make sure the **Store** option is enabled in the product's settings.
</Note>

### Products without variants

<Steps>
  <Step title="Set the product type to digital">
    When creating or editing a product, open the **Pricing** section and select the pricing option you want to configure.
  </Step>

  <Step title="Enable digital delivery">
    Scroll to **Shipping and Delivery** and select **Digital Product**.
  </Step>

  <Step title="Upload the file">
    Click **Upload file** and select the file to deliver. Supported file types include images, audio, video, documents, and ZIP files. Up to 10 files can be uploaded per product, with each file limited to 100 MB.
  </Step>

  <Step title="Save">
    Verify the file names shown, then click **Save**.
  </Step>
</Steps>

### Products with variants

<Steps>
  <Step title="Open the variant">
    In the product editor, go to the **Variants** section and select the specific variant to configure.
  </Step>

  <Step title="Upload files for the variant">
    Upload the files to include with that variant. Each variant can have its own set of files.
  </Step>

  <Step title="Save">
    Review the file names and click **Save**. Repeat for each variant.
  </Step>
</Steps>

After purchase, customers receive an email with a secure download link. To ensure email delivery works, enable **Order Confirmation Email** at **Payments → Payment Settings → Notifications**. Without this, customers can only download from the checkout confirmation page.

<Tip>
  Different variants of the same product can be different types. For example, a "Book" product could have variants for Ebook (digital), Audiobook (digital), and Physical Book (physical).
</Tip>

***

## Free products

Free products work like regular products but do not require a payment method from the customer. They are useful for:

* Lead magnets (free guides, templates, tools)
* Trial memberships or course access
* Waitlist sign-ups with a product attached

<Steps>
  <Step title="Set price to free">
    When creating the product, set the price to **\$0.00** and choose the display currency.
  </Step>

  <Step title="Add a Compared at price (optional)">
    Enter a higher value in the **Compared at** field to show a strikethrough price (e.g., ~~\$25.00~~) — communicating the value of the free offer.
  </Step>

  <Step title="Link to a membership offer (optional)">
    Expand **Additional Options** to connect the product to a membership or course, granting access automatically after the free "purchase."
  </Step>

  <Step title="Build a checkout page">
    Add the free product to a funnel step's Products tab. In the funnel settings, you can disable the credit card field entirely so customers do not need to enter payment details.
  </Step>

  <Step title="Automate delivery via workflow">
    Go to **Automation → Workflows** and create a workflow triggered by **Order Form Submission** (for your free product funnel step). Add a **Send Email** action to automatically deliver the product or access link.
  </Step>
</Steps>

***

## Inventory management

<Steps>
  <Step title="Enable inventory tracking">
    Open a product and toggle on **Track inventory**.
  </Step>

  <Step title="Set the starting quantity">
    Enter the number of units currently in stock.
  </Step>

  <Step title="Monitor stock levels">
    The inventory count decreases automatically with each sale. When stock hits zero, the product is marked as out of stock and cannot be purchased.
  </Step>

  <Step title="Update stock manually">
    At any time, open the product and edit the inventory count to reflect restocks, adjustments, or corrections.
  </Step>
</Steps>

***

## The "Compared at" price

The **Compared at** price displays a crossed-out higher price next to the actual selling price, creating a visual sale indicator on your checkout pages and store listings.

For example: \~\~$199~~ **$99\*\*

<Steps>
  <Step title="Open the product">
    Edit an existing product or create a new one.
  </Step>

  <Step title="Enter the compared at price">
    In the pricing section, enter a value in the **Compared at** field. This must be higher than the actual sale price.
  </Step>

  <Step title="Save">
    The strikethrough price will appear on checkout pages and in your store.
  </Step>
</Steps>

***

## Bulk editing products

When you need to update prices, statuses, or other fields across many products at once, use the bulk edit tool.

<Steps>
  <Step title="Select products">
    In the Products list, check the boxes next to the products you want to edit.
  </Step>

  <Step title="Open bulk edit">
    Click **Bulk edit** in the toolbar that appears.
  </Step>

  <Step title="Apply changes">
    Update the fields you want to change across all selected products and click **Save**.
  </Step>
</Steps>

***

## Product collections

Collections group related products together, making it easier for customers to browse your store by category.

<Frame caption="Product collections — organize products into manual or smart collections for your store navigation">
  <img src="https://mintcdn.com/hoopai-84ec0cdc/CS0bauo8Tbx8zu0U/images/payments-subscriptions-overview.png?fit=max&auto=format&n=CS0bauo8Tbx8zu0U&q=85&s=061036751cf81b995eeea28c0ab74bbb" alt="Product collections" width="1575" height="645" data-path="images/payments-subscriptions-overview.png" />
</Frame>

### Manual collections

A manual collection is a fixed list — you choose exactly which products belong to it.

<Steps>
  <Step title="Create a manual collection">
    Go to **Payments → Products** and click **Collections → Create collection**. Select **Manual**.
  </Step>

  <Step title="Name the collection">
    Give the collection a name (e.g., "Summer Sale", "Coaching Packages").
  </Step>

  <Step title="Add products">
    Search for and select the products to include. Click **Save**.
  </Step>
</Steps>

### Smart collections

A smart collection populates automatically based on rules — any product that matches the criteria is added to the collection without manual selection.

<Steps>
  <Step title="Create a smart collection">
    Click **Collections → Create collection** and select **Smart**.
  </Step>

  <Step title="Define the rules">
    Set conditions such as:

    * Product title contains a keyword
    * Price is above or below a value
    * Product type equals physical/digital
    * Tag equals a specific value
  </Step>

  <Step title="Set the match logic">
    Choose **All conditions** (AND logic) or **Any condition** (OR logic).
  </Step>

  <Step title="Save">
    The collection populates automatically and updates whenever products are added or changed.
  </Step>
</Steps>

***

## Customer reviews

The HoopAI Platform supports customer reviews on products sold through your store.

### Enabling reviews on your store

<Steps>
  <Step title="Open the store builder">
    Go to **Sites → Stores** and edit your store. Open the **Products List** or **Product Details** page builder.
  </Step>

  <Step title="Enable the Reviews toggle">
    Select the **Products List** element and enable **Show Reviews and Ratings**. You can also customize the color of the star icons and review text to match your branding.
  </Step>

  <Step title="Save and publish">
    Click **Save** and publish the page for the changes to go live.
  </Step>
</Steps>

### How customers submit reviews

Customers see a **Reviews and Ratings** section at the bottom of each Product Details page. Clicking **Write a Review** opens a form with required fields (name, email) and optional fields (phone, headline, description). After submission, the review enters the **Pending** queue and a confirmation is shown to the customer.

### Moderating reviews

Go to **Payments → Products → Reviews** to manage all submitted reviews.

| Tab            | What it contains                |
| -------------- | ------------------------------- |
| **Pending**    | Reviews awaiting your decision  |
| **Approved**   | Reviews published on your store |
| **Unapproved** | Reviews you have hidden         |

For each review you can see the **author** (name and email), **review details** (headline and text), **star rating**, **date and time submitted**, and the **product and store** it was left on.

Use the **Actions** dropdown on any review to:

* **Approve** — publish the review on your store
* **Unapprove** — hide the review from your store
* **Reply** — add a public response to the review
* **Move to trash** — permanently remove the review

You can filter reviews by date range, store location, product name, or star rating. Approved reviews appear on the Product List page (showing average rating and total count) and on the Product Details page (showing each review and a rating breakdown).

***

## Frequently asked questions

<AccordionGroup>
  <Accordion title="Can I have multiple price points for the same product?">
    Yes. Use **product variants** to create different versions of the same product — for example, different sizes, tiers, or durations — each with its own price.
  </Accordion>

  <Accordion title="What happens when a product goes out of stock?">
    If inventory tracking is enabled and the count reaches zero, the product is marked out of stock and customers cannot purchase it until you update the inventory.
  </Accordion>

  <Accordion title="Can I use the same product in multiple invoices and payment links?">
    Yes. Products are shared across the entire platform. Once created, a product can be added to any invoice, payment link, order form, or store.
  </Accordion>

  <Accordion title="How do I archive a product I no longer sell?">
    Open the product and change its status to **Archived**. Archived products are hidden from your store and checkout but remain in your records and can be reactivated.
  </Accordion>

  <Accordion title="Can I import my existing Stripe products?">
    Yes. Go to **Payments → Products** and use the **Import from Stripe** option. Your Stripe product catalog is pulled directly into the HoopAI Platform, eliminating manual re-entry.
  </Accordion>

  <Accordion title="Why isn't my digital product being delivered by email?">
    Digital product email delivery requires the **Order Confirmation Email** notification to be enabled at **Payments → Payment Settings → Notifications**. Without it, customers can only download from the checkout confirmation page. Also confirm the product is sold through an eCommerce store — digital delivery is not available through other checkout types.
  </Accordion>

  <Accordion title="Can I add a product to multiple collections?">
    Yes. A product can belong to multiple manual and smart collections simultaneously. This is useful for cross-listing products in different store categories.
  </Accordion>

  <Accordion title="How do I set up a product with a trial period?">
    When creating a recurring product, toggle on the **Trial period** option and enter the number of trial days. Customers can access the product during the trial without being charged. The first billing cycle starts after the trial ends.
  </Accordion>
</AccordionGroup>
