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

# Enrichment

> Let AI suggest improvements to your product data, review each proposal, and apply approved changes directly to Shopify.

<Info>
  Enrichment is available on paid plans (Starter and Growth). Your Shopify store must be connected before you can apply changes. See [Integrations](/setup/integrations).
</Info>

**Enrichment** is Citd's AI-powered product-data improvement workflow. It reads your synced Shopify catalog, spots the gaps that hurt your AI-search visibility, and proposes specific edits — better titles, richer descriptions, structured tags, SEO fields, metafields, image alt text, and more. You review every suggestion before anything touches your store.

## Why it matters

AI assistants like ChatGPT and Gemini pull product data from your live store. Thin titles, missing metafields, and vague descriptions are the fastest path to not being recommended. Enrichment closes those gaps systematically, tracks whether the changes actually moved your visibility score, and lets you undo anything within 90 days.

## How it connects to the rest of Citd

Enrichment sits between [Actions](/features/actions) and your Shopify catalog. When the Actions queue surfaces a catalog or content recommendation, Citd generates an enrichment batch pre-loaded with AI proposals for that action. You can also open Enrichment directly from the [Products](/features/products) page for any individual product.

```mermaid theme={null}
flowchart LR
  A[Actions queue] --> B[AI generates proposals]
  B --> C[You review and approve or dismiss]
  C --> D[Apply to Shopify]
  D --> E[Citd measures impact]
  E --> F{Satisfied?}
  F -- No --> G[Roll back]
  F -- Yes --> H[Done]
```

## Proposal types

Each enrichment proposal targets one specific field. The proposal types Citd can generate are:

| Proposal type           | What it changes                                                  |
| ----------------------- | ---------------------------------------------------------------- |
| **Rewrite title**       | Product title — clearer, more keyword-aligned copy               |
| **Rewrite description** | Product body HTML — richer, attribute-focused description        |
| **Add structured tags** | Shopify tags — adds structured, searchable tag values            |
| **Fill SEO fields**     | SEO title and meta description for the product page              |
| **Normalize taxonomy**  | Product type field — aligns it with your store's taxonomy        |
| **Add metafield**       | Shopify metafields — fills in or creates custom metafield values |
| **Improve alt text**    | Image alt text — descriptive text for product images             |

Each proposal also carries a **risk level** (low, medium, or high) so you can prioritize confident changes and take more care with higher-stakes edits.

## Proposal statuses

| Status             | Meaning                                      |
| ------------------ | -------------------------------------------- |
| **Pending review** | Waiting for your approval or dismissal       |
| **Approved**       | You approved it; ready to apply              |
| **Applied**        | Pushed to Shopify successfully               |
| **Rolled back**    | Reverted to the previous value               |
| **Failed**         | Apply attempt did not succeed; you can retry |
| **Dismissed**      | You chose not to apply this proposal         |

## The review workflow

<Steps>
  <Step title="Open Enrichment from Actions or Products">
    In the Actions queue, click **Enrich** on any catalog or content action. Citd creates a batch of proposals for that action. You can also start from a specific product on the Products page.
  </Step>

  <Step title="Review proposals">
    Each proposal shows you the current value, the AI-suggested replacement, the reasoning behind the change, and the risk level. Read both sides before deciding.
  </Step>

  <Step title="Approve or dismiss each proposal">
    Click **Approve** to queue a proposal for apply, or **Dismiss** to skip it. You can also bulk-approve or bulk-dismiss the whole batch.
  </Step>

  <Step title="Apply approved proposals to Shopify">
    Once you have reviewed the batch, click **Apply**. Citd writes each approved change to your Shopify store via the API. The proposal status moves from **Approved** to **Applied**.

    <Warning>
      Applying changes requires Shopify to be connected with `write_products` access. If the scope is missing, the apply button stays blocked until the permission is granted. See [Integrations](/setup/integrations) to reconnect.
    </Warning>
  </Step>

  <Step title="Citd measures the impact">
    After changes are applied, Citd schedules a tracking run to compare your visibility metrics before and after. The impact result appears on each batch — look for the verdict and the before/after delta.
  </Step>

  <Step title="Undo if needed">
    Changed your mind? Click **Undo** on any applied change within 90 days. Citd writes the original value back to Shopify and marks the change as **Rolled back**. Undo is blocked if Shopify is disconnected or the write scope has been removed.
  </Step>
</Steps>

## Batches

Proposals are grouped into **batches**. A batch represents one round of AI analysis tied to one or more actions. The Change history panel lists every batch you have applied, sorted by the most recent update. Click any batch to see its individual changes, their before/after values, and the impact result for the batch.

<Tip>
  Citd reuses an existing batch if you request enrichment for the same action and product combination again. You will not generate duplicate proposals for the same gap.
</Tip>

## Plan limits

Enrichment is available on Starter and Growth plans. Each billing period has a product-update limit based on your plan. If you hit the limit, apply will be blocked until the next billing period or you upgrade.

<Note>
  The enrichment dashboard is labeled **Change history** in the UI. It shows all changes that have been applied to your store, so you always have a full audit trail.
</Note>

## Next steps

<CardGroup cols={2}>
  <Card title="Actions" icon="list-checks" href="/features/actions">
    Find the highest-priority catalog and content fixes to feed into Enrichment.
  </Card>

  <Card title="Products" icon="package" href="/features/products">
    Inspect the exact products and readiness issues before generating proposals.
  </Card>

  <Card title="Analysis" icon="chart-bar" href="/features/analysis">
    Understand why your Readiness score is low before deciding what to enrich.
  </Card>

  <Card title="Integrations" icon="plug" href="/setup/integrations">
    Connect Shopify to enable apply and rollback.
  </Card>
</CardGroup>