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 Plugins > WB Polls 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. This is a master switch: when it is off, no survey emails the admin, whatever a survey’s own setting says. When it is on, a survey emails only if Send email when survey is completed is ticked on that survey, and it can set its own notification email.
| 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. This switch is a master switch: a survey sends the email only when this is on and Send confirmation email to respondent is also ticked in that survey’s own Respondent Notifications setting. The respondent’s email must be known (logged in, or entered at the start).
| 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 has no recipient field because it goes to the respondent’s email address. Each survey can set its own subject and message for this email, which take priority over the text here.
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. Each email also has a Send test to me button that sends a sample to your own address.
| Placeholder | Replaced With |
|---|---|
{title} |
Survey or poll title |
{user_name} |
Voter or respondent name, or “Guest” for visitors who are not logged in |
{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 (the 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

