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

# Your First Enrichment

> Generate AI-powered content for your products in minutes, from selecting products to reviewing results.

This guide walks you through running your first enrichment: selecting products, choosing attributes, generating content with AI, and reviewing the results. By the end, you'll have AI-generated product content ready to approve and push to your store.

<Note>
  If you're still iterating on the wording, tone, or behavior of an agent, do that work in the [Agent Sandbox](/features/sandbox) first, not in a full enrichment job. The sandbox runs your agent on real products, shows the AI's reasoning, and lets you refine the prompt through chat with undo/redo and version history. Enrichment is for applying a tested agent across your catalog, not for testing.
</Note>

## Before you begin

To run an enrichment, you need:

1. **Products imported**: Connect an integration like [Shopify](/get-started/connecting-shopify) or import via CSV
2. **A taxonomy with attributes**: Products organized into categories with [attributes configured](/features/attributes)
3. **Agents linked to attributes**: At least one [AI agent](/features/ai-agents) linked to an attribute on your categories

If you're just getting started and Cernel has suggested attributes for your categories, you can apply those recommendations directly from the Dashboard.

## Step-by-step guide

<Steps>
  <Step title="Navigate to your products">
    In the sidebar under **Catalog**, expand the taxonomy tree and click on a category to view its products. You'll see a product table with columns for each configured attribute.

    <Frame>
      <img src="https://mintcdn.com/cernel-e5adbeb5/8s8TTk4ITllBQt38/images/first-enrichment/product-table.png?fit=max&auto=format&n=8s8TTk4ITllBQt38&q=85&s=efbd8cce5b3011dcc45612b9b007ae2a" alt="The product table showing a list of products in a selected category, with columns for product name, image, and attribute values, with most attribute columns empty, waiting for enrichment" width="2880" height="1800" data-path="images/first-enrichment/product-table.png" />
    </Frame>
  </Step>

  <Step title="Select products to enrich">
    Use the checkboxes to select the products you want to enrich. You can select individual products or use the header checkbox to select all products in the current view.

    <Frame>
      <img src="https://mintcdn.com/cernel-e5adbeb5/weDuKoplcfWJC191/images/first-enrichment/select-products.png?fit=max&auto=format&n=weDuKoplcfWJC191&q=85&s=2335ef6cd251c60066daedd1c3123fc8" alt="The product table with several product rows selected via checkboxes, and a toolbar appearing at the top showing '12 selected' with action buttons including 'Enrich Products'" width="2880" height="1800" data-path="images/first-enrichment/select-products.png" />
    </Frame>

    <Tip>
      Refine your agent in the [Agent Sandbox](/features/sandbox) before running enrichment. The sandbox is the right place to test prompt wording and iterate on output quality. Enrichment is for applying an agent you're already happy with. Once the sandbox results look good, you can comfortably enrich any number of products, from a single category to your whole catalog.
    </Tip>
  </Step>

  <Step title="Open the enrichment modal">
    Click **Enrich Products** in the toolbar. The enrichment modal opens, showing the available attributes and enabled languages for your workspace.
  </Step>

  <Step title="Select attributes and start">
    Check the attributes you want AI to generate. You can search for specific attributes using the search box. Once you've selected your attributes, click **Start Enrichment**.

    A confirmation notification appears: "Enrichment job started for X products with Y attributes."
  </Step>

  <Step title="Monitor progress on the Dashboard">
    Go to the **Dashboard** (click the Cernel logo or the Dashboard link in the sidebar). Your enrichment job appears as a card showing:

    * The job name and type (e.g., "Product Enrichment | 8 products")
    * A progress indicator showing how many products have been processed
    * The status: **Pending**, **Running**, or **Completed**
    * Product thumbnails and attribute badges
  </Step>

  <Step title="Review the results">
    Once the job completes, click on the job card to open the review view. You'll see each product with its AI-generated values displayed alongside the original data.

    For each attribute value, you can:

    * **Approve**: accept the generated content as-is
    * **Edit**: make changes before approving
    * **Reject**: discard the generated content

    You can also view the **Agent Reasoning** to understand why the AI generated specific content.

    <Frame>
      <img src="https://mintcdn.com/cernel-e5adbeb5/weDuKoplcfWJC191/images/first-enrichment/review-values.png?fit=max&auto=format&n=weDuKoplcfWJC191&q=85&s=e0d802483db2d8664ee62137f91f2cf9" alt="The job review view showing a product with AI-generated values for Meta Title, Description, and Materials. Each value has an 'AI Enriched' source badge and Approve/Reject buttons. The Agent Reasoning panel is expanded showing the AI's logic" width="2880" height="1800" data-path="images/first-enrichment/review-values.png" />
    </Frame>

    <Tip>
      If the generated content doesn't match your expectations, open the agent and iterate in the [Agent Sandbox](/features/sandbox); that's where refinement belongs. Use the agent chat to rewrite the prompt, compare versions with undo/redo, and re-test on real products until the output is right. Only once the sandbox looks good should you re-run enrichment on your catalog.
    </Tip>

    <Check>
      You've completed your first enrichment. Approved content is ready to sync to your connected integrations. If you have **Approve Before Push** enabled in **Settings > Platform**, you'll need to approve each item before it pushes to your store.
    </Check>
  </Step>
</Steps>

## Frequently asked questions

<AccordionGroup>
  <Accordion title="How long does enrichment take?">
    Enrichment runs in the background, so you can keep working while it processes. Most products finish in under a minute. Text attributes are the quickest, while attributes that generate images or pull in external data can take a few minutes per product.

    Adding more attributes to an enrichment does not make it slower. Cernel works on all selected attributes for a product at the same time, so the total wait is only as long as the slowest one.

    Small batches typically complete in seconds. Larger runs across hundreds of products may take several minutes. If you have multiple enrichment jobs running at once, they may take a little longer as Cernel shares capacity fairly across your workspace. You can track progress from the Dashboard at any time.
  </Accordion>

  <Accordion title="Can I cancel a running enrichment?">
    Once an enrichment job has started, it runs to completion. If you realize the results aren't what you expected, you can reject the generated values and re-run enrichment after adjusting your agent prompts.
  </Accordion>

  <Accordion title="What does 'Approve Before Push' do?">
    When enabled in **Settings > Platform**, this setting requires you to explicitly approve every generated value before it syncs to your connected integrations. This gives you full control over what gets published. Without it, approved values sync automatically.
  </Accordion>

  <Accordion title="Why are some attributes not showing in the enrichment modal?">
    Only attributes with a linked AI agent appear in the enrichment modal. If an attribute is missing, go to the category's attribute configuration and link an agent to it. See [AI Agents](/features/ai-agents) for how to create and link agents.
  </Accordion>
</AccordionGroup>

## What's next

<CardGroup cols={2}>
  <Card title="AI Agents" icon="arrow-right" href="/features/ai-agents">
    Refine your agent prompts and create new agents for different content types.
  </Card>

  <Card title="Attributes" icon="arrow-right" href="/features/attributes">
    Configure more attribute types and understand how they work across your taxonomy.
  </Card>
</CardGroup>
