Email Configuration

VoxelSite can send email notifications when someone submits a form or an action on your website. Both Forms and Actions use the same email configuration.

Setting up email

Go to Settings → Email to configure your mail settings.

SMTP (recommended)

SMTP is the most reliable option. VoxelSite includes presets for common providers:

Select a preset and VoxelSite fills in the server details. You just need to enter your username and password (or app-specific password).

Custom SMTP — If your provider isn't listed, choose "Custom" and enter the SMTP host, port, username, password, and encryption type manually.

PHP mail

Uses your server's built-in mail() function. No configuration needed — but delivery reliability depends on your server's mail setup.

No email

If you don't need email notifications, leave the driver set to "None". Form submissions are still stored in the database and viewable in the Studio.

Testing

Use the Send Test Email button in Settings to verify your configuration before going live. VoxelSite sends a test message and shows you the result.

Security

SMTP passwords are encrypted at rest using AES-256-CBC encryption. They are only decrypted in memory when sending email.

Fallback behavior

If SMTP fails, VoxelSite automatically falls back to PHP mail(). If that also fails, the error is logged but the submission is still stored — email delivery never blocks data capture.

Action email notifications

When a visitor submits an action form, two emails are sent (if email is configured):

• Owner notification — sent to the site owner with full submission details. The visitor's email is set as the Reply-To address so you can respond directly.
• Guest confirmation — sent to the visitor confirming their submission, including the reference code and submitted details.

API-based providers

Services like SendGrid, Amazon SES, Resend, and Mailgun all support SMTP. Use their SMTP credentials with VoxelSite — no API integration needed.