Form

What is the "Form" of a widget?

The layout of a feedback widget can be easily configured here in this tab.

You can design the widget's components of various fields such as the header, user emails, ticket assignees, checkboxes, poll options, etc.

It can also be viewed in the "Preview" section so not only can you decide what the contents and the text of questions and placeholders should be but also adjust their sequences accordingly.

This makes your widget customizable and easily adaptable based on the user experience.

Add additional custom fields to your feedback widget

A custom field can come in handy when you need your user to check out specific documentation for instance. It also allows you to ask for the phone number or if you have to add additional questions.

Usersnap's feedback widget can be customized with almost no limitations.

From the header to the disclaimer, from the raters to various fields, and from poll options to screenshots. All of the above-mentioned can be easily added or removed from your widget.

On the right part of the screen is the overview of your form and you can even go to "Preview" to test it in a demo environment.

General best practices

1. Capture qualitative answers with conditional questions

Having 2-4 fields on a form is the most engaging to get good response completions and depth of feedback insights.

Using a conditional follow-up question after rating questions further helps to build an interactive experience. Read more here

2. Ask relevant questions

First, you want to determine which points in the user journey you need feedback on. Then you can set up the widget buttons and pop-ups accordingly and craft a delightful, interactive journey.

Using event-based targeting to activate your survey forms is the most popular and successful method we have seen. You should know which events and KPIs are integral to your business's success. Examples include collecting feedback after:

  • Payments or checkout flows

  • Specific “Aha!” moments

  • Closing a conversation with a user

Make sure each user segment sees one event-based pop-up in their journey at a time.

3. Keep the form simple but still get rich context

Automate the collection of user information to reduce the fields that a user needs to fill out. For example, email, name, subscription package. These user data can be passed on with each feedback ticket once you have set up the custom data pull, read more here.

Keeping the form visually cohesive with your website is also important. However, for the button you may want to pick a noticeable color relative to your brand so your users know exactly where to give their feedback.

4. Evaluate your projects timely

For some survey use cases, you do not want to run your widget constantly, and you do not run it for only three days. Run it until you notice a trend.

Have a person in charge of each feedback form. Their ownership creates:

  • Purpose and accountability for the project

  • The opportunity to act on the feedback

When you're evaluating your project, you may also realize how you can optimize the form to collect higher quality of feedback.


","html_footer":"","html_body":"","html_promo":"\n Go to the Guides\n","javascript_hub2":"window.onUsersnapLoad = function(api) {\n api.init();\n };\n var script = document.createElement('script');\n script.defer = 1;\n script.src = 'https://widget.usersnap.com/global/load/ef0e60ee-2401-4479-884e-8e593d9b40f8?onload=onUsersnapLoad';\n document.getElementsByTagName('head')[0].appendChild(script);","javascript":"","stylesheet_hub2":"@import url('https://fonts.googleapis.com/css?family=Roboto:300,400');\n\nbody {\n font-family: Roboto,Arial,Helvetica,sans-serif;\n /*font-size: 18px;\n line-height: 1.5em;*/\n color: #000;\n -webkit-font-smoothing: antialiased;\n}\n\n.theme-solid #hub-landing-top h2, .theme-solid #hub-landing-top .hub-landing-description p {\n color: #fff;\n align-content: center;\n text-align: center;\n}\n\nul>li {\n \t\tfont-size: 16px; \n}\n#hub-sidebar-content ul>li>a {\n\t\tcolor: #666666b8;\n \tfont-size: 13px;\n}\n\np {\n \t font-family: Roboto,Arial,Helvetica,sans-serif;\n font-size: 16px;\n /*line-height: 1.5em;*/\n -webkit-font-smoothing: antialiased;\n}\n\n.heading.heading .heading-text { \n font-weight: 700;\n}\n\n.heading.heading {\n\tmargin-top: 40px;\n}\n\n#hub-sidebar-content h3 {\n color: #3a21cec7;\n}","stylesheet":"","favicon":["https://files.readme.io/16db8f9-small-UsersnapIconWhite.png","UsersnapIconWhite.png",32,32,"#ffffff","https://files.readme.io/814988f-UsersnapIconWhite.png"],"logo_white_use":false,"logo_white":["https://files.readme.io/d3578c5-small-usersnap_white.png","usersnap_white.png",428,80,"#ffffff","https://files.readme.io/4fa2061-usersnap_white.png"],"logo":["https://files.readme.io/4aa94ca-small-usersnap_white.png","usersnap_white.png",428,80,"#ffffff","https://files.readme.io/44315c2-usersnap_white.png"],"promos":[{"extras":{"type":"html","buttonPrimary":"get-started","buttonSecondary":"none"},"title":"Hi! How can we help you?","text":"Thanks for choosing Usersnap to help your company collect and manage user feedback to build better products. Getting started with Usersnap is easy. Just check our help center.","_id":"599e9484d222c9000fe2efe2"}],"body":{"style":"none"},"header":{"img_pos":"tl","img_size":"auto","img":[],"style":"solid","linkStyle":"buttons"},"typography":{"tk_body":"","tk_headline":"","tk_key":"","typekit":false,"body":"Open+Sans:400:sans-serif","headline":"Open+Sans:400:sans-serif"},"colors":{"body_highlight":"","header_text":"","main_alt":"#289CE4","main":"#3a21ce","highlight":"","custom_login_link_color":""},"main_body":{"type":"links"},"categoriesAsDropdown":false,"hide_logo":false,"sticky":false,"landing":true,"overlay":"triangles","notheme":false,"theme":"solid","link_logo_to_url":false,"referenceLayout":"row","childrenAsPills":false,"global_landing_page":{"html":"","redirect":""},"rdmd":{"callouts":{"useIconFont":false},"theme":{"background":"","border":"","markdownEdge":"","markdownFont":"","markdownFontSize":"","markdownLineHeight":"","markdownRadius":"","markdownText":"","markdownTitle":"","markdownTitleFont":"","mdCodeBackground":"","mdCodeFont":"","mdCodeRadius":"","mdCodeTabs":"","mdCodeText":"","tableEdges":"","tableHead":"","tableHeadText":"","tableRow":"","tableStripe":"","tableText":"","text":"","title":""}},"splitReferenceDocs":false,"subheaderStyle":"links","showMetricsInReference":true,"referenceSimpleMode":true,"stylesheet_hub3":"","loginLogo":[],"logo_large":false,"colorScheme":"light","changelog":{"layoutExpanded":false,"showAuthor":true,"showExactDate":false},"allowApiExplorerJsonEditor":false,"ai_dropdown":"disabled","ai_options":{"chatgpt":"enabled","claude":"enabled","clipboard":"enabled","view_as_markdown":"enabled","copilot":"enabled"},"showPageIcons":true,"layout":{"full_width":false,"style":"classic"}},"custom_domain":"help.usersnap.com","childrenProjects":[],"derivedPlan":"startup","description":"Usersnap helps your business with its versatile feedback platform to build better, more successful products and services with the help of user feedback. Getting started with Usersnap is easy.","isExternalSnippetActive":false,"error404":"","experiments":[],"first_page":"landing","flags":{"cacheEnabled":true,"allowImport":false,"stripe":false,"hideGoogleAnalytics":false,"jwt":false,"cookieAuthentication":false,"allowXFrame":false,"speedyRender":false,"correctnewlines":false,"swagger":false,"oauth":false,"migrationSwaggerRun":false,"migrationRun":false,"hub2":true,"enterprise":false,"allow_hub2":false,"newApiExplorer":true,"alwaysShowDocPublishStatus":false,"directGoogleToStableVersion":false,"disableAnonForum":false,"newEditor":true,"newMarkdownBetaProgram":true,"oldMarkdown":false,"translation":false,"newSearch":true,"allowApiExplorerJsonEditor":false,"rdmdCompatibilityMode":false,"staging":false,"tutorials":true,"useReactApp":true,"newHeader":false,"referenceRedesign":false,"auth0Oauth":false,"graphql":false,"singleProjectEnterprise":false,"dashReact":false,"allowReferenceUpgrade":true,"metricsV2":true,"newEditorDash":true,"enableRealtimeExperiences":false,"reviewWorkflow":true,"star":false,"allowDarkMode":false,"forceDarkMode":false,"useReactGLP":false,"disablePasswordlessLogin":false,"personalizedDocs":false,"myDevelopers":false,"superHub":true,"developerDashboard":false,"allowReusableOTPs":false,"dashHomeRefresh":false,"owlbotAi":false,"apiV2":false,"git":{"read":false,"write":false},"superHubBeta":false,"dashQuickstart":false,"disableAutoTranslate":false,"customBlocks":false,"devDashHub":false,"disableSAMLScoping":false,"allowUnsafeCustomHtmlSuggestionsFromNonAdmins":false,"apiAccessRevoked":false,"passwordlessLogin":"default","disableSignups":false,"billingRedesignEnabled":true,"developerPortal":false,"mdx":true,"superHubDevelopment":false,"annualBillingEnabled":true,"devDashBillingRedesignEnabled":false,"enableOidc":false,"customComponents":false,"disableDiscussionSpamRecaptchaBypass":false,"developerViewUsersData":false,"changelogRssAlwaysPublic":false,"bidiSync":true,"superHubMigrationSelfServeFlow":true,"apiDesigner":false,"hideEnforceSSO":false,"localLLM":false,"superHubManageVersions":false,"gitSidebar":false,"superHubGlobalCustomBlocks":false,"childManagedBidi":false,"superHubBranches":false,"externalSdkSnippets":false,"migrationPreview":false,"requiresJQuery":false,"superHubPreview":false,"superHubBranchReviews":false,"superHubMergePermissions":false},"fullBaseUrl":"https://help.usersnap.com/","git":{"migration":{"createRepository":{"start":"2025-05-07T21:35:05.840Z","end":"2025-05-07T21:35:06.270Z","status":"successful"},"transformation":{"end":"2025-05-07T21:35:07.026Z","start":"2025-05-07T21:35:06.449Z","status":"successful"},"migratingPages":{"end":"2025-05-07T21:35:08.105Z","start":"2025-05-07T21:35:07.113Z","status":"successful"},"enableSuperhub":{"start":"2025-05-07T22:22:58.974Z","status":"successful","end":"2025-05-07T22:22:58.975Z"}},"sync":{"linked_repository":{},"installationRequest":{},"connections":[],"providers":[]}},"glossaryTerms":[],"graphqlSchema":"","gracePeriod":{"enabled":false,"endsAt":null},"shouldGateDash":false,"healthCheck":{"provider":"","settings":{}},"intercom_secure_emailonly":false,"intercom":"rycucve3","is_active":true,"integrations":{"login":{}},"internal":"","jwtExpirationTime":0,"landing_bottom":[{"type":"html","alignment":"left","html":""},{"type":"docs","alignment":"left","pageType":"Documentation","mediaHTML":"\n\n"}},"header":{"type":"solid","gradient_color":"#289CE4","link_style":"buttons","overlay":{"fill":"auto","type":"triangles","position":"top-left","image":{"uri":null,"url":null,"name":null,"width":null,"height":null,"color":null,"links":{"original_url":null}}}},"ai":{"dropdown":"disabled","options":{"chatgpt":"enabled","claude":"enabled","clipboard":"enabled","copilot":"enabled","view_as_markdown":"enabled"}},"navigation":{"first_page":"landing_page","left":[],"logo_link":"landing_page","page_icons":"enabled","right":[{"type":"link_url","title":"Back to the USERSNAP website","url":"https://usersnap.com/?gat=from_help","custom_page":"my-custom"}],"sub_nav":[],"subheader_layout":"links","version":"disabled","links":{"home":{"label":"Home","visibility":"enabled"},"graphql":{"label":"GraphQL","visibility":"disabled"},"guides":{"label":"Guides","alias":null,"visibility":"enabled"},"reference":{"label":"API Reference","alias":null,"visibility":"enabled"},"recipes":{"label":"Recipes","alias":null,"visibility":"disabled"},"changelog":{"label":"Changelog","alias":null,"visibility":"disabled"},"discussions":{"label":"Discussions","alias":null,"visibility":"disabled"}}}},"git":{"connection":{"repository":{},"organization":null,"status":"inactive"}}}},"version":{"_id":"628b36b6b299dc0086085dc6","version":"9.0","version_clean":"9.0.0","codename":"","is_stable":true,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["628b36b6b299dc0086085d1d","5fc4d2113a54af0075533274","5fc4d2113a54af0075533275","628b36b6b299dc0086085d1e","628b36b6b299dc0086085d1f","628b36b6b299dc0086085d20","628b36b6b299dc0086085d21","60097f082932a600681ec667","628b36b6b299dc0086085d22","628b36b6b299dc0086085d23","628b36b6b299dc0086085d24","628b3725d9ab60003d1a2192","628b3af97e960f00a7aab41d","628b3b40374387009c88fadf","628b4dfc4777730316beb778","628b4e1489f01b0093690451","628b4e7a9475e40083264d55","628b4ebe7a046000a8aba25e","628b4f0070b62500130ccf1d","628b4f9a58f033008d9761f0","628b5195d286df002f10f3b4","62987de6d38e7b001a9207a2","6299c63bb0a8e6005de970ff","6299d658ca5c23050909a0e4","6299e67e77e52600f595fcdc","62a6dbe236263e0027560f86","62a780db785b980220e18139","62e3c01274412b04874c0226","6376bee8127d990003169eb2","638093e300414606534e656b","6463bdd9245d8d003d5731b6","64c8bce46011ec000a37ceab","66c71fbcd78f8600448e5fb1"],"project":"599e9484d222c9000fe2efe1","__v":2,"forked_from":"61eadd71f04b94021238f0dc","createdAt":"2017-08-24T08:55:32.695Z","releaseDate":"2017-08-24T08:55:32.695Z","updatedAt":"2024-08-22T11:23:40.486Z","apiRegistries":[],"pdfStatus":"","source":"readme"}},"is404":false,"isDetachedProductionSite":false,"lang":"en","langFull":"Default","reqUrl":"/docs/form","version":{"_id":"628b36b6b299dc0086085dc6","version":"9.0","version_clean":"9.0.0","codename":"","is_stable":true,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["628b36b6b299dc0086085d1d","5fc4d2113a54af0075533274","5fc4d2113a54af0075533275","628b36b6b299dc0086085d1e","628b36b6b299dc0086085d1f","628b36b6b299dc0086085d20","628b36b6b299dc0086085d21","60097f082932a600681ec667","628b36b6b299dc0086085d22","628b36b6b299dc0086085d23","628b36b6b299dc0086085d24","628b3725d9ab60003d1a2192","628b3af97e960f00a7aab41d","628b3b40374387009c88fadf","628b4dfc4777730316beb778","628b4e1489f01b0093690451","628b4e7a9475e40083264d55","628b4ebe7a046000a8aba25e","628b4f0070b62500130ccf1d","628b4f9a58f033008d9761f0","628b5195d286df002f10f3b4","62987de6d38e7b001a9207a2","6299c63bb0a8e6005de970ff","6299d658ca5c23050909a0e4","6299e67e77e52600f595fcdc","62a6dbe236263e0027560f86","62a780db785b980220e18139","62e3c01274412b04874c0226","6376bee8127d990003169eb2","638093e300414606534e656b","6463bdd9245d8d003d5731b6","64c8bce46011ec000a37ceab","66c71fbcd78f8600448e5fb1"],"project":"599e9484d222c9000fe2efe1","__v":2,"forked_from":"61eadd71f04b94021238f0dc","createdAt":"2017-08-24T08:55:32.695Z","releaseDate":"2017-08-24T08:55:32.695Z","updatedAt":"2024-08-22T11:23:40.486Z","apiRegistries":[],"pdfStatus":"","source":"readme"},"gitVersion":{"base":"7.0","display_name":null,"name":"9.0","release_stage":"release","source":"readme","state":"current","updated_at":"2025-07-17T11:46:40.000Z","uri":"/branches/9.0","privacy":{"view":"default"}},"versions":{"total":13,"page":1,"per_page":100,"paging":{"next":null,"previous":null,"first":"/usersnap/api-next/v2/branches?page=1&per_page=100","last":null},"data":[{"base":null,"display_name":null,"name":"1.0","release_stage":"release","source":"readme","state":"current","updated_at":"2025-05-18T11:55:16.881Z","uri":"/branches/1.0","privacy":{"view":"hidden"}},{"base":"1.0","display_name":null,"name":"2.0","release_stage":"release","source":"readme","state":"current","updated_at":"2025-05-18T11:57:22.813Z","uri":"/branches/2.0","privacy":{"view":"hidden"}},{"base":"2.0","display_name":"QA & Rating projects","name":"3.0","release_stage":"release","source":"readme","state":"current","updated_at":"2025-05-18T11:58:59.767Z","uri":"/branches/3.0","privacy":{"view":"hidden"}},{"base":"3.0","display_name":"Improved help","name":"4.0","release_stage":"release","source":"readme","state":"current","updated_at":"2025-05-18T12:00:22.149Z","uri":"/branches/4.0","privacy":{"view":"hidden"}},{"base":"3.0","display_name":"Test version - will be deleted","name":"4.9","release_stage":"release","source":"readme","state":"current","updated_at":"2025-05-18T12:01:13.266Z","uri":"/branches/4.9","privacy":{"view":"hidden"}},{"base":"4.0","display_name":"New version 2021-02-02","name":"5.0","release_stage":"release","source":"readme","state":"current","updated_at":"2025-05-18T12:04:13.065Z","uri":"/branches/5.0","privacy":{"view":"hidden"}},{"base":"5.0","display_name":"New version 2021-02-02","name":"6.0","release_stage":"release","source":"readme","state":"current","updated_at":"2025-05-18T12:05:36.254Z","uri":"/branches/6.0","privacy":{"view":"hidden"}},{"base":"6.0","display_name":"platform","name":"7.0","release_stage":"release","source":"readme","state":"current","updated_at":"2025-05-18T12:06:52.009Z","uri":"/branches/7.0","privacy":{"view":"hidden"}},{"base":"7.0","display_name":"New navigation June, 2022","name":"8.0","release_stage":"release","source":"readme","state":"current","updated_at":"2025-05-18T12:07:19.929Z","uri":"/branches/8.0","privacy":{"view":"hidden"}},{"base":"7.0","display_name":null,"name":"9.0","release_stage":"release","source":"readme","state":"current","updated_at":"2025-07-17T11:46:40.647Z","uri":"/branches/9.0","privacy":{"view":"default"}},{"base":"9.0","display_name":null,"name":"10.0","release_stage":"release","source":"readme","state":"current","updated_at":"2025-05-18T12:08:12.606Z","uri":"/branches/10.0","privacy":{"view":"hidden"}},{"base":"9.0","display_name":null,"name":"10.1","release_stage":"release","source":"readme","state":"current","updated_at":"2025-05-15T07:38:15.609Z","uri":"/branches/10.1","privacy":{"view":"public"}},{"base":"9.0","display_name":"new install by Marcin","name":"11","release_stage":"release","source":"readme","state":"current","updated_at":"2025-05-18T12:09:20.618Z","uri":"/branches/11","privacy":{"view":"hidden"}}],"type":"version"}}">