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

# Recipes

> Tell Blue what to suggest when something happens in a chat, such as a task whenever someone reports a defect.

A recipe tells Blue what to suggest when a certain kind of message arrives. For example: "When someone reports a defect with a photo, suggest a task for the site supervisor, due in 2 days."

Chat admins and project admins set up recipes.

## How a recipe works

**1. Describe it**

Write what should happen, in plain words.

**2. Confirm it**

Blue shows the recipe back as one sentence, such as: "When someone here reports a defect, with a photo → suggest a task for Sam Lee, due 2 days after the message." If anything is unclear, such as two people with the same name, Blue asks before saving.

**3. Let it run**

When a message matches, Blue's suggestion comes filled in with the recipe's details. The sender or a chat admin confirms it, like any [suggestion](https://docs.on-site.io/blue/suggestions.md). If the message itself names a person or a date, that wins over the recipe.

## What a recipe can do

* Suggest a task or a form entry, and have Blue mention it in the chat.
* Respond to chat messages, or only to messages with a photo.

A recipe never acts on its own, and it can't do anything else, such as send an email.

## Limits

* Recipes only run in chats where **Suggest tasks and forms** is on. See [Choose what Blue does in a chat](https://docs.on-site.io/blue/chat-settings.md).
* Across all recipes, Blue makes at most 4 recipe suggestions an hour in each chat.
* Each recipe keeps a log of when it ran, which admins can see.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.