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

# Catalog Management

> Create, publish, fork, and merge catalogs for structured product content workflows.

## Creating a catalog

Every product in Alana Shopping lives inside a catalog. Create one to start organizing your products:

```bash theme={null}
curl -X POST "https://app.alana.shopping/api/workspace/{workspaceId}/catalogs" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Spring 2026",
    "description": "Seasonal collection for Spring 2026"
  }'
```

## Publishing workflow

The recommended workflow for managing product content follows a **fork-edit-merge** pattern:

```mermaid theme={null}
graph TD
    A["Main Catalog (Published)"] -->|fork| B["Working Copy"]
    B -->|add products| C["Edit Content"]
    C -->|AI enhance| D["Optimize"]
    D -->|review scores| E["QA Check"]
    E -->|merge| A
```

### Publish a catalog

```bash theme={null}
curl -X POST ".../catalogs/{catalogId}/publish" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

Once published, the catalog's products appear in the public feed at `/api/catalog/products`.

### Fork for editing

```bash theme={null}
curl -X POST ".../catalogs/{catalogId}/fork" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"name": "Spring 2026 — QA Review"}'
```

### Merge changes back

```bash theme={null}
curl -X POST ".../catalogs/{catalogId}/merge" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"targetCatalogId": "PARENT_CATALOG_ID"}'
```

## Batch actions

Run pipeline stages in bulk from the catalog view or via API:

* **Normalize (Silver)** — field mapping, duplicate detection, image URL validation for a selection or entire catalog
* **Analyze (Gold)** — optimization scoring across 7 rubric stages, produces score + gaps list per product

```bash theme={null}
# Batch Silver — normalize entire catalog
curl -X POST ".../workspace/{workspaceId}/catalogs/{catalogId}/batch/silver" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"scope": "all"}'

# Batch Gold — score entire catalog
curl -X POST ".../workspace/{workspaceId}/catalogs/{catalogId}/batch/gold" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"scope": "all"}'
```

See [Batch Actions](/guides/batch-actions) and the [Pipeline API](/api-reference/pipeline/overview) for full reference.

## Pipeline settings

Customize how Silver and Gold process your products:

* **Silver field mappings** — map source column names to Alana schema fields
* **Gold scoring weights** — adjust weights per rubric stage (identity, content, media, etc.)
* **Auto-trigger** — automatically run Silver after Bronze, or Gold after Silver

See [Pipeline Settings](/guides/pipeline-settings) for the full configuration guide.

## Score evolution tracking

The optimization score is tracked over time in `score_history`. Use this to measure the impact of content improvements — before and after running AI enhancement or batch normalize.

## Catalog statistics

Each catalog tracks key metrics that help you assess content quality:

* **Total products** — how many products are in the catalog
* **Feed-ready count** — products that pass all validation rules
* **Average optimization score** — mean quality score across all products
* **Score distribution** — breakdown by excellent/good/warning/poor bands
* **Last published** — when the catalog was last pushed live

<Tip>
  Aim for 100% feed-ready products before publishing. Run Batch Gold first to identify which products need the most attention.
</Tip>