# Symptom index

Match a symptom to a troubleshooting page, and the error codes that show up most often.

## Symptom

The widget, a preview, or a request is stuck, and you need the page that matches what you see.

| Symptom | Page |
| --- | --- |
| The button **Request a change** never appears | [Widget not showing](https://www.modifee.com/docs/troubleshooting/widget-not-showing) |
| "This email isn't allowed to request changes on this site." | [Email not allowed](https://www.modifee.com/docs/troubleshooting/email-not-allowed) |
| "Could not verify your identity. Refresh the page and try again." on a site with login | [Token errors](https://www.modifee.com/docs/troubleshooting/token-errors) |
| **MODIFEE_SECRET is not on Vercel yet.** or **Redeploy now** fails | [Secret and redeploy](https://www.modifee.com/docs/troubleshooting/secret-and-redeploy) |
| The client cannot open a preview, or **Previews** is yellow | [Previews](https://www.modifee.com/docs/troubleshooting/previews) |
| The request is **Failed**, or no pull request was opened | [Agent and pull request](https://www.modifee.com/docs/troubleshooting/agent-and-pr) |
| Checkout or **Manage billing** fails, or the widget says the monthly request limit | [Billing and plan](https://www.modifee.com/docs/troubleshooting/billing-and-plan) |

## Frequent error codes

Each code has a page under `/docs/errors/` with a cause and a fix.

- [MDF-AUTH-001](https://www.modifee.com/docs/errors/MDF-AUTH-001) — "You need to sign in." The widget shows "Could not verify your identity. Refresh the page and try again."
- [MDF-AUTH-002](https://www.modifee.com/docs/errors/MDF-AUTH-002) — "This email isn't allowed to request changes on this site."
- [MDF-AUTH-004](https://www.modifee.com/docs/errors/MDF-AUTH-004) — "That code is incorrect or has expired."
- [MDF-QUOTA-001](https://www.modifee.com/docs/errors/MDF-QUOTA-001) — credits or the spend cap. The widget says "Request received — your team has been notified and will process it shortly."
- [MDF-QUOTA-002](https://www.modifee.com/docs/errors/MDF-QUOTA-002) — "Too many requests. Try again in a moment." The widget says "Too many messages. Try again in a few minutes."
- [MDF-WIDGET-001](https://www.modifee.com/docs/errors/MDF-WIDGET-001) — "That file could not be attached."
- [MDF-WIDGET-002](https://www.modifee.com/docs/errors/MDF-WIDGET-002) — "Transcription failed."
- [MDF-WIDGET-004](https://www.modifee.com/docs/errors/MDF-WIDGET-004) — "Allow the microphone in your browser to dictate."
- [MDF-WIDGET-005](https://www.modifee.com/docs/errors/MDF-WIDGET-005) — "The connection was lost." The widget says "We can't reach the team right now. Try again in a few minutes."
- [MDF-VERCEL-001](https://www.modifee.com/docs/errors/MDF-VERCEL-001) — "Vercel could not complete that request."
- [MDF-VERCEL-003](https://www.modifee.com/docs/errors/MDF-VERCEL-003) — "The preview could not be opened."
- [MDF-INTERNAL-001](https://www.modifee.com/docs/errors/MDF-INTERNAL-001) — "Something broke on our end. We've been notified."

## Other errors

- [MDF-AUTH-003](https://www.modifee.com/docs/errors/MDF-AUTH-003) — "You don't have access to this." This account cannot do that on the workspace or project.
- [MDF-REQ-001](https://www.modifee.com/docs/errors/MDF-REQ-001) — "Something was off with that request." A required field was missing or had the wrong shape.
- [MDF-REQ-002](https://www.modifee.com/docs/errors/MDF-REQ-002) — "We couldn't find that." That project, request, or widget key does not exist.
- [MDF-INTERNAL-002](https://www.modifee.com/docs/errors/MDF-INTERNAL-002) — "Modifee is briefly unavailable." The service is temporarily unavailable.