# Report a bug

Send a bug report to the ATLAS team from inside the web app. The report arrives with your app version and organisation, so you don't have to look them up.

## Before you begin

- Your administrator has enabled bug reporting. If **Report a bug** isn't in the user menu, the feature is off for your ATLAS. Ask your organisation's Admin or your ilionx contact.
- You've sent fewer than 5 reports in the last hour.

## Send a report

1. Open the user menu at the bottom of the sidebar and choose **Report a bug**.
2. Enter a **Title**. It's required and can have up to 200 characters.
3. Enter a **Description**. It's required. Say what happened and what you expected to happen.
4. Optional: add **Steps to reproduce**.
5. Optional: paste the **Page URL** where it went wrong. ATLAS doesn't fill it in for you.
6. Optional: tick **Include my email so the team can follow up**. Leave it clear to report without your email.
7. Open **Context sent with this report** to review what goes along with your text: the app version, your browser, your organisation name, and the time.
8. Select **Send**.

**Result:** the dialog shows "Thanks, your report was sent" and a reference to the issue, such as `#123`. Select the reference to open the issue in a new tab.

## What is removed before sending

ATLAS removes secrets from every field before the report leaves. This covers bearer tokens, sign-in tokens, ATLAS API keys (`atl_sk_…`), `sk-…` provider keys and long hexadecimal or base64 strings. Email addresses are removed too, other than your own when you tick **Include my email so the team can follow up**. Removed text is replaced with `[REDACTED]` or `[EMAIL REDACTED]`.

Without that tick, your own email address is also removed, even if you typed it into the description.

## Good to know

- You can send up to 5 reports per hour. After that the dialog says "You've sent too many reports." and shows when you can try again.
- A report can hold up to 64,000 characters in total. A longer one is refused with [ERR-0144](https://docs.atlas.ilionx.dev/reference/errors.md#bug-reporting-errors). Shorten the description or steps.
- If the dialog says "We couldn't reach the issue tracker. Please try again shortly.", wait a moment and select **Send again**. Your text stays in the dialog.
- Don't paste prompts or data you wouldn't share with the ATLAS team. Secret removal is automatic, but it can't recognise every kind of sensitive text.

## Related

- [Errors](https://docs.atlas.ilionx.dev/reference/errors.md#bug-reporting-errors)
- [Troubleshooting](https://docs.atlas.ilionx.dev/guides/troubleshooting.md)