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

# Set Up and Manage Your Product Catalog in Fliqr AI

> Create and manage the products customers can browse and buy in chat. Add products manually or import in bulk via CSV, then display them in your Flows.

Before you can sell anything in a conversation, Fliqr AI needs to know what you're selling. The Product Catalog is the central store for all products your customers can browse and purchase. Products live here independently of any specific Flow, so you add them once and reference them from any conversation across any channel.

## Overview

Each product in the catalog has a name, description, price, image, SKU, and stock quantity. You can organize products into categories to make browsing easier, both for customers navigating a catalog view and for you when building Flows that display specific product sets.

Products in the catalog connect directly to the cart and checkout system — when a customer adds a product from a chat, Fliqr AI tracks the cart and manages inventory counts automatically.

## Prerequisites

* An active Fliqr AI account with the e-commerce module enabled
* Product images hosted at a publicly accessible URL (or uploaded via the Fliqr AI media library)
* [Payment provider connected](/docs/ecommerce/payments) before launching checkout flows

## Add a Product

<Steps>
  <Step title="Open the Catalog">
    Go to **E-Commerce → Catalog**. You will see the full product list, or an empty state if no products exist yet.
  </Step>

  <Step title="Create a new product">
    Click **Add Product**. Fill in the following fields:

    | Field              | Description                                                               |
    | ------------------ | ------------------------------------------------------------------------- |
    | **Name**           | The product name shown to customers                                       |
    | **Description**    | A short description — 1–3 sentences works best for chat display           |
    | **Price**          | The selling price in your account currency                                |
    | **Image URL**      | A direct link to the product image                                        |
    | **SKU**            | Your internal stock-keeping unit identifier                               |
    | **Category**       | (Optional) Assign to a category for browsing and filtering                |
    | **Stock quantity** | Current inventory count; Fliqr AI decrements this on each completed order |
  </Step>

  <Step title="Save the product">
    Click **Save**. The product appears in your catalog list and is immediately available for use in Flows.
  </Step>

  <Step title="Organize into categories">
    To create a category, go to **E-Commerce → Catalog → Categories → Add Category**. Then edit any product and assign it to the category. Categories appear as filter tabs in the Send Catalog Flow block.
  </Step>
</Steps>

## Bulk Import via CSV

If you have an existing product inventory, you can import it in a single step rather than adding products one by one.

<Steps>
  <Step title="Download the CSV template">
    Go to **E-Commerce → Catalog → Import → Download Template**. The template includes all required column headers.
  </Step>

  <Step title="Populate the CSV">
    Fill in one row per product. The required columns are:

    ```text theme={null}
    name, description, price, sku, image_url, category, stock
    ```

    * `price` should be a number without currency symbols (e.g., `29.99`)
    * `image_url` must be a publicly accessible direct link to the image file
    * `category` values are created automatically if they do not already exist
    * `stock` should be an integer; use `0` for out-of-stock items
  </Step>

  <Step title="Upload the CSV">
    Go to **E-Commerce → Catalog → Import → Upload CSV**. Select your file and click **Import**. Fliqr AI validates the file and reports any rows with errors before importing.
  </Step>
</Steps>

<Tip>
  Use high-resolution square images of at least 800×800 pixels for product cards. Chat platforms compress images on delivery, and starting with a low-resolution image results in blurry thumbnails that undermine customer confidence. Aspect ratios other than 1:1 may be cropped differently across channels.
</Tip>

## Display Products in a Flow

Once products exist in the catalog, you can surface them in conversations using two Flow blocks:

**Send Product** — Displays a single product card with the name, image, price, description, and an Add to Cart button. Use this when you want to highlight a specific item in response to a customer's question.

**Send Catalog** — Displays a browsable product list, optionally filtered by category. Use this at the top of a shopping flow to let customers explore your range.

<Steps>
  <Step title="Add a product block to your Flow">
    In the Flow Builder, click **Add Block → E-Commerce → Send Product** (or **Send Catalog**).
  </Step>

  <Step title="Select the product or category">
    For **Send Product**, choose the specific product from your catalog. For **Send Catalog**, choose whether to show all products or filter by a category.
  </Step>

  <Step title="Connect to the cart">
    Connect the block's output to an **Add to Cart** block so customers can act on what they see. See [Cart & Checkout](/docs/ecommerce/cart-checkout) for the full flow setup.
  </Step>
</Steps>

## What's Next

<CardGroup cols={2}>
  <Card title="Cart & Checkout" icon="cart-shopping" href="/docs/ecommerce/cart-checkout">
    Build the checkout flow that takes customers from cart to confirmed order.
  </Card>

  <Card title="Payments" icon="credit-card" href="/docs/ecommerce/payments">
    Connect Stripe or PayPal to accept payment at checkout.
  </Card>
</CardGroup>
