Email Settings
The Email Settings tab configures automated email notifications for polls and surveys. Enable or disable notifications, customize subject lines, and personalize message templates with dynamic placeholders.
Accessing Email Settings
Section titled “Accessing Email Settings”Navigate to WP Admin > WB Polls > Settings and open the Email Settings tab.
Email Types
Section titled “Email Types”Four email notification types are available, covering both surveys and standalone polls.
Response Received (Survey)
Section titled “Response Received (Survey)”Sent to the site administrator when a survey response is completed.
| Setting | Description |
|---|---|
| Enable | Turn this notification on or off. Enabled by default. |
| Recipient Email | Email address to receive notifications. Leave blank to use the site admin email. |
| Subject | Email subject line. Default: [{site_name}] New Survey Response: {title} |
| Message | Email body content with placeholder support. |
Completion Confirmation (Survey)
Section titled “Completion Confirmation (Survey)”Sent to the respondent after they complete a survey.
| Setting | Description |
|---|---|
| Enable | Turn this notification on or off. Disabled by default. |
| Subject | Email subject line. Default: Thank you for completing "{title}" - {site_name} |
| Message | Email body content with placeholder support. |
This email does not have a recipient field because it is automatically sent to the respondent’s email address.
Vote Received (Poll)
Section titled “Vote Received (Poll)”Sent to the site administrator when a vote is cast on a standalone poll.
| Setting | Description |
|---|---|
| Enable | Turn this notification on or off. Disabled by default. |
| Recipient Email | Email address to receive notifications. Leave blank to use the site admin email. |
| Subject | Email subject line. Default: [{site_name}] New Vote on: {title} |
| Message | Email body content with placeholder support. |
Vote Confirmation (Poll)
Section titled “Vote Confirmation (Poll)”Sent to the voter after casting a vote on a standalone poll. Only works for logged-in users.
| Setting | Description |
|---|---|
| Enable | Turn this notification on or off. Disabled by default. |
| Subject | Email subject line. Default: Your vote on "{title}" has been recorded - {site_name} |
| Message | Email body content with placeholder support. |
Available Placeholders
Section titled “Available Placeholders”Use these placeholders in subject lines and message bodies. They are replaced with actual values when the email is sent.
| Placeholder | Replaced With |
|---|---|
{title} |
Survey or poll title |
{user_name} |
Voter or respondent name, or “Guest” for anonymous users |
{user_email} |
Voter or respondent email address |
{site_name} |
Site name from Settings > General |
{site_url} |
Site homepage URL |
{admin_url} |
Admin URL to view results or responses |
{date} |
Completion or vote date |
{response_id} |
Response or vote ID |
Customizing Email Templates
Section titled “Customizing Email Templates”Each email type has a rich text editor for composing the message body. You can use HTML formatting, add links, and include any of the placeholders listed above.
Leave subject or message fields empty to use the built-in default templates.
Troubleshooting
Section titled “Troubleshooting”Emails not sending
Section titled “Emails not sending”- Verify your WordPress site can send emails. Install a plugin like WP Mail SMTP to use a reliable email provider.
- Check your spam or junk folder.
- Confirm the recipient email address is valid.
- Make sure the email type is enabled (toggle is on).
Placeholders not replacing
Section titled “Placeholders not replacing”- Ensure placeholders use the exact syntax with curly braces:
{title}not[title]. - Only the placeholders listed in the Available Placeholders table are supported.
Documentation by Wbcom Designs — docs.wbcomdesigns.com