> ## Documentation Index
> Fetch the complete documentation index at: https://docs.waffo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Products

> Create and manage your product catalog

## Product Management

The Products page is where you manage your entire product catalog. Create one-time purchase items or subscription products.

<Frame>
  <img src="https://mintcdn.com/waffo/5dRlk76Jm-9Zm6Tj/images/dashboard/products-list.png?fit=max&auto=format&n=5dRlk76Jm-9Zm6Tj&q=85&s=2068cb755f3bad4349d93aadbaa7a94f" alt="Products List" width="1440" height="900" data-path="images/dashboard/products-list.png" />
</Frame>

## Product List

Your products are displayed in a table with:

| Column      | Description                                                |
| ----------- | ---------------------------------------------------------- |
| Name        | Product name and image thumbnail                           |
| Price       | Price with currency and billing interval                   |
| Status      | Active or Inactive                                         |
| Subscribers | Number of active subscriptions (for subscription products) |
| Created     | Creation date                                              |
| Actions     | Edit, copy link, toggle status                             |

## Creating a Product

<Frame>
  <img src="https://mintcdn.com/waffo/5dRlk76Jm-9Zm6Tj/images/dashboard/products-create.png?fit=max&auto=format&n=5dRlk76Jm-9Zm6Tj&q=85&s=afb107e0fe3b6c245f273109473fca24" alt="Create Product" width="1440" height="900" data-path="images/dashboard/products-create.png" />
</Frame>

<Steps>
  <Step title="Click 'Create Product'">
    Find the button in the top right of the Products page.
  </Step>

  <Step title="Enter Basic Information">
    **Required Fields:**

    * Product Name
    * Price
    * Currency
    * Pricing Type (One-Time or Subscription)
  </Step>

  <Step title="Add Details (Optional)">
    * Product Description (supports Markdown)
    * Product Image
    * Tax settings
  </Step>

  <Step title="Configure Subscription Settings">
    For subscription products only:

    * Billing Interval
    * Trial Period (optional)
  </Step>

  <Step title="Save Product">
    Click "Create" to publish your product.
  </Step>
</Steps>

## Product Fields

### Basic Information

| Field       | Required | Description                            |
| ----------- | -------- | -------------------------------------- |
| Name        | Yes      | Display name (shown to customers)      |
| Description | No       | Product details in Markdown format     |
| Image       | No       | Product image (recommended: 400x400px) |

### Pricing

| Field        | Options                                    | Description                                   |
| ------------ | ------------------------------------------ | --------------------------------------------- |
| Price        | Number                                     | The product price (in smallest currency unit) |
| Currency     | USD, EUR, GBP, CNY, JPY, HKD, etc.         | Transaction currency                          |
| Pricing Type | One-Time, Subscription                     | Payment model                                 |
| Tax Category | SaaS, Digital Goods, Software, eBook, etc. | Tax calculation rules                         |
| Tax Behavior | Inclusive, Exclusive                       | Price includes or excludes tax                |

### Price Limits

Each currency has a minimum and maximum price you can set on a product. Values outside this range are rejected when you save the product.

| Currency |  Minimum |       Maximum |
| -------- | -------: | ------------: |
| USD      |   \$1.00 |    \$7,500.00 |
| EUR      |    €1.00 |     €7,400.00 |
| GBP      |    £1.00 |     £6,400.00 |
| JPY      |     ¥100 |    ¥1,250,000 |
| HKD      | HK\$8.00 | HK\$61,000.00 |

<Note>
  CNY is available for display in your dashboard analytics, but cannot currently be used as a product pricing currency.
</Note>

### Subscription Settings

Only applicable for subscription products:

| Field         | Options                            | Description                 |
| ------------- | ---------------------------------- | --------------------------- |
| Interval      | Weekly, Monthly, Quarterly, Yearly | Billing frequency           |
| Trial Enabled | Yes/No                             | Offer free trial            |
| Trial Days    | Number                             | Trial duration (default: 7) |

### Tax Configuration

| Field        | Options              | Description                    |
| ------------ | -------------------- | ------------------------------ |
| Tax Category | SaaS, Digital Goods  | Tax calculation rules          |
| Tax Behavior | Inclusive, Exclusive | Price includes or excludes tax |

## Product Status

<CardGroup cols={2}>
  <Card title="Active" icon="check">
    * Product is live and purchasable
    * Payment links work
    * Shown in checkout
  </Card>

  <Card title="Inactive" icon="pause">
    * Product is hidden
    * Payment links return error
    * Existing subscriptions continue
  </Card>
</CardGroup>

To toggle status, use the switch in the product row or edit the product.

## Editing Products

1. Click on a product row or the edit icon
2. Modify any fields
3. Click "Save Changes"

<Warning>
  Changing the price of a subscription product only affects new subscribers. Existing subscribers keep their original price.
</Warning>

## Product Purchase Links

Every product gets a permanent purchase link that never expires:

```
https://checkout.waffo.ai/{store-slug}/{product-slug}
```

Test mode:

```
https://checkout.waffo.ai/{store-slug}/{product-slug}/test
```

**Get your link:**

* Click the "Copy Link" button on any product
* For advanced use cases, create a Checkout Session via API with custom parameters (dynamic link, 7-day TTL)

**Test vs Live:**

* Toggle Test Mode in Dashboard header to preview with test links
* Test links use the `/test` suffix

## Best Practices

<AccordionGroup>
  <Accordion title="Product Naming">
    * Use clear, descriptive names
    * Include the billing period for subscriptions (e.g., "Pro Plan - Monthly")
    * Avoid special characters
  </Accordion>

  <Accordion title="Descriptions">
    * List key features
    * Use bullet points for readability
    * Include what customers get
    * Mention support or guarantees
  </Accordion>

  <Accordion title="Images">
    * Use high-quality images (400x400px minimum)
    * PNG or JPG format
    * Keep file size under 2MB
    * Consistent style across products
  </Accordion>

  <Accordion title="Pricing Strategy">
    * Research competitor pricing
    * Consider regional purchasing power
    * Offer annual discounts (typically 15-20% off)
    * Round prices for simplicity
  </Accordion>
</AccordionGroup>

## Bulk Actions

Select multiple products to:

* Activate/Deactivate in bulk
* Export product data
* Delete (with confirmation)