> This page is for Developer.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.bigcommerce.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.bigcommerce.com/_mcp/server.

# How an enrichment works

> The steps of an enrichment from selecting products to applying results, how long it takes, and how to track enrichments on the Enrichments page.

An enrichment takes a set of products, generates content for them, and holds the results for your review until you apply them. This page covers the flow end to end. The pages linked from each step cover the decisions within it.

![Diagram of the five steps of an enrichment: select up to 250 products and choose Enrich; set up the name, purpose, brand voice, context, keywords, and thresholds; run, which can't be stopped and takes up to 24 hours; review scores and edit, clear, restore, retry, or re-run; and apply selected or all results, which overwrites existing values with no undo. Status moves from In progress to Generated to Completed.](/_fern-files/bigcommerce.docs.buildwithfern.com/a72960ff14a8147e2bbc109ee51944a62bf93748fc44bdd63f82320d60ab578f/docs/assets/catalog-enrichment/enrichment-flow.svg)

## 1. Select products

Go to **Products › All products**, select the products you want, and choose **Enrich** from the actions above the list.

![Two products selected on the product list with the Enrich action highlighted.](/_fern-img/e5cf091340234a919a68b28e28e0c49fd9cd87642b895b7f73bf1fd8e8acf5b9.webp)

An enrichment includes up to 250 products. Products selected beyond the first 250 are left out. Which products to group together is covered in [Grouping products into enrichments](/developer/docs/ai-tools/catalog-enrichment/before-you-enrich/planning-batches).

## 2. Set up the enrichment

The create panel walks through four steps: **Settings**, **Brand**, **Thresholds**, and **Confirm**.

* **Settings** — the run name and the purpose of the enrichment. The run name defaults to the time you chose Enrich; you can replace it with something more descriptive.
* **Brand** — brand voice, additional context, and search keywords. See [Writing brand guidelines](/developer/docs/ai-tools/catalog-enrichment/inputs/brand-guidelines) and [Purpose, keywords, and context](/developer/docs/ai-tools/catalog-enrichment/inputs/purpose-keywords-context).
* **Thresholds** — the minimum score for each quality factor. See [Understanding quality scores](/developer/docs/ai-tools/catalog-enrichment/review/quality-scores).
* **Confirm** — a final check before the enrichment starts.

## 3. Run it

Start the enrichment from the final step. Before it starts you are reminded that enrichment supports English only and cannot be stopped once started.

![Confirmation dialog stating that enrichment supports English only, can't be stopped once started, and that generated values should be reviewed before applying, with the Run enrichment button.](/_fern-img/db2985450e55aa6455954b78ebdeba8a88ea60b2b58d68694af7c9efc6330a31.webp)

If you have fewer entitlements left than the products selected, the enrichment can't start. Reduce the selection or [buy more entitlements](/developer/docs/ai-tools/catalog-enrichment/before-you-enrich/entitlements).

An enrichment can take up to 24 hours, depending on the number of products and the complexity of your brand guidelines. You can work elsewhere in the control panel while it runs, and you receive a control panel notification when results are ready.

## 4. Review the results

Open **Products › Enrichments** and select the enrichment to review it. Results are scored, can be edited, and can be retried or re-run. See [Reviewing at scale](/developer/docs/ai-tools/catalog-enrichment/review/reviewing-at-scale) and [Deciding what to change](/developer/docs/ai-tools/catalog-enrichment/review/what-to-change).

## 5. Apply

Select the products to update and choose **Apply selected**, or **Apply all**. If you plan to measure impact, capture a baseline before you apply. See [Capture a baseline first](/developer/docs/ai-tools/catalog-enrichment/before-you-enrich/planning-batches#capture-a-baseline-first).

> **Applying overwrites your catalog data and cannot be undone**
>
> Applying replaces the existing value in each field. There is no undo. Before your first apply, back up your catalog: select the products on **Products › All products** and choose **Export**. Then review content before you commit it.

## Tracking your enrichments

**Products › Enrichments** lists every enrichment you have run, with the number of products, the fields enriched, its status, and when it was created. The top of the page shows how many enrichments you have run, the total products enriched, and how many entitlements you have left.

![The Enrichments page showing a total enrichments count and a total products enriched count, with the remaining entitlements shown beside the page title.](/_fern-img/cf289aa362e60077757e284f359ea3c842e8042ac9e6a7c50e62b395a2b6a66b.webp)

| Status          | Meaning                               |
| --------------- | ------------------------------------- |
| **In progress** | Content is being generated            |
| **Generated**   | Results are ready for review          |
| **Completed**   | Some or all results have been applied |

Select an enrichment to see its details, including a progress bar while it runs and the date results were applied once completed.

A generated enrichment is saved to your store, so you can review it over several sessions and apply it any time.

To give feedback on enrichment, choose **Give feedback on the data enrichment** from the **New** menu on the Enrichments page. For troubleshooting, contact BigCommerce support.