> ## Documentation Index
> Fetch the complete documentation index at: https://afrizon-client.tunzaa.co.tz/llms.txt
> Use this file to discover all available pages before exploring further.

# Add and Manage Products in Your Afrizon Store

> Learn how to add products, manage stock levels, set up variants, and upload your full catalogue in bulk using the Afrizon vendor app.

The **Products** screen is where you build and maintain your store's catalogue. From here you can add individual products, update stock and pricing, toggle product visibility, and upload large catalogues in one go using the bulk upload feature. This page covers everything you need to know about managing your products on Westpoint.

## Viewing your products

Tap **Products** in the vendor navigation bar to see all your listings. You can search by product name and filter the list by status:

* **All Status** — shows every product regardless of state
* **Active** — products visible to customers
* **Hidden** — products you have manually hidden from the storefront
* **In Stock** — products with available inventory
* **Low Stock** — products approaching your low stock threshold
* **Out of Stock** — products with zero inventory quantity

## Adding a product

<Tabs>
  <Tab title="Single product">
    <Steps>
      <Step title="Open the Add Product form">
        From the **Products** screen, tap **Add Product** in the top-right corner.
      </Step>

      <Step title="Enter product details">
        Fill in the required fields:

        * **Product Name** — the name customers see in search and on the product page
        * **Short Description** — a brief summary shown in product listings
        * **Description** — a full description of the product, its features, and any relevant details
        * **SKU** — a unique identifier for internal tracking (required)
        * **Price** — the base selling price
        * **Sale Price** — an optional discounted price; when set, customers see both prices
        * **Cost Price** — your cost price for margin tracking (not shown to customers)
      </Step>

      <Step title="Set stock quantity">
        Enter the **Stock Quantity** (inventory quantity). You can also set:

        * **Low Stock Threshold** — the quantity at which the app marks the product as **Low Stock** and triggers an alert
        * **Inventory Tracking** — enable this to have the platform track stock levels automatically as orders are placed
      </Step>

      <Step title="Choose a category">
        Select one or more categories from the list. Categories determine where your product appears in the marketplace browse experience.
      </Step>

      <Step title="Add product images">
        Tap **Product Images** to upload photos. You can add multiple images — tap **Set as Primary** on the image you want shown first. Customers see the primary image in search results and category pages.
      </Step>

      <Step title="Add tags (optional)">
        Enter comma-separated tags to help with search discoverability.
      </Step>

      <Step title="Add shipping details (optional)">
        If the product requires shipping, you can enter:

        * **Weight (g)** — used to calculate delivery costs
        * **Dimensions** — length, width, and height
      </Step>

      <Step title="Configure variants (optional)">
        If your product comes in multiple options (for example, different sizes or colours), toggle **This product has variants**. See the Product variants section below.
      </Step>

      <Step title="Save the product">
        Tap **Save Product**. The product is added to your catalogue and, if active, becomes visible to customers once reviewed.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Bulk upload">
    <Steps>
      <Step title="Download the CSV template">
        From the **Products** screen, tap **Bulk Upload Products**, then tap **Download Template** to get the CSV file. Open the template to see the required columns and format.
      </Step>

      <Step title="Fill in your product data">
        Enter your products into the CSV following the template exactly. You can include product images by placing image files in a folder alongside the CSV and compressing everything into a ZIP file.

        <Note>
          CSV files must match the template format exactly. ZIP files must contain your CSV plus any product images. The maximum file size is 50 MB.
        </Note>
      </Step>

      <Step title="Upload your file">
        Tap **Upload** and select your CSV or ZIP file from your device. The app validates your file and shows a summary of valid, warning, and invalid products before anything is published.
      </Step>

      <Step title="Review validation results">
        After upload, you will see a batch summary with:

        * **Valid products** — ready to be added to your catalogue
        * **Warning products** — will be added but have non-critical issues (for example, a missing category that could not be matched)
        * **Invalid products** — contain errors that must be fixed before they can be added

        Tap into the batch to review specific rows and errors.
      </Step>

      <Step title="Approve the batch">
        Once you are satisfied with the validation results, approve the batch. The platform processes your products and adds the valid ones to your catalogue.
      </Step>
    </Steps>
  </Tab>
</Tabs>

## Product variants

Variants let a single product listing cover multiple options, such as different sizes, colours, or configurations. When you enable **This product has variants** on a product, you can add individual variants, each with:

* **Variant Name** — a descriptive name (for example, "Blue / Large")
* **Variant SKU** — a unique SKU for this specific variant
* **Variant Price** — the price for this variant (can differ from the base price)
* **Variant Stock** — the inventory quantity for this variant
* **Attributes** — flexible key-value pairs such as `color: Blue` or `size: Large`

Customers select their preferred variant from the product page before adding to cart.

## Editing a product

From the **Products** screen, tap any product to open its detail view. Tap **Edit Product** to open the edit form, update any fields, and tap **Save Product** to apply your changes.

To update only stock levels or pricing without editing the full product, tap **Update Stock** from the product detail screen.

## Showing and hiding products

You can control whether a product is visible to customers without deleting it:

* Tap **Hide Product** to remove it from customer-facing pages. You will see a confirmation prompt before the change is applied.
* Tap **Activate Product** to make a hidden product visible again.

<Tip>
  Use the hide/show toggle when a product is temporarily out of stock or when you are preparing a new listing before it is ready to go live.
</Tip>

## Product verification status

After you add or edit a product, the platform may review it before it appears in the marketplace. You can see the current review status — along with any rejection reason — on the **Product Details** screen under **Review Status**. If a product is rejected, the reason is shown under **Rejection Reason** and you can edit and resubmit.

## Deleting a product

To permanently remove a product, open the product detail screen and tap **Delete**. Confirm the deletion when prompted. Deleted products cannot be recovered, so consider hiding a product instead if you may need it again later.