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 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
Server neededURL loading needs the local server or proxy. This often appears when the page is opened as a local file.
URL blockedThe remote site or browser security blocked the request, usually because of CORS or security headers.
Enter a URLAdd a valid http or https URL before loading remote email HTML.
File could not be readThe browser could not read the selected file. Try another file or paste the source manually.
Choose main fileA zip contains more than one possible main email file, so you need to choose one.
Zip import cancelledThe zip chooser was closed before a main file was selected.
Zip too large / extracted zip too largeThe upload is above the safety limit and needs to be reduced.
Unsafe file path / path traversalThe zip contains a path that could escape the project folder, so it is rejected for safety.
Nested zip filesNested archives are blocked because they are harder to validate safely.
Unsupported file typeThe upload contains a file type or compression method MailMode does not support.
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, such as dynamic runtime behaviour.
React Email render failedThe React Email template could not be converted into previewable HTML.
Nothing to share / export / copyAdd or render email content before using that action.
Copy failed / share failed / report export failedThe browser, local server or export flow blocked the action. Try rendering again or checking the local server.
How to Use These Messages
Use the pill as a quick first signal, not a full report. Green means the flow completed. Purple means wait. Amber means review the tooltip or the warning card before continuing. If the preview rendered with notes, open the health report for the detail.
