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

# Ask Atlas

> Ask questions about your restaurant data and get help inside the Atlas Merchant Portal.

Ask Atlas answers questions about your restaurant inside the [Atlas Merchant Portal](https://portal.atlas.kitchen).
Ask about sales, orders, products, and stock without leaving the page you are on.
It can also make changes for you, such as bulk price updates, after you confirm them.

## Ask a question

> [!NOTE]
>
> Ask Atlas is available to everyone. Your account permissions still apply.

**1. Open the page you need help with**

Open a page such as **Stocks**, **Products**, or an order's details.
Check the outlet and menu you are asking about.

**2. Open Ask Atlas**

Select **Ask Atlas** to open the chat panel.
You can keep the page open while you use the panel.

**3. Ask your question**

Name the outlet, date range, and figure you need.
For example: "What were net sales at Tanjong Pagar yesterday?"

Ask Atlas receives context from supported pages, including some open products and orders.
It does not see everything on your screen.
Tag the exact product, outlet, or brand with `@` when your question could refer to more than one.

**4. Check the answer**

Check that Atlas used the right outlet, dates, and records.
Ask for the figures behind any summary that looks unclear.

## Questions to try

Replace the example names and dates with your own.

* "What were net sales at Tanjong Pagar yesterday?"
* "Which five products sold the most at Orchard last week?"
* "Which products on my Dine-in menu are missing costs?"
* "Is laksa in stock at Tanjong Pagar?"
* "What is the status of order A-1024?"

> [!NOTE]
>
> AI answers can be wrong. Check the outlet, dates, and source data before making decisions.
> Compare important totals with the [matching report](https://help.atlas.kitchen/reports/overview.md) using the same filters.

For charts and deeper analysis, use [Atlas Data Intelligence](https://help.atlas.kitchen/ai/data-intelligence.md).
Use [reports](https://help.atlas.kitchen/reports/using-reports.md) for exports and scheduled deliveries, not Ask Atlas.

## Tag records with @

Tag a record so Atlas works on exactly the one you mean.
This helps when names repeat across outlets, brands, or menus.

**1. Type @ in the message box**

A list of matching records opens above the message box.

**2. Type part of the name**

For example, type `@marg` to find Margherita pizza.
Results are grouped into **Products**, **Outlets**, **Brands**, and **Orders**.
To find an order, type part of its order number.

**3. Select the record**

Click the record, or use the arrow keys and press **Enter**.
Press **Esc** to close the list without tagging.

You can tag several records in one message. For example:

```text theme={null}
Copy @Margherita pizza from @Tanjong Pagar to @Orchard.
```

You only see records your account has permission to view.

## Make changes in bulk

Ask Atlas can also create and update records for you.
Give Atlas the whole task in one message, rather than requesting each change separately.
Replace the example names and values with your own.

### Create several products

Give Atlas the section, product names, and prices in one request.

```text theme={null}
Create these products in the Non-Alcohol section of my Dine-in menu:
- Jasmine sparkling tea: S$20
- Oolong sparkling tea: S$20
- Osmanthus sparkling tea: S$20
```

### Copy products with new SKUs

A SKU is a product's unique code. Specify which products to copy and how to name their copies.

```text theme={null}
Copy the products with SKUs peach-gazoz and melon-gazoz as new products.
Prefix each new SKU with summer-. Keep the originals unchanged.
Flag any missing required fields.
```

### Apply a revised price list

> [!NOTE]
>
> Check the exact products before changing prices, especially when names repeat across menus.

Ask for current prices first. Paste your revised list back into the same conversation.

```text theme={null}
Find these products on my Delivery menu and propose these new prices:
- Margherita pizza: S$24
- Mushroom pizza: S$27
- Garlic bread: S$9
Show each product's SKU, current price, and new price.
Leave every other product unchanged.
```

### Move a group of menu items

Name the menu and both sections so Atlas moves the intended items.

```text theme={null}
In my Dine-in menu, move these products from Seasonal to Drinks:
- Jasmine sparkling tea
- Oolong sparkling tea
- Osmanthus sparkling tea
```

### Enter unit costs together

Paste your calculated cost per item instead of opening every product separately.

```text theme={null}
Set these unit costs for the products on my Dine-in menu:
- Margherita pizza: S$6.20 per pizza
- Mushroom pizza: S$7.10 per pizza
- Garlic bread: S$1.80 per portion
```

> [!NOTE]
>
> Large requests can hit limits or save only some changes.
> Split a large menu into smaller named groups, such as one section at a time.
> After each group, check what saved before asking Atlas to continue.

For more tasks, browse the [Atlas AI use cases](https://help.atlas.kitchen/use-cases.md).
Each guide lists the tools you can use, including Ask Atlas where supported.

## Review changes before applying them

Ask Atlas always asks you to confirm before it changes your data.
A confirmation appears automatically before every change.

Review the record, outlet, and new values in the confirmation.
Select **Confirm** to apply the change, or **Cancel** to reject it.
Nothing changes until you confirm.

After you confirm, check the result on the relevant page in the Atlas Merchant Portal.
If the result is unclear, ask Atlas to read the saved record again.
For bulk work, ask it to list completed, failed, and remaining items separately.
Do not repeat a change until you know whether it saved.

## Continue a conversation

Open **History** in the panel to return to a previous conversation.
Select **New chat** when you want to start a separate task.
Check the outlet, menu, and records before continuing an older request.

## If you get stuck

| Problem | What to do |
| - | - |
| Ask Atlas is missing | Check a regular page such as Products. Ask Atlas is hidden on POS, kitchen, dispatch, and reporting pages. |
| It is missing on regular pages too | Refresh the page. Contact [hello@atlas.kitchen](mailto:hello@atlas.kitchen) if it is still missing. |
| The answer refers to the wrong record | Tag the product, order, or outlet with `@`. Then send the request again. |
| A record is missing from the `@` list | Type more of the name. Check that your account can view that record. |
| You cannot complete an action | Check your account permissions with your administrator. Ask Atlas does not grant extra permissions. |
| A response or change fails | Check the saved record first. Retry the question after checking your connection. |
| A bulk task stops partway through | Ask Atlas to read back each saved item. Retry only failed or remaining items in smaller groups. |

If the problem continues, contact [hello@atlas.kitchen](mailto:hello@atlas.kitchen).
Include the page, question, and any error message. Do not send passwords or access tokens.

For direct stock controls, see [Use the Stocks page](https://help.atlas.kitchen/merchant-portal/stocks.md).


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