Email Queue Management for Magento 2
The Email Queue shows all scheduled review invitations for the Product Review Reminder extension. Monitor pending emails, track delivery status, and see which customers have submitted reviews.
Location: Marketing → Review Reminder → Email Queue
Grid Columns
| Column | Description |
|---|---|
| ID | Unique queue entry identifier. |
| Purchase Point | Store view where the order was placed. |
| Order | Order number with link to order details. |
| Order Date | When the order was placed. |
| Customer Group | Customer's group (hidden by default). |
| Customer Name | Name of the customer. |
| Order Status | Current order status. |
| Profile | Which invitation profile matched this order. |
| First Email Scheduled At | When the first invitation email is scheduled to send. |
| Second Email Scheduled At | When the follow-up email is scheduled (if enabled). |
| Sent At | When the email was actually sent. |
| Type | Email type: First or Second reminder. |
| Status | Current status: Pending, Sent, or Error. |
| Reviewed | Whether the customer has submitted a review. |
How Items Enter the Queue
Orders are automatically added to the queue when:
-
Order matches profile criteria:
- Store view matches
- Customer group matches
- Order status reaches target status (e.g., Complete)
- Order passes any configured conditions
- Order is not older than the profile's maximum offset
-
Queue cron runs: The system periodically checks for qualifying orders based on the "Order Queue Processing" frequency setting.
-
Customer not unsubscribed: Customers who opted out are excluded.
-
No duplicate: Order hasn't already been queued.
Status Values
| Status | Meaning |
|---|---|
| Pending | Email is scheduled but not yet sent. Waiting for scheduled date. |
| Sent | Email was successfully sent to the customer. |
| Error | Email sending failed. Check logs for details. |
Type Values
| Type | Meaning |
|---|---|
| First | Initial review invitation email. |
| Second | Follow-up reminder (when second mail is enabled in profile). |
Reviewed Status
| Value | Meaning |
|---|---|
| No | Customer hasn't submitted a review yet. |
| Yes | Customer submitted a review through the invitation link. |
Available Actions
Mass Actions
- Delete: Remove selected items from the queue. Useful for cleaning up test entries or cancelled orders.
Row Actions
Click the three-dot menu on each row for:
- View order details
- Delete queue entry
Filtering the Grid
Use filters to find specific queue items:
- Store View: Filter by purchase store
- Order: Search by order number
- Order Status: Filter by order status
- Profile: Filter by invitation profile
- Status: Show only Pending, Sent, or Error
- Reviewed: Show only reviewed or not reviewed
Common Use Cases
Monitor Pending Emails
- Filter by Status = Pending
- Check First Email Scheduled At column
- Verify emails are scheduled correctly
Find Undelivered Emails
- Filter by Status = Error
- Review the entries
- Check debug logs for error details
Track Review Conversion
- Filter by Status = Sent
- Check Reviewed column
- Calculate review rate (Yes / Total Sent)
Clean Up Test Orders
- Filter by order number or date range
- Select test entries
- Use Delete mass action
Troubleshooting Queue Issues
No items appearing in queue:
- Verify module is enabled
- Check that at least one profile is enabled and configured
- Verify cron is running (
bin/magento cron:run) - Run queue command manually:
bin/magento reviewreminder:queue --offset=30
Emails stuck as Pending:
- Check scheduled date hasn't passed yet
- Verify email dispatch cron is running
- Run process command:
bin/magento reviewreminder:process
All items show Error status:
- Check email configuration in Magento
- Verify SMTP settings if using external mail server
- Review debug logs for specific errors
Need More Help?
Documentation:
- All Help Articles - Complete documentation overview
Support:
- Contact Support - Get help from our team