# SurveyNinja

> SurveyNinja is an online survey builder for customer feedback, market research, quizzes and forms: question types from multiple choice and NPS to matrix, ranking and click tests, logic and scoring, surveys created with AI, reports with AI analysis, integrations, a REST API and an MCP server.

Below is the SurveyNinja knowledge base, section by section: how to create, set up, share and analyse surveys. Articles about paid features say which plans include them.

## Getting Started

Create your first survey from scratch, from a template or with AI, import one from another service and preview it before sharing.

### Basics

- [Getting Started with SurveyNinja](https://surveyninja.io/help/about-surveyninja): Create and publish your first survey and find your way around the main sections of your account.
- [Creating a Survey with AI](https://surveyninja.io/help/create-survey-with-ai): Describe the survey in plain words and get a ready draft with questions, options and logic.
- [Importing Surveys and Responses](https://surveyninja.io/help/importing-surveys): Move surveys from Typeform and Google Forms, and upload responses from a CSV or Excel file.
- [Ninja AI: the Assistant in the Builder](https://surveyninja.io/help/ninja-ai): Build and edit a survey by chatting: questions, logic, design and settings, with every change shown before it's applied.
- [Custom Templates](https://surveyninja.io/help/custom-templates): Turn a survey into a template and reuse its questions, logic and design in new surveys.
- [Previewing Your Survey](https://surveyninja.io/help/previewing-your-survey): Check how the survey looks and works on different screens before you share it.

### Step-by-step guides

- [How to Run an NPS Survey](https://surveyninja.io/help/run-nps-survey): A Net Promoter Score survey from start to finish: the question, the follow-up, sharing and the result.
- [How to Create a Quiz with Scores](https://surveyninja.io/help/create-quiz): A quiz from start to finish: correct answers, points, a score on the last screen, a time limit and results.
- [How to Collect Leads with a Form on Your Website](https://surveyninja.io/help/collect-leads-on-website): A short lead form on your website, from the questions to email alerts, a spreadsheet or CRM and conversion tracking.

## Questions

Every question type in SurveyNinja, from multiple choice and NPS to matrix, ranking and click tests, with settings, limits and results.

### Overview

- [Question Types](https://surveyninja.io/help/question-types): All question types and screens in the builder, grouped by purpose, with links to their articles.
- [Question Settings](https://surveyninja.io/help/question-settings): The question toolbar and the settings that most question types share.
- [Welcome, Thank You and Other Survey Screens](https://surveyninja.io/help/survey-screens): Start and end screens, messages between questions and the submit button with consent to data processing.
- [Adding Multimedia](https://surveyninja.io/help/adding-multimedia): Add an image, a video or an audio file to a question, the Welcome Screen or a Thank You Screen.

### Choice questions

- [Single and Multiple Choice Questions](https://surveyninja.io/help/choice-questions): Radio Button, Multiple Choice, Dropdown and Yes or No: settings, what respondents see and how answers look in the report and export.
- [Media Choice Questions](https://surveyninja.io/help/media-choice): Answer options as images, videos or audio clips: uploading, layout, limits and results.

### Scales and ratings

- [Star and Emoji Rating Questions](https://surveyninja.io/help/rating-questions): Rating with stars and other icons and Smile rating with faces: settings, follow-up question and results.
- [Opinion Scale and Slider](https://surveyninja.io/help/opinion-scale): Numbered scales, Likert scale questions and sliders: settings, what respondents see and how the report groups answers.
- [Net Promoter Score (NPS) Question](https://surveyninja.io/help/nps-question): The 0–10 "How likely are you to recommend us?" question and how the report calculates the Net Promoter Score.
- [Semantic Differential Questions](https://surveyninja.io/help/semantic-differential): Respondents place a brand or product on 5-point scales between pairs of opposite words.

### Matrix, ranking and comparison

- [Matrix and Matrix 3D Questions](https://surveyninja.io/help/matrix-questions): Rate several rows on the same columns, or answer each cell from a dropdown in Matrix 3D.
- [Ranking Questions](https://surveyninja.io/help/ranking-question): Respondents put options in order of preference, and the report shows each option's average position.
- [Allocation Slider (Constant Sum Question)](https://surveyninja.io/help/allocation-slider): Respondents split a fixed number of points among options, which shows how much more one option matters than another.
- [Paired Comparison Questions](https://surveyninja.io/help/paired-comparison): Respondents choose one option from each pair, and the report shows how often each option beats every other.

### Image and map tests

- [Click Test, Hotspot and Area Selection](https://surveyninja.io/help/image-tests): Three questions on your image: clicks, outlined areas and ready-made regions to choose from.
- [Map Questions](https://surveyninja.io/help/map-question): Respondents mark places on a map, and you get place names and coordinates.

### Contacts, files and booking

- [Name, Email, Phone and Date Fields](https://surveyninja.io/help/contact-fields): Fields for a name, email, phone number and date, with validation and formats.
- [File Upload Questions](https://surveyninja.io/help/file-upload): Respondents attach files to the survey: formats, size limits, where to find and download the files.
- [Online Booking](https://surveyninja.io/help/online-booking): Add a Booking question so respondents pick a free time slot, and manage schedules and bookings in one place.

## Logic and Scoring

Send respondents down different paths, screen them out with quotas, pass data with hidden variables and score answers as a quiz.

- [Logic Jumps](https://surveyninja.io/help/logic-jumps): Send respondents to different questions or screens depending on their answers.
- [Logic Map, Disqualification and Quotas](https://surveyninja.io/help/disqualification-and-quotas): See all survey routes on a map, screen out respondents who don't fit and set answer quotas.
- [Hidden Variables](https://surveyninja.io/help/hidden-variables): Pass data you already have, such as a traffic source or an order number, in the survey link and get it with every response.
- [Reusing Answers in Survey Questions](https://surveyninja.io/help/reusing-answers-in-survey-questions): Use a respondent's earlier answer in the text of later questions, for example to address them by name.
- [Scores, Correct Answers and Personality Tests](https://surveyninja.io/help/scoring): Turn a survey into a quiz or a personality test: correct answers, points, categories and results that depend on the score.
- [A/B Test for Questions](https://surveyninja.io/help/ab-test): Show respondents different versions of a question and compare which one more of them finish.

## Design and Settings

Change the design of a survey, set response limits, deadlines and timers, turn on email notifications and issue promo codes.

- [Survey Settings](https://surveyninja.io/help/setting-survey): A reference of all survey settings: what each one does and where to find it.
- [Survey Version History](https://surveyninja.io/help/version-history): Find earlier published versions of a survey and restore one to the builder.
- [Design Setup](https://surveyninja.io/help/design-setup): Change how the survey looks with gallery themes or your own theme.
- [Survey Language and Standard Labels](https://surveyninja.io/help/survey-language): Choose the language of buttons and system messages in a survey and replace them with your own text.
- [Response Limit and Survey Deadline](https://surveyninja.io/help/configuring-limits): Stop collecting responses automatically on a date or after a set number of responses.
- [Timers and Scheduled Access](https://surveyninja.io/help/timers-and-schedule): Limit how long respondents have for the survey or a question, and open the survey only on set days and hours.
- [Email Notifications](https://surveyninja.io/help/notifications): Get an email about each new response and send respondents a thank-you email after they finish the survey.
- [Issuing Promo Codes to Respondents](https://surveyninja.io/help/promo-codes): Give every respondent who completes the survey a unique promo code from your list.
- [Why Don't I Get Email Notifications About New Responses?](https://surveyninja.io/help/notifications-not-arriving): What to check when emails about new responses or thank-you emails to respondents don't arrive.

## Sharing

Publish a survey by link, embed it on your website, send unique links, connect your own domain, protect access and close the survey.

- [Publishing a Survey and Adding It to a Website](https://surveyninja.io/help/publishing-your-survey): Publish the survey, then share the link or add the survey to your website, a QR code or a printed form.
- [Unique Survey Links](https://surveyninja.io/help/unique-links): A separate survey link for each person, department or channel, with response limits and tracking.
- [QR Code and Printed Survey](https://surveyninja.io/help/qr-code): Design and download the survey QR code, print it on a sheet, card or sticker, or save the survey as PDF or Word for paper.
- [Micro Surveys on Your Website](https://surveyninja.io/help/micro-surveys): A short survey in a corner of your website: add the code once and choose when and to whom it appears.
- [Custom Domain for Survey Links](https://surveyninja.io/help/custom-domain): How to change the survey link address and attach your own domain.
- [Sharing Your Survey on Social Media](https://surveyninja.io/help/sharing-your-survey-to-social-media): Set up how the survey link looks in a feed and post it to a social network.
- [Survey Access and Protection](https://surveyninja.io/help/survey-access): Choose who can take the survey and how many times: passwords, email codes, repeat responses, captcha, IP lists and devices.
- [How to Close a Published Survey](https://surveyninja.io/help/how-to-close-a-published-survey): Stop collecting responses, choose what respondents see on the survey link and reopen the survey when you need it.
- [Why Can't Respondents Open My Survey?](https://surveyninja.io/help/survey-not-opening): What respondents see when a survey doesn't open, why it happens and where to fix it.

## Results

Read the survey report and the AI report, filter and download responses, handle incomplete and old responses and share the results.

- [Survey Summary](https://surveyninja.io/help/survey-summary): Visits, completed and incomplete responses, completion rate, activity by day, devices, countries and average time on one page.
- [Viewing the Survey Report](https://surveyninja.io/help/viewing-survey-report): Results question by question with charts, filters and export to PDF or DOC.
- [Smart Analytics: AI Report on Responses](https://surveyninja.io/help/smart-analytics): How to create an AI report on survey responses, keep it up to date and share it as a PDF or a link.
- [Viewing and Downloading Survey Responses](https://surveyninja.io/help/viewing-and-downloading): Each response separately, with filters and export to CSV, XLSX, DOC or SPSS.
- [Filtering and Tagging Responses](https://surveyninja.io/help/filters-and-tags): Filter responses and reports by answers, dates, scores and more, and mark responses with tags.
- [Incomplete Responses](https://surveyninja.io/help/incomplete-responses): Answers from respondents who started the survey but left before the end.
- [Deleting Responses](https://surveyninja.io/help/deleting-responses): Move responses to Deleted, restore them or delete them permanently.
- [How to Share Results](https://surveyninja.io/help/how-to-share-results): A public link to the report, summary or responses that anyone can open without an account.
- [Old Responses and Question Versions](https://surveyninja.io/help/old-responses): What happens to collected responses when you edit a question, and how to see or merge them.
- [Why Don't I See All Responses?](https://surveyninja.io/help/missing-responses): Why responses are missing from Results or counted differently, and how to bring them back.

## Team and Workspaces

Invite members and set their roles, organize surveys into workspaces and move surveys you no longer use to the archive.

- [Team Members and Roles](https://surveyninja.io/help/collaborative-survey): Invite colleagues, choose which workspaces they see and what their role lets them do.
- [Workspaces (Folders)](https://surveyninja.io/help/folders): Group surveys into workspaces on the dashboard and move surveys between them.
- [Survey Archive](https://surveyninja.io/help/archive): Hide surveys from the dashboard without deleting them and bring them back when you need them.

## Account and Billing

Buy or change a plan, see what happens after the trial, protect your account with two-factor authentication and SSO, and send email from your SMTP.

- [Plans and Limits](https://surveyninja.io/help/plans-and-limits): Limits and features of the Free, Basic, Standard, Premium and Enterprise plans, and how the monthly response limit works.
- [How to Buy a Plan](https://surveyninja.io/help/buy-plan): How to choose a plan and period, use a promo code, pay by card and turn off auto-pay.
- [What Happens After the Trial Ends?](https://surveyninja.io/help/after-trial): The 14-day Premium trial, how to check the days left and what the Free plan changes.
- [Account Settings](https://surveyninja.io/help/account-settings): How to change your name, email, password, language and time zone, manage sessions and delete your account.
- [Two-Factor Authentication](https://surveyninja.io/help/2fa): How to protect your account with a one-time code from an authenticator app.
- [SSO Configuration](https://surveyninja.io/help/sso): How to connect an OpenID Connect identity provider for team sign-in and SSO-only surveys.
- [Custom SMTP Server](https://surveyninja.io/help/smtp): How to send survey emails through your own SMTP server and check what was sent.
- [Custom File Storage](https://surveyninja.io/help/own-storage): Store respondents' files and uploaded media in your own S3 bucket so they don't count toward your plan's storage.
- [SurveyNinja Affiliate Program](https://surveyninja.io/help/cpa): How to create referral links, read affiliate statistics and withdraw your commission.
- [Why Is a Question Type or Feature Locked?](https://surveyninja.io/help/feature-locked): Why something shows a $ icon or an Upgrade button, what happens to existing surveys and how to change the plan.

## Integrations

Send responses to Google Sheets, webhooks and Telegram, track surveys in Google Analytics and Meta Pixel, and work with surveys through the API and MCP.

- [Google Sheets](https://surveyninja.io/help/google-sheets): How to send survey responses to a new or existing Google Sheets spreadsheet.
- [Webhooks](https://surveyninja.io/help/webhooks): How to send survey responses to your server as JSON and check delivery in the logs.
- [API](https://surveyninja.io/help/api): How to create an API key and get surveys and responses through the SurveyNinja REST API.
- [Connecting AI Assistants (MCP)](https://surveyninja.io/help/mcp): How to connect an AI assistant to SurveyNinja over MCP and what it can do with your surveys.
- [Telegram](https://surveyninja.io/help/telegram): How to receive survey responses in a Telegram chat or group through the SurveyNinja bot.
- [Google Analytics](https://surveyninja.io/help/google-analytics): How to add a Google Analytics 4 Measurement ID to a survey and track survey events.
- [Meta Pixel](https://surveyninja.io/help/meta): How to add a Meta Pixel ID to a survey and what the pixel tracks.
- [Why Aren't Responses Reaching Google Sheets, Webhooks or Telegram?](https://surveyninja.io/help/integration-not-sending): Why responses don't arrive in a connected integration and how to fix each cause.

## Product

- [Pricing](https://surveyninja.io/pricing): plans, limits and what each plan includes
- [Features](https://surveyninja.io/features): what SurveyNinja can do
- [Survey templates](https://surveyninja.io/templates): ready-made surveys to start from
- [API reference](https://surveyninja.io/dev/api): the REST API for surveys and responses
- [MCP server](https://surveyninja.io/features/mcp-server): connect Claude, ChatGPT, Cursor and other assistants to SurveyNinja

## AI skills

- [Agent skills for surveys](https://surveyninja.io/skills): 25 free agent skills (SKILL.md files) that teach Claude Code, Codex, Cursor and Gemini CLI to build, launch and analyze SurveyNinja surveys over MCP.
- [A/B variant analysis](https://surveyninja.io/skills/ab-significance): Tells you whether the difference between variants is real or just noise ([SKILL.md](https://surveyninja.io/skills/ab-significance.md))
- [Workspace audit](https://surveyninja.io/skills/account-audit): Shows in one report where your workspace is losing responses, storage and attention ([SKILL.md](https://surveyninja.io/skills/account-audit.md))
- [New response notifications](https://surveyninja.io/skills/answer-notifications): Sets up where new responses are announced, by email or in Telegram, and fixes it when they stop arriving ([SKILL.md](https://surveyninja.io/skills/answer-notifications.md))
- [Cleaning up responses](https://surveyninja.io/skills/answers-cleanup): Removes test runs and duplicates from your results and shows you the list before anything goes ([SKILL.md](https://surveyninja.io/skills/answers-cleanup.md))
- [Comparing with past results](https://surveyninja.io/skills/benchmark): Compares a survey with its own past, because one figure means little and a change says a lot ([SKILL.md](https://surveyninja.io/skills/benchmark.md))
- [Data quality check](https://surveyninja.io/skills/data-quality): Tells you whether the responses can be trusted before anyone builds conclusions on them ([SKILL.md](https://surveyninja.io/skills/data-quality.md))
- [Why responses are not delivered](https://surveyninja.io/skills/integration-triage): Finds why responses never reach your Telegram, Google Sheet, Zapier or webhook, and what to do about it ([SKILL.md](https://surveyninja.io/skills/integration-triage.md))
- [Launch kit](https://surveyninja.io/skills/launch-kit): Puts the whole launch together at once: labeled links, announcement copy for each channel and a QR code ([SKILL.md](https://surveyninja.io/skills/launch-kit.md))
- [Lead quality](https://surveyninja.io/skills/lead-quality): Counts the people who left a contact you can actually use ([SKILL.md](https://surveyninja.io/skills/lead-quality.md))
- [Analyze open-ended answers](https://surveyninja.io/skills/open-answers): Turns a hundred lines of free text into a handful of themes with numbers and quotes ([SKILL.md](https://surveyninja.io/skills/open-answers.md))
- [Pre-launch check](https://surveyninja.io/skills/prelaunch-check): Finds what will break on real respondents while the link is still unsent ([SKILL.md](https://surveyninja.io/skills/prelaunch-check.md))
- [Report and survey styling](https://surveyninja.io/skills/report-appearance): Tidies up what people see from outside: the survey theme, the report colors and the logo ([SKILL.md](https://surveyninja.io/skills/report-appearance.md))
- [Completion funnel](https://surveyninja.io/skills/response-funnel): Shows which question makes people close the tab, and why ([SKILL.md](https://surveyninja.io/skills/response-funnel.md))
- [Survey results summary](https://surveyninja.io/skills/results-digest): Answers "so what did the survey say" with figures and a conclusion instead of a raw export ([SKILL.md](https://surveyninja.io/skills/results-digest.md))
- [Results for the client](https://surveyninja.io/skills/results-sharing): Turns survey results into something you can send: a link, a file or a report with conclusions ([SKILL.md](https://surveyninja.io/skills/results-sharing.md))
- [How many responses you need](https://surveyninja.io/skills/sample-size): Tells you whether what you have is enough and how many more responses you need before conclusions hold ([SKILL.md](https://surveyninja.io/skills/sample-size.md))
- [Comparing traffic sources](https://surveyninja.io/skills/source-dashboard): Shows which channel brought the right people and which only brought numbers ([SKILL.md](https://surveyninja.io/skills/source-dashboard.md))
- [Rewrite survey copy](https://surveyninja.io/skills/survey-copy): Rewrites your questions so people finish the survey, starting from the data rather than taste ([SKILL.md](https://surveyninja.io/skills/survey-copy.md))
- [Distribute the survey](https://surveyninja.io/skills/survey-distribution): Gets the survey ready to hand out so you can still tell which channel each response came from ([SKILL.md](https://surveyninja.io/skills/survey-distribution.md))
- [Build a survey from a brief](https://surveyninja.io/skills/survey-from-brief): Describe what you need in plain words, and the assistant builds the survey in your SurveyNinja account as a draft ([SKILL.md](https://surveyninja.io/skills/survey-from-brief.md))
- [Skip logic and branching](https://surveyninja.io/skills/survey-logic): Sets up survey logic so that no respondent ever hits a dead end ([SKILL.md](https://surveyninja.io/skills/survey-logic.md))
- [Survey timeline](https://surveyninja.io/skills/survey-timeline): Answers “why did responses stop” by lining up collection against the edit history ([SKILL.md](https://surveyninja.io/skills/survey-timeline.md))
- [Webhook setup](https://surveyninja.io/skills/webhook-setup): Sends survey responses to your own address and checks that the receiver accepted them ([SKILL.md](https://surveyninja.io/skills/webhook-setup.md))
- [Members and access](https://surveyninja.io/skills/workspace-access): Finds out why a colleague cannot see the surveys and grants exactly the rights they need ([SKILL.md](https://surveyninja.io/skills/workspace-access.md))
- [Tidying up the account](https://surveyninja.io/skills/workspace-housekeeping): Sorts, archives, copies and cleans, and knows which of those cannot be undone ([SKILL.md](https://surveyninja.io/skills/workspace-housekeeping.md))

## Comparisons

- [SurveyNinja vs other survey tools](https://surveyninja.io/compare): prices for the same number of responses, features and how to switch, checked on each tool's own website
- [SurveyNinja vs SurveyMonkey](https://surveyninja.io/compare/surveymonkey): Your research for a fraction of the price
- [SurveyNinja vs Qualtrics](https://surveyninja.io/compare/qualtrics): Research tools without a sales call
- [SurveyNinja vs QuestionPro](https://surveyninja.io/compare/questionpro): One price for the team, heatmaps from Basic
- [SurveyNinja vs Alchemer](https://surveyninja.io/compare/alchemer): SPSS export on the Free plan, not for $1,895 per user a year
- [SurveyNinja vs SurveySparrow](https://surveyninja.io/compare/surveysparrow): 5,000 responses a month at $25.90/mo instead of $275/mo
- [SurveyNinja vs LimeSurvey](https://surveyninja.io/compare/limesurvey): 100 free responses a month and no server to run
- [SurveyNinja vs Zoho Survey](https://surveyninja.io/compare/zoho-survey): 3 users and no branding for $25.90/mo
- [SurveyNinja vs SurveyLegend](https://surveyninja.io/compare/surveylegend): Export your answers, drop the watermark
- [SurveyNinja vs Typeform](https://surveyninja.io/compare/typeform): 100 free responses a month instead of 10
- [SurveyNinja vs Google Forms](https://surveyninja.io/compare/googleforms): Your logo on the survey, an AI report on the answers
- [SurveyNinja vs Microsoft Forms](https://surveyninja.io/compare/microsoftforms): More than a form and an Excel file
- [SurveyNinja vs Jotform](https://surveyninja.io/compare/jotform): 5,000 responses and 3 users for $25.90/mo
- [SurveyNinja vs Tally](https://surveyninja.io/compare/tally): Results you can share with your team or client
- [SurveyNinja vs Paperform](https://surveyninja.io/compare/paperform): 100 free responses a month, then $10.50/mo for 1,000
- [SurveyNinja vs Formstack](https://surveyninja.io/compare/formstack): A free plan where Formstack starts at $99 a month
- [SurveyNinja vs Wufoo](https://surveyninja.io/compare/wufoo): 10,000 responses a month for $48.30/mo instead of $83.25/mo
- [SurveyNinja vs Cognito Forms](https://surveyninja.io/compare/cognito-forms): 20,000 responses and a shareable report for $48.30/mo
- [SurveyNinja vs 123FormBuilder](https://surveyninja.io/compare/123formbuilder): 1,000 responses with NPS and SPSS for $10.50/mo
- [SurveyNinja vs HubSpot Forms](https://surveyninja.io/compare/hubspot-forms): Surveys without a Service Hub seat
- [SurveyNinja vs Delighted](https://surveyninja.io/compare/delighted): Delighted has closed. Keep your NPS running on SurveyNinja
- [SurveyNinja vs Mentimeter](https://surveyninja.io/compare/mentimeter): Surveys that live past the meeting

## Switching to SurveyNinja

- [Switch to SurveyNinja: Import Surveys with Every Response](https://surveyninja.io/migrate-from): Move to SurveyNinja with every response: Typeform and Google Forms in one click, any other tool through AI and a CSV or Excel upload.
- [Move from Typeform to SurveyNinja with Every Response](https://surveyninja.io/migrate-from/typeform): Import your Typeform in one click on any plan: questions, logic jumps, scores and end screens. Switch on response transfer and every response comes along.
- [Move from Google Forms to SurveyNinja with Every Response](https://surveyninja.io/migrate-from/google-forms): Import a Google Form in one click on any plan: every question type, from grids to file uploads. Switch on response transfer and your whole history comes along.
- [Switch from SurveyMonkey to SurveyNinja, Keep Every Response](https://surveyninja.io/migrate-from/surveymonkey): Rebuild your SurveyMonkey survey with the AI generator, then upload your CSV or Excel export: every response with its original date. Our team helps too.
- [Switch from Microsoft Forms to SurveyNinja, Keep Responses](https://surveyninja.io/migrate-from/microsoft-forms): Rebuild your Microsoft Form with the AI generator, then upload the Excel file of responses: every answer with its date.
- [Switch to SurveyNinja from Any Survey Tool](https://surveyninja.io/migrate-from/other): Moving from Qualtrics, Jotform, Tally or another tool? Rebuild your survey with AI, upload responses from CSV or Excel, and let our team help with the rest.
- [How to Create a Survey in Excel (and a Faster Way)](https://surveyninja.io/migrate-from/excel-csv): Two ways to make a survey in Excel, step by step, and how to get an online survey with results ready for Excel in minutes. Upload answers you already have, too.

## Optional

- [Knowledge base in Spanish](https://surveyninja.io/es/llms.txt)
- [Knowledge base in Portuguese](https://surveyninja.io/pt/llms.txt)
