Overview

When Vesta sends an email — a booking confirmation, a check-in notice, a staff alert — it does not send immediately inline. Instead, the email is placed in a delivery queue and processed in the background. This design means your day-to-day operations (creating bookings, checking in guests) are never slowed down by email delivery.

The Email Queue page gives you visibility into this process. You can see which emails were sent successfully, which are still pending, and which failed. If a guest says they never received their confirmation, this is the first place to check.

Accessing the Email Queue

1. Open Settings > Email Queue from the sidebar
2. You will see a table of recent emails with filtering options

Understanding Email Statuses

Each email in the queue has one of these statuses:

:::info “Sent” means Vesta successfully handed the email to your email provider (e.g., Mailgun). It does not guarantee the recipient received it — the email could still bounce or land in spam at the recipient’s end. :::

Filtering and Searching

Use the filters at the top of the queue to narrow results:

• Status — show only pending, sent, or failed emails
• Date range — filter by when the email was queued
• Recipient — search by recipient email address

Viewing Email Details

Click any row in the queue to see full details:

• Recipient — who the email was addressed to
• Subject — the email subject line
• Template — which email template was used
• Status — current delivery status
• Queued at — when the email entered the queue
• Sent at — when it was successfully delivered (if applicable)
• Error — the error message if delivery failed

Queue Statistics

At the top of the page, summary statistics show:

• Pending — emails waiting to be processed
• Sent — successfully delivered in the last 24 hours
• Failed — emails that could not be delivered

:::tip Check queue statistics daily as part of your routine. A sudden spike in pending or failed emails usually means there is a configuration issue with your email provider. :::

How Retries Work

When an email fails to send, Vesta does not give up immediately:

1. First failure — email is retried after a short delay
2. Second failure — retried again with a longer delay
3. Third failure — if still failing, the email is marked as permanently Failed

Retries use increasing delays (exponential backoff) to avoid overwhelming the email provider. High-priority emails (like booking confirmations) are retried with shorter delays than normal-priority emails.

Troubleshooting Failed Emails

If you see failed emails in the queue:

1. Check the error message — click the failed email to see what went wrong. Common errors include invalid recipient addresses, provider authentication failures, or rate limiting.

2. Verify email provider settings — if many emails are failing, the issue is likely with your email provider configuration. Contact your system administrator to check the provider API key and domain settings.

3. Check the recipient address — if only specific emails fail, the recipient’s address may be invalid or their mail server may be rejecting messages.

:::warning Failed emails are not automatically re-queued after the maximum retry attempts. If a critical email (like a booking confirmation) fails, you may need to resend it manually. Use the template editor’s Send Test feature or contact the guest directly. :::

Related Articles

• Email Templates — customize the content of emails Vesta sends
• Portal Notifications — configure staff email notifications for portal events
• Property Settings — general property configuration including contact details

:::permissions

• property:edit — required to view the email queue and email details :::