Docs
Rendering Status
The status pill shows what MailMode is doing, whether the preview rendered, and whether something needs attention.
What the Pill Does
The pill beside the input tabs is a quick render state. The coloured dot tells you the severity at a glance, while the small info icon explains the current message.
Rendered
Status Colours
Empty
Grey: waiting
No email has been added yet, or MailMode is in a neutral state.
Rendering
Purple: working
MailMode is processing something, such as rendering, loading a URL, reading a zip, creating a share link or exporting a report.
Rendered
Green: success
The action completed successfully. The email may still have health warnings, but the preview itself loaded.
Server needed
Amber: needs attention
Something blocked or interrupted the flow. Hover or focus the info icon in the app to see the specific explanation.
Success Messages
ReadyMailMode is ready to use.
RenderedThe preview rendered successfully.
Rendered with notesThe preview rendered, but MailMode found useful warnings or notes in the checks.
Loaded URLThe URL loaded successfully and was added to the editor.
Loaded zip projectThe zip project loaded successfully, including supported local image assets.
Share link readyThe hosted preview link was created and is ready to copy.
Report exportedThe branded PDF health report was generated successfully.
Working Messages
RenderingMailMode is generating the light and dark previews.
Loading URLThe app is fetching email source from the URL field.
Reading zipThe zip is being checked and unpacked safely in the browser.
Creating share linkMailMode is creating a temporary hosted preview link.
Exporting reportMailMode is preparing a branded PDF report.
Warning Messages
URL and loading issues
Server neededURL loading needs the local server or proxy. Start MailMode through the server rather than opening the file directly.
URL blockedThe remote site or browser security blocked the request, usually because of CORS or security headers. Check the URL or paste the source manually.
Enter a URLAdd a valid http or https URL before loading remote email HTML.
File and ZIP issues
File could not be readThe browser could not read the selected file. Try another file or paste the source manually.
File is too largeThe selected file is above the 5 MB upload limit. Reduce the file size or paste the source manually.
Choose main fileThe ZIP contains more than one possible main email file. Choose the file you want to preview.
No valid main file foundThe ZIP did not include a usable HTML, HTM, MJML, JSX or TSX email file.
ZIP import cancelledThe ZIP chooser was closed before a main file was selected. Re-upload and choose the main file.
ZIP too large / extracted ZIP too largeThe upload is above the safety limit. Keep the ZIP under 5 MB and reduce unnecessary assets if the extracted project is too large.
ZIP has too many filesThe ZIP contains too many files to validate safely. Remove unused assets and try again.
Unsafe file path detectedThe ZIP contained a path that could escape the project folder, so MailMode blocked it for safety.
Nested ZIP filesNested archives are blocked because they are harder to validate safely. Upload the extracted email project instead.
Password-protected ZIP files are not supportedMailMode cannot inspect protected archives safely in the browser. Upload an unprotected ZIP or a single email file.
Invalid ZIP fileThe ZIP looks damaged or invalid, so MailMode stopped processing it. Re-export the project and try again.
Unsupported file typeThe upload contains a file type or compression method MailMode does not support. Use HTML, HTM, MJML, static React Email or a supported ZIP project.
Rendering and compiler issues
Needs attentionThe email could not be rendered cleanly. Review the warning card shown in the app.
MJML compiler unavailableThe MJML compiler could not load. Paste compiled HTML if needed.
React Email render blockedThe template uses a pattern blocked by safe preview mode. Export rendered HTML or simplify the template for previewing.
React Email render failedThe React Email template could not be converted into previewable HTML. Check the source or paste exported HTML.
Share, copy and export issues
Nothing to share / export / copyAdd or render email content before using that action.
Copy failed / share failed / report export failedThe browser, server or export flow blocked the action. Try rendering again, refreshing the page or checking the server.
How to Use These Messages
Use the pill as a quick first signal, not a full report. Grey means nothing has happened yet or no email is loaded. Purple means wait while MailMode processes. Green means the flow completed. Amber means review the message and take the suggested action. If the preview rendered with notes, open the health report for detail.
