Surveys
Surveys are questionnaires displayed to WiFi users on the captive portal after login, or delivered via a campaign message. Collect structured feedback, measure satisfaction, and track Net Promoter Scores — all linked to your WiFi user base.
'alt' => 'Dashboard overview', 'caption' => 'The default Kiwire dashboard layout', 'screenshot' => true, 'class' => '', ]) Drop images into: public/assets/img/docs/{page}/{filename} --}}public/assets/img/docs/surveys/overview.png
Survey Workflow
The typical lifecycle of a survey in Kiwire:
- Create the survey — define the name, description, active dates, and build the question list.
- Assign to a journey — add the survey to a captive portal journey's success page so it appears automatically after a user logs in.
- Or send via campaign — use an Email or Push campaign to deliver a survey link to a specific user segment.
- Collect responses — users complete the survey; responses are stored against their account (or anonymously, depending on configuration).
- Review results — open the survey's Results tab to see per-question breakdowns, charts, and averages.
- Export — download all responses as a CSV for further analysis.
Question Types
| Type | Input | Best For |
|---|---|---|
single_choice | Radio buttons — one answer only | Preference selection, yes/no, demographic questions |
multiple_choice | Checkboxes — one or more answers | "Which services did you use?" style questions |
text | Open-ended text input | Comments, suggestions, free-form feedback |
rating | Star rating — 1 to 5 | Satisfaction scoring, quality rating |
nps | Number scale 0 to 10 | Net Promoter Score — "How likely are you to recommend us?" |
Keep surveys short — 3 to 5 questions is the sweet spot for completion rates on a captive portal. Use a rating or NPS question as the opener, then add one or two follow-up questions.
Survey Fields
| Field | Description |
|---|---|
name | Internal survey name — shown in the admin grid and journey configuration |
description | Optional intro text shown to users before the first question on the portal |
is_active | Only active surveys can receive new responses. Deactivate to freeze a survey after the collection period ends. |
questions | Ordered list of questions — drag to reorder, click to edit type and options |
start_date | Optional — Kiwire will not show the survey before this date |
end_date | Optional — Kiwire automatically deactivates the survey after this date |
public/assets/img/docs/surveys/question-builder.png
Response Collection
Surveys can collect responses in two modes, configured per-survey:
- Linked to user account — Responses are associated with the logged-in user's WiFi account. You can see which specific user submitted each response in the admin Results tab.
- Anonymous — Responses are stored without a user identifier. MAC address and session data are not stored. Use this mode when privacy is a priority or when required by your organisation's data policy.
Each user can only submit one response per survey (when linked mode is active). Kiwire prevents duplicate submissions by checking whether the user has already responded before showing the survey.
Viewing Results
Open a survey and switch to the Results tab to see an interactive breakdown:
- Choice questions — horizontal bar chart showing response counts and percentages per option.
- Rating questions — average score with a distribution bar chart.
- NPS questions — NPS score calculated as % Promoters (9–10) minus % Detractors (0–6), with a coloured gauge.
- Text questions — paginated list of all free-text responses.
public/assets/img/docs/surveys/results-view.png
Exporting Responses
Click Export CSV on the Results tab to download all responses. The CSV contains one row per response with columns for each question, the submission timestamp, and (in linked mode) the username. Use Excel, Google Sheets, or any BI tool to perform further analysis.
Required Permissions
view-surveys · create-surveys · update-surveys · delete-surveys