Products

Products are the items or services customers can browse in WhatsApp, receive in conversation, or add to cart. Each product lives at the organization level and can be assigned to one or more catalogs.

Product Types

• Physical: shipped goods. Enables auto-collect shipping address on checkout.
• Digital: downloadable or online delivery. Shipping disabled automatically.
• Service: bookable time-based service. Linked to a service schedule for availability and appointment management.
• Subscription: recurring product or plan. Shipping disabled automatically.

Required and Recommended Fields

• Product name: required visible title.
• Price: required and must be zero or greater.
• SKU / Product Code: used as the retailer ID and as the upsert key during bulk import.

• Primary image: strongly recommended for WhatsApp catalog quality and Meta eligibility.
• Brand: required by Meta for WhatsApp product messages.

Pricing & Inventory

• Price: base selling price.
• Compare-at price: original price before a discount. Socialone auto-calculates and shows the discount percentage.
• Sale price + date range: time-limited promotional price with a start and end date.
• Stock quantity: leave empty for unlimited stock. Setting quantity to zero automatically marks availability as out of stock.
• Availability: in stock, out of stock, preorder, or discontinued. Can be overridden per catalog independently of this global setting.

Images

• Primary image: main product photo shown in catalog and product messages.
• Additional images: up to 20 images per product. Upload by drag-and-drop, direct URL, or from your Organization Gallery.

Product Variants

Variants are separate products grouped under a shared item group ID. Use the variant generator to create all size/color/material combinations at once:

1. Enter comma-separated values for each attribute (e.g., Size: S,M,L,XL — Color: Red,Blue,Black).
2. Socialone generates all combinations (e.g., S-Red, S-Blue, M-Red, …).
3. Each combination becomes an individual product with its own SKU, price, stock, and image.
4. All variants share the same item group ID, which groups them in Meta catalogs and product messages.

Supported variant attributes: Size, Color, Material, Gender, Age group.

Classification & Meta Fields

These fields improve catalog quality scoring on Meta and enable ad targeting:

• Google product category: hierarchical taxonomy (e.g., Clothing > Activewear > Yoga Pants). Used for Meta feed mapping.
• Facebook product category: Meta-specific category tree.
• GTIN: barcode / ISBN / UPC identifier.
• MPN: manufacturer part number.
• Product condition: new, refurbished, or used.
• Custom labels 0–4: free-form labels used to segment products in Meta ad campaigns.

WhatsApp Compliance Fields

• WA compliance category: DEFAULT or COUNTRY_ORIGIN_EXEMPT. Digital, service, and subscription products may be exempt from origin requirements.
• Country of origin: required for physical products sold on WhatsApp.
• Importer details: name, address, postal code, and zone code of the importing entity. Required when no catalog is linked to the WABA and goods are non-exempt.

Metadata & Descriptions

• Description: plain-text short description shown on Meta.
• Rich text description: HTML-formatted long description for detailed product pages.
• Specifications: unlimited key-value pairs (e.g., Weight: 500g, Voltage: 220V).
• Size chart: custom header columns and rows (e.g., size measurements for apparel).
• Care instructions: washing or handling notes.
• What's in the box: included items list.
• Tags: comma-separated internal tags for search and filtering.

Bulk Import

Import products in bulk using a CSV file or a ZIP archive (CSV + images):

• CSV import: download the sample template from the importer. Required columns include name, price, and SKU. SKU is the upsert key — existing products with the same SKU are updated.
• ZIP import: bundle the CSV with product images in one archive. Image filenames in the CSV must match the filenames inside the ZIP.
• Catalog assignment: select which catalogs to assign all imported products to.
• Progress tracking: the import job shows real-time status (pending → processing → completed / failed) with a row-level error log listing the row number, SKU, and error reason for failed rows.
• Up to 20 images per product are supported in the ZIP import.

Catalog Assignment

• A product can belong to multiple catalogs simultaneously.
• Each assignment stores an independent active flag, availability override, and sort order.
• Saving a product automatically pushes it to all active catalog mappings on Meta.

Sending a Product in Chat

Products can be sent directly to a customer from the inbox without the customer needing to browse the catalog themselves:

• Single product card: opens a product picker in the message composer. The customer sees the product image, name, price, and an Add to Cart button.
• Multi-product message: send up to 30 products from a catalog as a scrollable product list. Customers can add multiple items to a cart in one message.
• Catalog browse button: sends a message with a button that opens the full catalog inside WhatsApp for the customer to browse and add to cart.

All three require a product to be active in a catalog linked to the WhatsApp account you are messaging from.

Where Product Data Is Used Beyond Commerce

Product and catalog data isn't limited to the OMS. It feeds into other parts of Socialone:

• SIA Auto-Replies (Full mode): when a customer asks about a product — price, stock, variants — SIA can reference your catalog data to answer accurately. See Auto-Replies with SIA.
• Post Agent: when generating product-focused social posts, Post Agent draws on your catalog to write accurate captions — product names, pricing, and descriptions. See Post Agent Overview.

Related Docs

• Catalogs
• OMS Settings
• Orders