Overview
Products are the core data unit in Alana Shopping. Each product lives inside a catalog and contains the content, pricing, and metadata needed for e-commerce feeds.Product properties
| Field | Type | Description |
|---|---|---|
title | string | Product display name |
description | string | Full product description |
brand | string | Brand name |
categoryPath | string | Category hierarchy (e.g. “Apparel > T-Shirts > Men’s”) |
price | number | Current selling price |
originalPrice | number | Original price (for showing discounts) |
currency | string | ISO 4217 currency code |
primaryImageUrl | string | Main product image URL |
sku | string | Stock-keeping unit |
gtin | string | Global Trade Item Number (EAN/UPC) |
availability | string | Stock status |
attributes | object | Flexible key-value attributes (color, size, material, etc.) |
Optimization score
Every product receives an optimization score from 0 to 100, calculated by the score engine. The score considers:- Title quality (length, keyword density, readability)
- Description completeness and richness
- Image availability and resolution
- Required field population (SKU, GTIN, price)
- Category path depth
- Attribute completeness
Score ranges
| Range | Rating | Color |
|---|---|---|
| 90–100 | Excellent | Green |
| 70–89 | Good | Sky blue |
| 50–69 | Needs work | Amber |
| 0–49 | Poor | Red |
Feed readiness
A product is feed-ready when all required fields for its target feed format are populated. ThefeedReady boolean flag is automatically computed and indicates whether the product can be exported to Google Shopping, Meta Commerce, or other channels.
Bulk import
Products can be imported in bulk from CSV or Excel files via the import endpoint. The importer:- Validates headers against expected schema
- Maps columns to product fields
- Creates products in batch
- Returns a summary with success/error counts