Skip to content

Email configuration

Configure SMTP or PHP mail for form and action notifications. Send a test email and troubleshoot delivery.

Updated October 23, 2026 2 min read

As the site owner, configure email for form and action notifications in Studio. Both use the same settings.

Setting up email

Open Settings and find Email & Notifications. Choose a Delivery Method.

Use SMTP when you have mail server credentials. VoxelSite includes presets for common providers:

Provider Host Port Encryption
Gmail smtp.gmail.com 587 TLS
Outlook / Hotmail smtp-mail.outlook.com 587 TLS
Yahoo smtp.mail.yahoo.com 587 TLS
iCloud smtp.mail.me.com 587 TLS
Zoho smtp.zoho.com 587 TLS

Select a preset. VoxelSite fills in the server details. Enter your username and password, or the app password your provider requires.

If your provider is absent, choose Custom SMTP Server. Enter its host, port, username, password and encryption type.

PHP mail

Choose PHP mail() to use your server's mail function. Delivery depends on your host's mail setup.

No email

If you do not need notifications, choose Not configured. VoxelSite still stores submissions for you to read in Studio.

Testing

Enter a Test Email address, then click Send Test. Check that inbox and its spam folder. A successful response confirms acceptance for delivery, not arrival in the inbox. A lost response does not prove that no message was sent. Check the retained result before requesting another send.

Security

VoxelSite encrypts saved SMTP passwords with AES-256-CBC and the installation key. Keep the installation configuration and database private.

Fallback behavior

If SMTP fails, VoxelSite tries PHP mail(). If both fail, it logs the error. The submission remains stored; check Studio when a notification is missing.

Action email notifications

With email configured, VoxelSite attempts these notifications after an action submission:

  • Owner notification: submission details go to the configured owner address. A valid visitor email becomes the Reply-To address.
  • Guest confirmation: if the submission has a valid email address, the visitor receives the reference code and submitted details.

API-based providers

Email configuration and tests are owner administration. External tools need the corresponding permission and exact approved operation; see Administration. Website restoration does not undo a delivered email.

If your email service supplies SMTP credentials, use Custom SMTP Server. VoxelSite does not use the service's HTTP API.

Found a mistake in these instructions? Open an issue.

Download VoxelSite