A review comment is attached to the wrong preview, or a fix is marked done without anyone checking the new message.
Fastest fix: use Mailgun Inspect’s comments, issue markers, and assignments to coordinate feedback, then track the template version, retest the changed preview, and perform a separate controlled inbox check when real receipt is part of acceptance. Collaboration status is not proof of repair or delivery.
This guide is for email QA engineers trying to prevent feedback from drifting between screenshots, chat, and template versions.
It is also for email developers who need to connect a review note to a specific change and confirm the updated message was retested.
Small product teams can use the workflow to give each issue an owner and keep an auditable acceptance record.
Last updated October 31, 2026; release details checked against Mailgun’s official release log and the Inspect email preview API documentation.
Before review: lock the email and preview under review
Mailgun’s release log says comments, issue marking, and colleague assignment became available in the Inspect web application on October 20, 2026. It also describes filtering marked emails, assigning colleagues, receiving notifications, and retesting after a fix. These are collaboration capabilities, not an automated approval gate. Teams still need to identify exactly which message and implementation the feedback concerns. Check the release notes for the feature announcement and scope.
Start by naming the review target in terms your team can reproduce: the email’s purpose, the environment that generated it, and the template or implementation version. A password-reset email in staging, for example, should not be treated as interchangeable with a welcome email from a local preview just because both share the same layout. Record the commit, template revision, or other identifier your team already uses. Do not assume that a comment or preview automatically records the implementation version you need for later comparison.
Also agree on the intended review surface. If the question is whether a particular email is visually readable in a particular client, record that client and the relevant viewport or rendering context. If the question is whether a link or variable is populated correctly, name the expected value or behavior. The Inspect preview API documentation describes a preview interface; a preview is useful evidence for review, but it is not equivalent to evidence that a recipient’s mail system accepted or displayed a message.
| Review item | Record before feedback starts | Why it matters |
|---|---|---|
| Email and environment | Message purpose and the environment that produced it | Prevents feedback from being applied to a different flow or deployment |
| Implementation identity | Commit, template revision, or an equivalent team identifier | Lets the developer connect the review to a change |
| Review target | Client or rendering context, if the visual result is under review | Makes a display issue reproducible |
| Acceptance criteria | Expected content, link behavior, and visual or functional checks | Gives the team a reason to approve or reject a change |
Treat this as the first handoff in the email template review process: the reviewer should be able to tell what is being examined before adding comments. If your team already manages implementation versions elsewhere, keep that record as the source of truth and reference it from the review. Avoid creating a second, informal versioning system in comment text.
During review: leave reproducible feedback beside the preview
Mailgun’s release notes confirm that Inspect supports comments, issue markers, colleague assignment, notifications, filtering marked emails, and retesting after a fix. The value is that feedback and coordination can stay associated with the preview workflow. The feature description does not establish that a marker creates a defect in a separate tracker, that an assignment approves a change, or that a notification confirms anyone has fixed the issue. Use the release log as the source for the announced collaboration behavior.
A comment is actionable when it states four things: where the problem appears, what the reviewer observes, what the expected result is, and how someone can reproduce the observation. “Spacing is wrong” leaves too much interpretation. “In the footer of the staging order-confirmation preview, the support link touches the preceding text; keep the visual separation used in the approved design” gives the developer a location, symptom, context, and target.
The marker should indicate that the issue needs attention, not that it has been resolved. Assignment should name the person responsible for investigating or implementing the change, not imply that the assigned person has accepted the product decision. When the issue is a judgment call—such as whether wording is legally or commercially acceptable—assign the decision to the appropriate reviewer or product owner rather than asking a developer to infer intent.
A team can adopt the following status meanings as a workflow recommendation. These are process labels, not claims about automatic Inspect states:
| Team status | Meaning | Evidence to move it forward |
|---|---|---|
| Needs change | A reproducible mismatch or defect remains | Comment identifies the location, observed result, and expected result |
| Needs decision | The implementation depends on an unresolved product or content choice | Decision owner records the chosen behavior or wording |
| Ready for retest | A change has been made, but review has not confirmed it | Developer identifies the changed template or implementation |
| Verified | The relevant reviewer has checked the updated target against the stated criterion | Review record links the check to the updated version |
| Inbox acceptance complete | A controlled message was sent and checked, if real receipt is in scope | Evidence records the test target and what was observed |
That separation matters because a comment count is not a quality measure. A long thread can contain one unresolved blocker; a single marked issue can be the only issue that prevents release. Reviewers should close each item based on its criterion, not on whether the conversation appears quiet.
After assignment: connect the issue to a real fix
Assignment gives an issue an owner, but ownership is only useful when the owner can find the implementation that needs changing. The developer should return to the template, code, or content source identified during setup and record what changed. If the cause is uncertain, the correct state is still “needs investigation,” not “fixed.” A marker can help the team find feedback; it cannot establish that the underlying cause has been addressed.
For each assigned item, keep the issue linked to the change that is supposed to resolve it. That can be a commit reference, a template revision, or another identifier used by the team. Do not copy an entire discussion into a separate record unless necessary; preserve enough context to answer three questions later: what failed, what changed, and which updated result was checked.
The reviewer should also distinguish a correction from a decision. A broken link can often be corrected against an expected destination. A change to a subject line, promotional claim, or product instruction may need approval from someone responsible for that content. If the team merges both types of work into one undifferentiated “done” status, a technically correct update can still ship with an unapproved product decision.
For Mailgun Inspect comment markers, the useful pattern is therefore not “mark, assign, close.” It is “describe, assign, change, identify the changed target, then verify.” That distinction keeps a workflow label from becoming a substitute for evidence.
After a change: how do you confirm the retest uses the latest version?
Reopen or regenerate the relevant preview after the implementation change, then compare the target against the recorded version or change reference. Mailgun’s update says the workflow can be retested after repairs, but the team must still confirm that its retest concerns the intended update. A screenshot or preview captured before the change cannot demonstrate that the new implementation works.
The reviewer should check the original failure condition first. If the comment concerned a truncated heading, inspect that heading in the updated preview. If it concerned a dynamic value or a link, verify the relevant value or target rather than approving based only on a general visual scan. Then check related content that could have been affected by the edit, while keeping the approval criteria proportionate to the change.
Use a small retest record:
- Reference the original issue or comment.
- Identify the changed template, commit, or revision.
- State which preview or test was regenerated after the change.
- Record the specific expected result and what the reviewer observed.
- Keep the item open if the evidence belongs to an earlier version or does not address the original failure.
These steps answer a common version-control problem in email testing and retest acceptance: a reviewer may see a plausible preview, but cannot tell whether it reflects the newest code. Connecting the retest to a version reference turns “looks fixed” into a check the next reviewer can repeat.
Do not treat a successful preview as proof of sending. The Inspect API documentation covers email preview, which is a different type of evidence from receipt by an external mail system. Likewise, Mailgun’s test mode documentation describes a mode for testing message handling; a test-mode result should not be represented as proof that a message reached a recipient’s inbox. The exact setup and behavior should be checked against the current documentation before your team relies on it.
When the preview passes: how do you accept real inbox receipt?
A preview can support review of rendered content, but it cannot by itself establish that a message was sent, accepted by a recipient’s mail server, or placed in an inbox rather than a spam folder. If acceptance requires real receipt, trigger the message from your own product in an authorized test environment and inspect it at a controlled address. Keep that check separate from the preview approval so the evidence answers the right question.
The distinction is consistent with SMTP’s delivery responsibilities. Under RFC 5321’s description of SMTP acceptance, a receiving server that accepts responsibility indicates acceptance with a positive completion response; that does not establish that a human later saw the message in an inbox. Record what was actually observed, such as whether the test message arrived and whether its key content was readable. Do not turn a successful check at one controlled destination into a guarantee about every mailbox provider or every recipient.
Use a controlled test address that does not expose a colleague’s personal mailbox or mix test messages with operational mail. If the acceptance test includes verification links, passwords, or customer-like data, use non-production values and restrict who can access the test inbox. OWASP’s Testing Guide discussion of test data provides security-testing context for handling test data; the practical rule here is to avoid putting real personal information into review fixtures unless the test is explicitly authorized and protected.
This is also where teams should decide whether they need a persistent mailbox or only a temporary controlled destination. A temporary inbox can suit a one-off registration or message-readability check, but it is not the right destination for a long-lived account that needs password recovery, replies, or durable correspondence. For troubleshooting a missing verification message, consult our guide to what to check when an email code does not arrive before concluding that the template itself is broken.
At sign-off: preserve evidence and close the loop
Approval should depend on criteria agreed before review, not on the presence of comments, markers, assignments, or a quiet discussion. The team’s final record should connect the reviewed message to its implementation identity, list the issues that were resolved or explicitly accepted, state which checks were repeated, and say whether real inbox acceptance was required and completed.
A compact sign-off note can include:
- The email purpose, environment, and template or commit reference.
- Each issue’s disposition: corrected, accepted as intended, or still blocking.
- The updated target used for retesting and the result against the original criterion.
- Whether controlled inbox acceptance was in scope, and what was actually observed.
- Any remaining limitation, such as a client or recipient environment that was not tested.
- Confirmation that test content does not contain unnecessary personal information.
Before closing, check that the record does not silently conflate three different outcomes: preview appearance, implementation behavior, and actual receipt. The first can be assessed from a preview; the second may require exercising the product flow; the third requires a controlled send and an observation at the receiving end. A team can pass one and fail another, so one green status should not stand in for all three.
Use this checklist before marking the review complete:
- [ ] The email and environment under review are named.
- [ ] The reviewed implementation or template version is recorded.
- [ ] Each unresolved comment describes an observable issue and expected result.
- [ ] Every change has an owner, and product decisions have a decision owner.
- [ ] Retest evidence corresponds to the updated implementation, not an older preview.
- [ ] Real inbox acceptance was performed only if it is part of the agreed criteria.
- [ ] The record distinguishes preview evidence from receipt evidence.
- [ ] Test messages and review data avoid unnecessary personal information.
For teams that use a controlled temporary destination during acceptance, our data and privacy overview can help assess the privacy questions to check before selecting an address. Check the current InboxCloak page for the capabilities that apply to the intended test; do not assume an address is suitable for long-term account recovery or mail that needs a reply.
Close the review without overstating what passed
A reliable Mailgun Inspect email QA collaboration loop ends with evidence that matches the acceptance claim: the right version was reviewed, actionable feedback was assigned, the change was retested, and any required receipt check was performed separately. Inspect’s collaboration features can keep the conversation organized, but the team supplies the version control, acceptance rules, and final judgment.
If the remaining task is simply to register a test account, inspect a message, or receive a one-time verification email without exposing a work inbox, InboxCloak may be one option. It is designed for use without registration and an address can be opened for immediate use; that can keep a short-lived test away from a primary mailbox and its routine clutter. It is not a substitute for a durable address when the account needs ongoing recovery, replies, or long-term mail history. Check the current InboxCloak service page to confirm whether the available inbox setup fits the acceptance test, and treat receipt at a controlled address as evidence for that test only—not a promise about every provider.
Put your notes to work with the tool—share only what’s needed
Go back to your inbox to check for real messages. If none have arrived, follow the separate troubleshooting checklist step by step; there’s no need to capture the whole screen again.