Skip to content

A survey bundles several standalone polls into one questionnaire. Respondents answer the polls one after another, and WB Polls stores their answers together as one response.

Surveys work with or without BuddyPress.

  • Each question is a standalone poll that you create first.
  • Respondents see one question at a time with Previous and Next buttons and a “Question X of Y” progress indicator.
  • A response is stored when the respondent clicks Submit Survey.
  • Admins read responses and charts in WP admin and can export them.

You need at least one published standalone poll for each question.

  1. Go to WP Admin > WB Surveys > Add New.
  2. Enter a title and a description. Both show on the survey start screen.
  3. In the Questions box, pick a poll from Add Poll and click Add. Repeat for each question.
  4. Drag the questions into order. Remove a question with its remove button.
  5. Set access, email, results and notification options in the boxes on the screen (see below).
  6. Click Publish.

Survey Edit Screen

Only a published survey can be taken. A draft or pending survey shows “Survey not found or not available.” The list at WB Surveys > All Surveys has Questions, Responses and Status columns.

Only administrators, and roles you pick in Survey Settings, can create surveys. See Survey Settings.

Option Who can take it
Anyone (Public) Everyone, including logged-out visitors
Logged-in Users Only Only logged-in members
Specific User Roles Logged-in members with a selected role. If BuddyPress member types are available you can also pick member types; a member must then match one of them too
Password Protected Visitors who enter the survey password

New surveys start with the default access level from Survey Settings.

Option What it does
Require Email Asks for an email address before the survey starts. Logged-in members use their account email.
Allow Re-submission Lets the same person submit the survey more than once. When off, a repeat visitor sees “already completed”.
Lead Capture Gate Requires an email to see the survey results.
GDPR Consent Text Consent text shown when email addresses are collected.
Expiry Date The survey stops accepting responses after this date. Leave empty for no expiry.
Response Limit The most responses the survey accepts. Leave empty or 0 for no limit.

New surveys take the defaults for Require Email, Allow Re-submission and Show Results from Survey Settings.

Option What it does
Thank You Message Shown after the respondent submits.
Show Results Shows the combined answer results after submission.
Redirect URL Sends the respondent to this address after the thank-you message.
Redirect Delay Seconds to wait before the redirect (0 to 60; 0 is immediate).
Option What it does
Admin Notifications Emails you when someone completes the survey. On by default for new surveys.
Notification Email The address that gets the notice. Empty uses the site admin email.
Respondent Notifications Sends a confirmation to the respondent. Needs the respondent’s email, and also needs the Completion Confirmation email turned on in Email Settings.
Email Subject, Email Message Your own text for the respondent email. Placeholders: {survey_title}, {user_name}, {user_email}, {response_id}, {completed_date}, {site_name}, {site_url}.

The Email Settings tab also turns the admin notice on or off for every survey at once.

Each survey has a Stats box with Views, Started, Completed and Completion Rate (completed divided by started). A View Responses button appears once someone has completed it.

  • Shortcode: paste [wbsurvey id="123"] into a page or post. The survey editor shows the exact shortcode. The shortcode takes only the id attribute.
  • Direct link: every survey has its own page at an address like yoursite.com/survey/survey-title/. The survey archive is at yoursite.com/survey/.
  1. Open the survey link. The start screen shows the survey title and description.
  2. Enter an email address if the survey asks for one, and accept the consent text if shown.
  3. Click Start Survey.
  4. Answer each question and click Next. Use Previous to go back and change an answer.
  5. On the last question click Submit Survey.
  6. Read the thank-you message, or wait for the redirect. Results show if Show Results is on.

If a survey is closed to the member, a message says why: login required, no permission, password needed, expired, response limit reached, or already completed.

Go to WB Surveys > Responses to see responses across surveys, or open a survey and click View Responses. See Survey Responses. For charts per question, open WB Surveys > Analytics.

Where What
wbsurvey posts The surveys
wp_wbsurvey_responses One row per response
wp_wbsurvey_response_meta Extra data per response
wp_wbsurvey_leads Emails collected at the lead gate

Survey settings are post meta with the _wbsurvey_ prefix, for example _wbsurvey_poll_ids for the question list. The respondent’s IP address and browser string are stored with each response.