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

# Product Catalogue

> Upload, manage, and preview products used for tagging in community content through the social.plus Console

<Info>
  The Product Catalogue in the social.plus Console allows administrators to manage a centralized product database. Products added here can be tagged in community content such as posts, comments, and stories — enabling social commerce experiences and product discovery within your application.
</Info>

<CardGroup cols={3}>
  <Card title="Product Listing" icon="table">
    View, search, and filter all products in a comprehensive table view
  </Card>

  <Card title="Add Products" icon="circle-plus">
    Create individual products with details, pricing, images, and URLs
  </Card>

  <Card title="Bulk Import" icon="file-import">
    Import multiple products at once via CSV file upload
  </Card>

  <Card title="Bulk Update" icon="arrows-rotate">
    Update existing product details in bulk using CSV files
  </Card>

  <Card title="Status Management" icon="toggle-on">
    Control product visibility with Active and Archived statuses
  </Card>

  <Card title="Product Tagging" icon="tag">
    Enable products to be tagged in community content for social commerce
  </Card>
</CardGroup>

## Overview

The Product Catalogue provides a centralized dashboard for uploading, managing, and previewing products that can be tagged in community content. This enables social commerce workflows where users can discover and engage with products directly within posts, comments, and stories.

<img src="https://mintcdn.com/social-b97141fb/olsZ9SK7BH5eDbrX/images/analytics-and-moderation/console/product-management/product-catalogue-list.png?fit=max&auto=format&n=olsZ9SK7BH5eDbrX&q=85&s=94e1b669f063826bc45fd085dc2e2a97" alt="Product Catalogue Dashboard" width="1920" height="1080" data-path="images/analytics-and-moderation/console/product-management/product-catalogue-list.png" />

The product list displays all products with the following information at a glance:

| Column           | Description                                              |
| ---------------- | -------------------------------------------------------- |
| **Thumbnail**    | Product image preview                                    |
| **Product ID**   | Unique alphanumeric identifier for the product           |
| **Product name** | Display name shown when the product is tagged in content |
| **Price**        | Product price with currency                              |
| **URL**          | Link to the product page                                 |
| **Status**       | Current status — `Active` or `Archived`                  |
| **Created at**   | Timestamp of product creation                            |
| **Last updated** | Timestamp of the most recent update                      |
| **Updated by**   | The admin user who last modified the product             |
| **Actions**      | Edit or delete the product                               |

You can search products by **name** and filter by **status** using the controls at the top of the page. Columns such as **Product name**, **Created at**, and **Last updated** support sorting.

## Quick Start

<Steps>
  <Step title="Access Product Catalogue">
    Navigate to **Product catalogue** in the left sidebar of your social.plus Console
  </Step>

  <Step title="Add Your First Product">
    Click **+ Add product** to create a product with an ID, name, URL, price, and thumbnail image
  </Step>

  <Step title="Import Products in Bulk">
    Use the **Import** button to upload a CSV file with multiple products at once
  </Step>

  <Step title="Manage Product Status">
    Set products as **Active** to make them available for tagging, or **Archived** to hide them from content tagging
  </Step>
</Steps>

## Adding a Product

Click the **+ Add product** button in the top-right corner to create a new product entry.

<img src="https://mintcdn.com/social-b97141fb/olsZ9SK7BH5eDbrX/images/analytics-and-moderation/console/product-management/add-product.png?fit=max&auto=format&n=olsZ9SK7BH5eDbrX&q=85&s=a82f358a164036ad0e9cc30368f157e3" alt="Add Product Form" width="1920" height="1080" data-path="images/analytics-and-moderation/console/product-management/add-product.png" />

### Product Details

<AccordionGroup>
  <Accordion title="Product ID" icon="fingerprint">
    **Required** — A unique alphanumeric identifier for the product (max 100 characters). This ID cannot be changed after creation.

    **Example:** `SKU-12345`, `prod-widget-blue`
  </Accordion>

  <Accordion title="Status" icon="toggle-on">
    **Required** — Controls product visibility for content tagging:

    * **Active**: Product is available for tagging in community content
    * **Archived**: Product is hidden from content tagging but retained in the catalogue
  </Accordion>

  <Accordion title="Product Name" icon="text">
    **Required** — The display name shown when the product is tagged in content (max 200 characters). Choose a clear, recognizable name for your users.
  </Accordion>

  <Accordion title="Product URL" icon="link">
    **Required** — The URL linking to the product page. The `https://` prefix is automatically applied.

    **Example:** `example.com/products/widget-blue`
  </Accordion>

  <Accordion title="Price" icon="dollar-sign">
    **Optional** — The product price with a selectable currency. The default currency is remembered from your last selection.
  </Accordion>

  <Accordion title="Product Images" icon="image">
    **Optional** — A thumbnail image for the product. You can either:

    * **Upload a file**: Drag and drop or click to upload (`.png`, `.jpg`, up to 10 MB)
    * **Add from URL**: Provide a direct URL to the product image

    Recommended image aspect ratio is **1:1**. Image file size should remain under **1 GB**.
  </Accordion>
</AccordionGroup>

## Editing a Product

Click the **edit icon** (pencil) in the **Actions** column of any product row to modify its details.

<img src="https://mintcdn.com/social-b97141fb/olsZ9SK7BH5eDbrX/images/analytics-and-moderation/console/product-management/edit-product.png?fit=max&auto=format&n=olsZ9SK7BH5eDbrX&q=85&s=04b0f6f58d60de8cbce530dd633c079a" alt="Edit Product Form" width="1920" height="1080" data-path="images/analytics-and-moderation/console/product-management/edit-product.png" />

The edit form displays the same fields as the add form, with the following differences:

* **Product ID** is read-only and cannot be changed after creation
* All other fields (name, URL, price, status, images) can be updated
* Click **Save changes** to apply your modifications

## Importing Products via CSV

Click the **Import** button to bulk-create products from a CSV file.

<img src="https://mintcdn.com/social-b97141fb/olsZ9SK7BH5eDbrX/images/analytics-and-moderation/console/product-management/import-products.png?fit=max&auto=format&n=olsZ9SK7BH5eDbrX&q=85&s=faaf735eff05bada87d93994e8b4913d" alt="Import Product Dialog" width="1920" height="1080" data-path="images/analytics-and-moderation/console/product-management/import-products.png" />

<Steps>
  <Step title="Download Sample CSV">
    Click **Download sample CSV** to get the required file format and column structure
  </Step>

  <Step title="Prepare Your CSV File">
    Fill in the CSV with your product data. Ensure all required columns are included and the file follows the sample format
  </Step>

  <Step title="Upload the File">
    Drag and drop your `.csv` file into the upload area, or click **Choose file** to browse. Maximum file size is **15 MB**
  </Step>

  <Step title="Start Import">
    Click **Import** to begin processing. A status notification will appear showing the import progress and summary
  </Step>
</Steps>

<Note>
  The import function creates **new products** in your catalogue. Each row in the CSV should contain a unique product ID that does not already exist in the catalogue.
</Note>

## Updating Products via CSV

Click the **Update** button to bulk-update existing products from a CSV file.

<img src="https://mintcdn.com/social-b97141fb/olsZ9SK7BH5eDbrX/images/analytics-and-moderation/console/product-management/update-products.png?fit=max&auto=format&n=olsZ9SK7BH5eDbrX&q=85&s=f14144697fd9410c83f03d553203be7b" alt="Update Product Dialog" width="1920" height="1080" data-path="images/analytics-and-moderation/console/product-management/update-products.png" />

<Warning>
  Each row in the update CSV must include a valid **product\_id** that already exists in the catalogue. Rows with unrecognized product IDs will be skipped.
</Warning>

<Steps>
  <Step title="Download Sample CSV">
    Click **Download sample CSV** to see the expected column format for updates
  </Step>

  <Step title="Prepare Your Update File">
    Include the `product_id` column along with any fields you want to update
  </Step>

  <Step title="Upload and Update">
    Upload the `.csv` file (up to **15 MB**) and click **Update** to apply changes
  </Step>
</Steps>

## Deleting Products

Click the **delete icon** (trash) in the **Actions** column to remove a product from the catalogue.

<Warning>
  Deleting a product is permanent and cannot be undone. Products that have already been tagged in content may show as unavailable after deletion.
</Warning>

You can also select multiple products using the checkboxes in the leftmost column for batch operations.

### Product Tagging in Posts

You can tag products from the Product Catalogue directly in post content by typing `@` followed by the product name, then switching to the **Tag product** tab in the dropdown. Tagged products appear as interactive links in the post and display with thumbnails and pricing below the content.

For the full product tagging workflow, screenshots, and guidelines, see [Tagging Products in Posts](/analytics-and-moderation/console/social-management/social-management/posts#tagging-products-in-posts) in the Post Management documentation.

## Filtering and Searching

The Product Catalogue provides several ways to find specific products:

| Feature              | Description                                                                                |
| -------------------- | ------------------------------------------------------------------------------------------ |
| **Search by name**   | Type in the search field to filter products by product name                                |
| **Filter by status** | Use the status dropdown to show only `Active` or `Archived` products                       |
| **Sort by column**   | Click sortable column headers (Product name, Created at, Last updated) to reorder the list |

## Best Practices

<AccordionGroup>
  <Accordion title="Product ID Conventions" icon="key">
    * Use a consistent naming scheme for product IDs (e.g., `SKU-001`, `prod-category-name`)
    * Product IDs cannot be changed after creation, so plan your ID structure carefully
    * Keep IDs alphanumeric and under 100 characters
  </Accordion>

  <Accordion title="Bulk Operations" icon="layer-group">
    * Use the **Import** feature for initial catalogue setup with many products
    * Use the **Update** feature for ongoing maintenance and price/status changes
    * Always download and review the **sample CSV** before preparing your data
    * Validate your CSV before uploading to minimize errors
  </Accordion>

  <Accordion title="Image Guidelines" icon="image">
    * Use a **1:1 aspect ratio** for consistent thumbnail display
    * Keep images under **10 MB** for file uploads
    * Use high-quality images that clearly represent the product
    * Provide image URLs from reliable, fast-loading CDNs when using the URL method
  </Accordion>

  <Accordion title="Status Management" icon="toggle-on">
    * Set seasonal or discontinued products to **Archived** rather than deleting them
    * Use the status filter to quickly audit active vs. archived products
    * Archived products are retained in the catalogue but hidden from content tagging
  </Accordion>
</AccordionGroup>

## Related Topics

<CardGroup cols={3}>
  <Card title="Social Management" href="/analytics-and-moderation/console/social-management/communities" icon="users">
    Manage communities where products can be tagged in content
  </Card>

  <Card title="Events Management" href="/analytics-and-moderation/console/management/events-management" icon="calendar">
    Create and manage events alongside product promotions
  </Card>

  <Card title="Console Overview" href="/analytics-and-moderation/console/overview" icon="gauge">
    Learn about all Console features and administration capabilities
  </Card>
</CardGroup>
