
Run a Preview
1
Open a design on the canvas
Open any email. In the Preview panel on the right, switch to the Inboxes tab.
2
Pick your clients
Choose the default spread (Gmail, Outlook, Apple Mail, and iOS). Or select specific clients, including OS, version, and light/dark mode combinations.
3
Review the results
Screenshots come back per client. Clients that are slow to render show as Pending. Click Retry to fetch only those without re-running the rest.
Each preview run costs 10 credits, charged only when at least one client renders. If nothing comes back, you aren’t billed.
Supported Clients
What to Check
- Outlook first. Outlook on Windows uses its own rendering engine and is the most common place layouts break. Check tables, spacing, and background images there before anywhere else.
- Dark mode. iOS and Apple Mail dark variants show whether your colors invert gracefully. Watch for logos that vanish on dark backgrounds and text that loses contrast.
- Mobile. The iOS and Android variants confirm your layout stacks correctly on a narrow screen.
Inbox Previews vs Test Sends
Each check answers a different question:- Inbox previews show how the design renders across many clients at once. You need no inbox accounts, and the results come back in one grid.
- Test sends deliver the real email to your own address, so you can check the from name, subject, preview text, and links as an actual recipient.
- Inbox placement tests send the real email from your verified domain to Brew’s seed inboxes and report, per mailbox provider, whether it reached the inbox or spam. Run an Inbox Placement Test has the steps.
Run an Inbox Placement Test
A placement test sends the real email from your sending domain to seed inboxes across mailbox providers. It reports where each copy landed: inbox, promotions, or spam. Run it from API → Quality → Inbox Placement in the dashboard. It needs a verified sending domain, because the seed send goes out over your real sender. Results aren’t instant, so check back until the test completes. Each test uses credits. Subject line and preview text are the variables worth testing. Run the same design twice with different subjects and compare where each lands. Brew University walks through it on video.From an Agent or Code
The same feature is available programmatically:-
API:
POST /v1/emails/{emailId}/client-previews. Passclientswith ids from the supported catalogue, or an empty body for the default spread. It starts a rendering job and returns itspreviewId; pollGET /v1/emails/client-previews/{previewId}until the job finishes. -
TypeScript SDK:
brew.emails.previewClients({ emailId })starts the job; pollbrew.emails.getClientPreview(previewId). -
MCP: ask your agent for a preview, so it can QA a design as part of a workflow. The job returns a preview ID right away, and the agent checks it until the screenshots are ready. The screenshots come back in the conversation, with a link to each full-size render. For a free look at the design itself, ask to see the email, and its preview comes back.
“Preview the launch email in Gmail and Apple Mail.”

“Run an inbox placement test on my launch email and tell me where it landed.”From code,
POST /v1/emails/{emailId}/inbox-placement-tests starts one. Poll GET /v1/emails/{emailId}/inbox-placement-tests/{testId} until it completes.
See the API Reference for the full client catalogue and response shape.
Need Help?
Our team is ready to support you at every step of your journey with Brew. Choose the option that works best for you:- Self-Service Tools
- Talk to Our Team
Search Documentation
Type in the “Ask any question” search bar at the top left to instantly find relevant documentation pages.
Ask ChatGPT or Claude
Click here to open the Copy page menu at the top of this page, then send the page to ChatGPT, Claude, or your editor.