> ## Documentation Index
> Fetch the complete documentation index at: https://social-b97141fb-feat-user-history-moderation-detail.mintlify.site/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

> [!NOTE]
>
> The Product Catalogue in the social.plus Console allows administrators to manage a centralized product database. Products added here can be tagged in **posts** — in the post text or directly on image and video attachments — and in **livestream posts**, enabling social commerce experiences and product discovery within your application.

> **Product Listing**
>
> View, search, and filter all products in a comprehensive table view

> **Add Products**
>
> Create individual products with details, pricing, images, and URLs

> **Bulk Import**
>
> Import multiple products at once via CSV file upload

> **Bulk Update**
>
> Update existing product details in bulk using CSV files

> **Status Management**
>
> Control product visibility with Active and Archived statuses

> **Product Tagging**
>
> Enable products to be tagged in community content for social commerce

## 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 and livestream posts.

![Product Catalogue Dashboard](https://mintcdn.com/social-b97141fb-feat-user-history-moderation-detail/EuQgtDswnsuEu3tu/images/analytics-and-moderation/console/product-management/product-catalogue-list.png?fit=max\&auto=format\&n=EuQgtDswnsuEu3tu\&q=85\&s=50b665b5d043b053b2a29fe4c0ab1729)

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

**1. Access Product Catalogue**

Navigate to **Product catalogue** in the left sidebar of your social.plus Console

**2. Add Your First Product**

Click **+ Add product** to create a product with an ID, name, URL, price, and thumbnail image

**3. Import Products in Bulk**

Use the **Import** button to upload a CSV file with multiple products at once

**4. Manage Product Status**

Set products as **Active** to make them available for tagging, or **Archived** to hide them from content tagging

## Adding a Product

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

![Add Product Form](https://mintcdn.com/social-b97141fb-feat-user-history-moderation-detail/EuQgtDswnsuEu3tu/images/analytics-and-moderation/console/product-management/add-product.png?fit=max\&auto=format\&n=EuQgtDswnsuEu3tu\&q=85\&s=d795587305c867a6445fbaca7549eb3d)

### Product Details

> **Product ID**
>
> **Required** — A unique alphanumeric identifier for the product (max 100 characters). This ID cannot be changed after creation.
>
> **Example:** `SKU-12345`, `prod-widget-blue`

> **Status**
>
> **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

> **Product Name**
>
> **Required** — The display name shown when the product is tagged in content (max 200 characters). Choose a clear, recognizable name for your users.

> **Product URL**
>
> **Required** — The URL linking to the product page. The `https://` prefix is automatically applied.
>
> **Example:** `example.com/products/widget-blue`

> **Price**
>
> **Optional** — The product price with a selectable currency. The default currency is remembered from your last selection.

> **Product Images**
>
> **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**.

## Editing a Product

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

![Edit Product Form](https://mintcdn.com/social-b97141fb-feat-user-history-moderation-detail/EuQgtDswnsuEu3tu/images/analytics-and-moderation/console/product-management/edit-product.png?fit=max\&auto=format\&n=EuQgtDswnsuEu3tu\&q=85\&s=38e6cebc27574af1c59ac524cc6a6c3d)

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.

![Import Product Dialog](https://mintcdn.com/social-b97141fb-feat-user-history-moderation-detail/EuQgtDswnsuEu3tu/images/analytics-and-moderation/console/product-management/import-products.png?fit=max\&auto=format\&n=EuQgtDswnsuEu3tu\&q=85\&s=74587542b5999e918613f7400a198613)

**1. Download Sample CSV**

Click **Download sample CSV** to get the required file format and column structure

**2. 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

**3. 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**

**4. Start Import**

Click **Import** to begin processing. A status notification will appear showing the import progress and summary

> [!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.

## Updating Products via CSV

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

![Update Product Dialog](https://mintcdn.com/social-b97141fb-feat-user-history-moderation-detail/EuQgtDswnsuEu3tu/images/analytics-and-moderation/console/product-management/update-products.png?fit=max\&auto=format\&n=EuQgtDswnsuEu3tu\&q=85\&s=3759ba38f5b00438c28473b00c5f20e0)

> [!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.

**1. Download Sample CSV**

Click **Download sample CSV** to see the expected column format for updates

**2. Prepare Your Update File**

Include the `product_id` column along with any fields you want to update

**3. Upload and Update**

Upload the `.csv` file (up to **15 MB**) and click **Update** to apply changes

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

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

> **Product ID Conventions**
>
> * 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

> **Bulk Operations**
>
> * 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

> **Image Guidelines**
>
> * 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

> **Status Management**
>
> * 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

## Related Topics

> **[Social Management](/analytics-and-moderation/console/social-management/communities)**
>
> Manage communities where products can be tagged in content

> **[Events Management](/analytics-and-moderation/console/management/events-management)**
>
> Create and manage events alongside product promotions

> **[Console Overview](/analytics-and-moderation/console/overview)**
>
> Learn about all Console features and administration capabilities


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.