Before you start
A survey that runs on WhatsApp can also be answered in a web browser, on a phone or a computer. It is the same survey: the same questions, the same logic and the same reports.
- You need to be able to edit the survey. Everyone else can see how a survey is shared, but only people who can edit it can change anything.
- The survey must be one that can go on the web. Most can. Live events, quizzes, presentations, AI interviews and a few WhatsApp-only question types can't: see what can't go on the web.
- The survey takes answers only while it is active. You can switch sharing on before it starts, but until the survey is active (and after its end date) people who open it see “This survey is closed.” Use Preview to try it out in the meantime.
Can't find the Share on the web card on your survey's page? Email support@surveyr.africa or ask your Surveyr contact.
Switch on sharing
Switch it on from the survey's page, where every web setting lives, or straight from the Activities list.
Open the survey's page
- In Activities, open the survey and go to its Overview tab.
- Find the Share on the web card.
Turn on the switch
- Turn on the switch at the top right of the card.
- The card now shows the survey's link, a QR code and two pieces of website code, Inline and Popup.
- If the switch won't turn on, the card lists why under “This survey can't go on the web yet”. Fix what it names, or see what can't go on the web.
Switching sharing off and on again keeps the same link. To retire a link for good, make a new link.
Or switch it on from the Activities list
- In Activities, click the QR code button (or the Copy link button) on the survey's row.
- In the pop-up, choose Web. The pop-up always opens on WhatsApp first.
- Click Switch on Share on the web, then Switch on to confirm. The pop-up then shows the web link and its QR code.
- The other settings (your website, where to send people at the end) are on the survey's page.
Tip: Organisation owners can see every change to web sharing, and who made it, in Settings → Activity.
Share the link and QR code
The link opens the survey in any browser. It starts with https://www.surveyr.africa/s/, followed by the survey's own code.
- Click Copy next to the link on the card, and paste it anywhere: an SMS, a newsletter, a social media post, a button on your website.
- People can scan the QR code with their phone camera to open the survey. It works well on posters, flyers, till slips and tables.
- To print the QR code, use the Activities list: click the QR code button on the survey's row, choose Web, then Download. You get a PNG image, ready for a poster.
Tip: Want the survey to open only on your own website, not from the link? Switch off Also allow the plain link and QR code (Part 5).
Put it on your website
The card gives you two pieces of website code, with the survey's own code already filled in. Copy the one you want with its Copy button, and paste it into your website or send it to whoever looks after your site.
| Code | What people see | Where to paste it |
|---|---|---|
| Inline | The survey inside your page, as part of it. It grows to fit each question. | Where the survey should appear on the page, in your website builder's HTML or embed block. Keep both lines: the second one makes the survey grow to fit. |
| Popup | A “Give feedback” button in the bottom right corner. Clicking it opens the survey over the page; people close it with × or Esc. | Once on each page that should show the button, for example in your site's footer or just before </body>. |
Change the popup button. Edit data-button-text="Give feedback" in the popup code to use your own words, and add data-button-color="#1A7F5A" (any colour written as a hex code) to match your site. The button's text turns black or white, whichever reads better on your colour.
Answers given on your website are real answers, even while you're testing: they're saved, and they use credits. To try the survey without saving anything, use Preview.
Tip: For your web developer: when someone finishes, the page receives a surveyr:completed event, so your site can react (for example, by showing a message of its own). It never carries any answers.
Choose where it can appear
Two settings on the card decide where the survey may be shown.
Only these websites may show this survey. Type your website's address and click Add (or press Enter). With the list empty, any website may show the survey; once you add one or more, only those websites can show it in their pages. You can paste a full address such as https://www.example.co.za/feedback: Surveyr keeps just the website part.
example.co.zaandwww.example.co.zaare different addresses. Add each one your site uses.*.example.co.zacovers every sub-domain, such aswww.example.co.zaandshop.example.co.za, but notexample.co.zaitself.- Your website must use
https://. A listed website on plainhttp://can't show the survey.
Also allow the plain link and QR code. On by default. Switch it off and the survey only opens inside your website, on the websites in the list. Anyone who opens the link directly sees “This survey is only available on example.co.za.” (with your own website's name). Personal links still work, because your organisation sent them.
This setting keeps the survey on your website; it isn't a password. If only certain people may answer, make the survey private and send personal links.
Send people somewhere at the end
When someone answers the last question, they see the survey's closing message, with its closing image or video if it has one.
To send them on to a page of your own, such as a thank-you page or a voucher, type its address under After the last question, send people to and click Save. It must start with https://. To stop sending people on, clear the box and click Save.
- From the link or QR code, people see the closing message, then go to your page on their own after a moment.
- Inside your website, they see the closing message with a Continue button that takes them to your page. (A survey shown inside your page isn't allowed to move the whole page by itself.)
- People who choose not to take part at the welcome screen aren't sent anywhere.
Preview, and make a new link
Preview opens the survey in a new tab, exactly as people will see it. Preview answers are never saved or charged, so try every path you like. It works even while sharing is off or the survey is still a draft. A preview link works for an hour; after that, click Preview again.
New link gives the survey a new address, for when the link has gone somewhere it shouldn't. Surveyr asks you to confirm first, because:
- The old link, QR code and website code stop working straight away. Share the new ones, and update the code on your website.
- Personal links already sent stop working too.
- People who have already started can finish.
Personal links
A personal link opens the survey for one person you already know from WhatsApp or email. Their answers are saved under their own name and number, not as a website visitor.
From WhatsApp: Complete Online
- When someone sends an answer the survey can't use, Surveyr offers Retry, Restart and Complete Online.
- When the survey is shared on the web, Complete Online sends them their own link to finish in a web browser.
- On the web they start again from the first question. What they answered on WhatsApp is kept as an unfinished form.
From email: a survey button that opens in a web browser
- In the email designer, add a button, set Opens to Survey and choose the survey.
- Under Opens in, choose Web browser. The survey must be shared on the web first.
- When the email goes out, each person's button carries their own link.
- Review won't send the email while the survey isn't shared on the web. If sharing is switched off while the email is still going out, the emails not yet sent get a button that opens the survey in WhatsApp instead.
Every personal link:
- works for 7 days;
- belongs to the person it was sent to: answers given through it are saved as theirs, so it shouldn't be forwarded;
- counts all their answers: if the survey doesn't allow repeat responses and they've already answered it, on WhatsApp or on the web, they see “You've already answered this survey. Thank you!”;
- works even when Also allow the plain link and QR code is off;
- never changes their saved contact details: hidden fields on it are kept with the response only.
An expired link never opens the survey as someone else. It says “This link has expired or is no longer valid. Ask whoever sent it for a new one.” Send them a fresh email.
Private surveys
A private survey is only for the people in its panel. On the web it works through personal links only.
- Switch on sharing as usual. The card says Personal links only: there is no public link, QR code or website code, and no website settings.
- Reach people with an email whose survey button opens in a web browser (Part 9), or through Complete Online in WhatsApp.
- Before anyone starts, Surveyr checks that they're in the survey's panel, the same check as on WhatsApp. Anyone else sees “This survey is only open to the people it was sent to.”
- Someone who opens the survey's address without a personal link sees “This survey is by invitation. Open it from the personal link you were sent.”
- Preview, New link and the end-of-survey address work as they do for any survey.
What people see
The survey shows one question per screen, with large buttons, on phones and computers. It follows exactly the same logic as on WhatsApp.
- A start screen with your logo, the survey's name and a Start button. A quick check that they're a person runs first (“Protected by Cloudflare”).
- A language choice, if the survey has more than one language. The browser's language is suggested when it matches one of them.
- The welcome message, with the survey's own consent buttons. Choosing not to take part ends the survey; nothing is saved or charged.
- The questions, one per screen, with a progress bar and “2 of 5” at the top. Back goes to the previous question: the answers after it are cleared, and the jumps are worked out again from there. On a computer, Enter continues and number keys pick options.
- The closing message, then your end-of-survey page if you set one.
The same logic as WhatsApp. Jumps, property rules, earlier answers piped into later questions, answer rules (with the same messages), the minimum and maximum on multi-select questions, follow-up questions after certain options, and translations all work as they do on WhatsApp.
| Question | On the web |
|---|---|
| Multiple Choice | A card for each option, with its description and emoji. |
| Reply Buttons | Buttons, with the question's image or video above them. |
| Multi-select list, Multi-select Form | Tick boxes, with a hint such as “Pick up to 3.” Continue works once enough are ticked. |
| Open Ended | A text box. With answer choices, the choices plus “Or type your own answer”. |
| Word Cloud | A short text box. |
| Location | Use my location, or Drop a pin on the map. |
A few things differ from WhatsApp:
- Answers are typed. Voice notes, photos and files can't be sent on the web.
- AI follow-up questions on open-ended answers aren't asked; the typed answer is saved as it is.
- The WhatsApp-only questions at the end (opting in to more messages, a testimonial) are left out.
- The form's own buttons (Start, Continue, Back) are in English for now. Your survey's questions and messages appear in the language the person chose.
The form uses your organisation's logo and colour (the ones set for your emails), or Surveyr's when none are set. A small “Made with Surveyr” link sits at the foot. If someone reloads the page partway through, they carry on where they left off.
Answers and reports
Web answers are saved as ordinary responses, beside your WhatsApp answers, in the same reports and exports.
- In the survey's Report tab, someone who answered from the link or your website shows as Website visitor, with a Web badge. People who answered from a personal link show with their own name and number.
- The export has a Channel column:
WhatsApp,Web, orWeb (Formbricks)for answers from the older online form. The Cell Number column readsWebsite visitorfor visitors, and each hidden field gets its ownHidden: <name>column. - If your organisation has linked a Google Sheet and switched this survey on (Send responses to Google Sheets on the survey's page), each finished web response is added as a row, as a WhatsApp one is, with the Channel column filled in.
- Your developers see web answers in the Surveyr API, with
sourceset toweband the hidden fields inhiddenFields. - Someone who answers several of your surveys in the same browser counts as one website visitor.
Unfinished forms. If someone stops partway and the page stays quiet for 30 minutes, what they answered so far is kept as an unfinished form, just as when a WhatsApp chat goes quiet. It isn't counted as a finished response, and it uses no credits. If they come back to it in the same browser tab and finish, the finished response takes its place. Your developers get unfinished forms through the Surveyr API, marked incomplete.
What can't go on the web
When a survey can't go on the web, the card's switch stays off and the card says why.
- Activities: live polls and other live events, quizzes, presentations, AI interviews, Forms (the Form activity type), and surveys sent as a WhatsApp Flow.
- Questions: WhatsApp Form questions and Workflow questions. The card names each one by its number; remove or replace them to share the survey.
- A survey that is part of a study.
- Any survey, while your organisation is suspended.
If you add a question the web can't show after sharing is on, new visitors see “This survey isn't available on the web right now” until you take it out.
The card may also say that website visitors need a database update, or that the bot check isn't set up yet. Those are for Surveyr to finish: email support@surveyr.africa.
Questions
Does a web response use credits?
Yes, in the same way as on WhatsApp: each finished response is charged to your organisation's credit balance, once. Opening the page, previews, people who decline at the welcome screen and unfinished forms use none. When your balance is used up, the web follows the same rule as WhatsApp for new people: if they're being turned away, visitors see “This survey isn't taking answers right now.”
Is it safe to put on our website?
Yes. The survey runs in a frame served by Surveyr, so it can't read your page, and your page's styles can't break it; the popup code only adds its button and that frame. People don't log in. Before each start, Cloudflare checks that the visitor is a person, and there are limits on how fast surveys can be started and answered, to stop floods of fake answers. You choose which websites may show it (Part 5). Surveyr doesn't store visitors' IP addresses.
Can someone answer twice?
With Allow repeat responses off, someone who has finished the survey sees “You've already answered this survey. Thank you!” the next time. For website visitors, their browser remembers this, so someone on another browser or device, or who clears their browser, can answer again. With a personal link it follows the person instead, and counts their WhatsApp answers too. Turn Allow repeat responses on to let people answer as often as they like.
What if we switch sharing off while someone is answering?
Their next tap shows “This survey is closed.” and the survey stops there. What they had answered is kept as an unfinished form after 30 quiet minutes. The link, QR code and website code stop working until you switch sharing back on; the link stays the same.
What if we edit the survey while it's shared?
People who start after you save get the new version (it can take up to about 20 seconds to show). Anyone already partway through finishes the version they started.
Can we change how the form looks?
It uses your organisation's logo and colour. There are no other style settings.
Need a hand? Email support@surveyr.africa or ask your Surveyr contact.
Surveyr