Product Catalog

Browse, search, and manage your product catalog

Overview

The Product Catalog page displays all products and SKUs synced from your connected platforms. You can search, filter, and view detailed pricing information for each product.

Access: Navigate to Catalog in the project sidebar, or visit /p/[your-project]/catalog

Catalog Interface

Main View

The catalog displays products in a table format with the following columns:

•
Product Code: Unique identifier for the product
•
Product Name: Display name of the product
•
SKUs: Number of variants/SKUs for each product
•
Prices: Current pricing information across all currencies

Expandable Product Details

Click on any product row to expand and view:

→SKU List: All variants with their codes
→Multi-Currency Pricing: Current prices in all configured currencies
→Price History: Recent price changes and trends

Search & Filter

Search Functionality

Use the search bar at the top of the catalog to find products by:

•Product Code: Exact or partial match
•Product Name: Case-insensitive text search
•SKU Code: Search within product variants

Example: Search for "shirt" to find all products with "shirt" in their name, or "SKU-123" to find specific variants.

Currency Filter

Filter products by specific currencies to:

•View pricing in a specific market (USD, EUR, GBP, etc.)
•Show only products with prices in selected currency
•Compare prices across different regions

Pagination

For catalogs with many products, the catalog view uses pagination to improve performance:

•Default page size: 20 products per page
•Use the navigation controls at the bottom to move between pages
•Search and filter settings persist across pages

Working with Products

Viewing Product Details

1.Click on any product row to expand it
2.View all SKUs and their individual pricing
3.See multi-currency prices formatted with currency symbols
4.Click again to collapse the details

Quick Actions

From the catalog view, you can:

→Create Price Changes: Navigate to Price Changes to create manual adjustments
→Create Pricing Rules: Set up automated rules targeting specific products
→View in Platform: Link to the product in your connected platform (coming soon)

Catalog Sync

Automatic Synchronization

Your catalog automatically syncs with connected platforms:

•Initial Import: When you first connect a platform, all products are imported
•Periodic Sync: Regular updates keep your catalog current
•Real-time Updates: Changes in your platform appear in the catalog (webhook-based)

Manual Refresh

To manually trigger a catalog sync:

1.Go to Integrations page
2.Select your platform (Shopify or Amazon)
3.Click "Sync Now" button
4.Monitor sync progress and check for errors

Understanding Pricing Display

Price Formatting

Prices in the catalog are displayed with the following conventions:

•
Currency Symbol: Automatically displayed based on currency code (e.g., $, €, £)
•
Decimal Precision: 2 decimal places for most currencies
•
Zero-decimal Currencies: Some currencies (like JPY) display without decimals
•
Storage Format: Prices are stored in cents/smallest units (e.g., $10.00 = 1000 cents)

Example:
• USD: $29.99 (stored as 2999)
• EUR: €49.00 (stored as 4900)
• JPY: ¥3,000 (stored as 3000)

Tips & Best Practices

💡

Use Search Effectively

Start with broad searches and refine as needed. Product codes are faster for exact matches.

💡

Monitor Sync Status

Check the Integrations page regularly to ensure your catalog stays in sync with your platforms.

💡

Multi-Currency Management

Use currency filters to review pricing strategy in specific markets before making bulk changes.

💡

Combine with Rules

After browsing the catalog, use Pricing Rules to automate changes for product groups.

API Reference

The Catalog API provides programmatic access to your product catalog. All endpoints require authentication via Bearer token.

GET /api/v1/catalog

Get product catalog for a project with all SKUs and pricing information

QUERY PARAMETERS:

• project: Project slug (required)
• productCode: Filter by specific product code (optional)

Response Example

{
  "products": [
    {
      "code": "PROD-001",
      "name": "Example Product",
      "skus": [
        {
          "code": "SKU-001",
          "prices": [
            {
              "currency": "USD",
              "amount": 2999  // in cents ($29.99)
            },
            {
              "currency": "EUR",
              "amount": 2799  // in cents (€27.99)
            }
          ]
        }
      ]
    }
  ]
}

Usage Notes

•Prices are returned in cents (or smallest currency unit) as integers
•Multi-currency products include price objects for each configured currency
•Use the productCode parameter to fetch details for a specific product
•Catalog data reflects the latest sync from connected platforms