> For the complete documentation index, see [llms.txt](https://docs.foodcore.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.foodcore.io/ai-checks/run-check.md).

# Run an AI Check

Running an AI Check takes less than a minute. You pick a scope, choose a category, and FoodCore does the analysis. Results are saved so you can come back to them at any time.

## Before you start

Make sure you have enough credits. Each check costs between 1 and 3 credits depending on the scope you choose. You can check your balance at **AI Checks → Credits**. If you're running low, [top up your credits](https://docs.foodcore.io/ai-checks/credits.md) before you begin.

## Steps

**1. Go to AI Checks → + New Check**

You'll find AI Checks in the main navigation. Click **+ New Check** to open the check wizard.

**2. Choose your scope**

You have three options:

* **Single Recipe** — runs the selected check against one recipe. Costs 1 credit. Best for spot-checking a specific dish before it goes on the menu or onto a label.
* **Single Ingredient** — runs the check against one ingredient. Costs 1 credit. Useful when you've added a new supplier ingredient and want to verify its allergen or nutritional data.
* **Portfolio** — runs the check across all your recipes at once. Costs 3 credits. Best for a pre-launch review or a routine sweep before an inspection.

**3. Choose a check category**

Select the category that matches what you want to review:

| Category                         | What it checks                                                             |
| -------------------------------- | -------------------------------------------------------------------------- |
| Allergens                        | Missing declarations, hidden allergen risks, cross-contamination flags     |
| Dietary claims                   | Whether a recipe can legitimately carry a claim (vegan, gluten-free, etc.) |
| Labelling                        | PPDS compliance, mandatory fields, label formatting                        |
| Nutrition                        | Unusual macro values, missing data, calorie anomalies                      |
| Costing                          | Low margins, incomplete cost data, pricing anomalies                       |
| Recipe integrity                 | Missing quantities, inconsistent ingredients, step-level issues            |
| Food Safety *(Core only)*        | Gaps in HACCP plans, overdue corrective actions, monitoring data           |
| Admin & Operations *(Core only)* | Supplier records, staffing docs, site-level process risks                  |

If you're on an Essentials plan, the Food Safety and Admin & Operations categories show a **lock icon**. You can still see them in the list, but you'll need to upgrade to run them.

{% hint style="info" %}
📦 **Food Safety** and **Admin & Operations** checks are available on **FoodCore Core**. [Upgrade your plan](https://docs.foodcore.io/getting-started/essentials-vs-core.md) to access them.
{% endhint %}

**4. Run the check**

Click **Run Check**. FoodCore sends your data to the AI engine and processes the results. This typically takes a few seconds — occasionally up to 15 seconds for a Portfolio check across a large recipe library.

**5. Review your results**

Each item in the results list shows one of three statuses:

* **Pass ✓** — no issues found. Nothing to action here.
* **Warning ⚠** — something worth reviewing. Not necessarily wrong, but FoodCore has flagged it for your attention. Read the explanation to decide if action is needed.
* **Fail ✗** — a likely compliance or quality issue. FoodCore will explain what it found and suggest what to do about it.

Every result includes a plain-English explanation of why that status was assigned. For failures, you'll usually get a clear steer on what to fix and where in FoodCore to make the change.

## Saved results

Results are automatically saved to your AI Checks history. You can return to them at any time from the main AI Checks list — useful if you want to compare a check you ran before a recipe update with one you ran after.

Results are tied to a specific version of your data at the time the check ran. If you update a recipe, run a fresh check to get an up-to-date result.

## Tips for getting the most from AI Checks

* **Run a Portfolio allergen check** whenever you update your ingredient library — new suppliers sometimes introduce allergens you haven't flagged yet.
* **Run a Labelling check** before you print a new batch of labels, especially after updating a recipe.
* **Run a Food Safety check** (Core) a week before any scheduled inspection so you have time to address anything it surfaces.

## What's next

* [Buy top-up credits](https://docs.foodcore.io/ai-checks/credits.md)
* [AI Checks overview](https://docs.foodcore.io/ai-checks/ai-checks.md)
* [Essentials vs Core — plan comparison](https://docs.foodcore.io/getting-started/essentials-vs-core.md)
