Modifee
Markdown
Open in
ClaudeChatGPT

Updated 2026-09-25

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 | | "This email isn't allowed to request changes on this site." | Email not allowed | | "Could not verify your identity. Refresh the page and try again." on a site with login | Token errors | | MODIFEE_SECRET is not on Vercel yet. or Redeploy now fails | Secret and redeploy | | The client cannot open a preview, or Previews is yellow | Previews | | The request is Failed, or no pull request was opened | Agent and pull request | | Checkout or Manage billing fails, or the widget says the monthly request limit | Billing and plan |

Frequent error codes

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

  • 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 — "This email isn't allowed to request changes on this site."
  • MDF-AUTH-004 — "That code is incorrect or has expired."
  • 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 — "Too many requests. Try again in a moment." The widget says "Too many messages. Try again in a few minutes."
  • MDF-WIDGET-001 — "That file could not be attached."
  • MDF-WIDGET-002 — "Transcription failed."
  • MDF-WIDGET-004 — "Allow the microphone in your browser to dictate."
  • 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 — "Vercel could not complete that request."
  • MDF-VERCEL-003 — "The preview could not be opened."
  • MDF-INTERNAL-001 — "Something broke on our end. We've been notified."

Other errors

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