Getting started
Forms
Forms are standalone feedback forms and surveys you build in Usero, publish to a public link, and collect responses to. They are separate from the floating widget: a widget sits on your app and catches passing feedback, a form is a page you send people to on purpose (a bug report intake, a feature request survey, an onboarding questionnaire, a churn exit survey). Responses land in the same Usero project as the rest of your feedback.
What it does
- Visual builder. Drag fields into order, set labels, mark fields required, add options, and set a brand color. No code, no deploy.
- Public link. Every form publishes to
usero.io/f/<slug>with an 8-character slug. Share it directly or embed it in a cross-origin iframe; the form submits to itself either way. - Responses table. Submissions collect into a table you can read in the dashboard and export to CSV.
- Built-in analytics. Views, unique visitors, submission rate, average time to complete, and a view-to-submit funnel, per form and across all forms.
- Privacy-first. Respondent IP addresses are encrypted at rest with AES-GCM. You never see a raw IP.
Create a form
- Open your project and go to Forms (
usero.io/YOUR_CLIENT_ID/forms). - Click New Form. Usero creates the form, gives it a unique public slug, and drops you into the builder.
- In the builder, give the form a title and an optional description. These show at the top of the public form.
- Add fields (next section), set a brand color under Settings, and the form is live. New forms publish as Open by default, so the public link works immediately.
A form has an Open / Closed toggle in the builder. Closed forms still resolve at their link but show a "no longer accepting responses" message instead of the fields, so you can pause collection without breaking the URL or losing past responses.
Field types
Ten field types cover the common cases. Each field has a label, an optional description, and a required toggle.
| Type | What it collects |
|---|---|
| Short Text | A single line of text. |
| Long Text | A multi-line text area, for open-ended answers. |
| A text field validated as an email address on submit. | |
| Number | A numeric value, with optional min and max bounds. |
| Dropdown | One choice from a list you define. |
| Multi-Select | Several choices from a list. |
| Multiple Choice | One choice, shown as radio buttons. |
| Checkboxes | Several choices, shown as checkboxes. |
| Star Rating | A 1 to N star rating (default 5). |
| Linear Scale | A numeric scale with optional min and max labels (for example 1 to 10). |
Choice fields (dropdown, multi-select, multiple choice, checkboxes) take a list of options you edit inline. Number, rating, and scale fields take min and max bounds. Fields support conditional logic: a field can be set to show only when an earlier field equals, does not equal, contains, or is not empty, so the form adapts to what the respondent picked.
Share it
Every form has a public URL at usero.io/f/<slug>, where the slug is the 8-character id assigned at creation.
- From the Forms list, open a form's menu and use Copy Public Link or View Public Form.
- The public page renders on a clean light or dark surface (it follows the visitor's OS color scheme) with your title, description, brand color, and fields. There is no Usero account required to fill it in.
- Submitting shows your custom success message. You set that message and the submit button label under Settings in the builder.
To take a form offline, flip it to Closed in the builder. The link stays valid and shows a closed message; existing responses are untouched.
See responses and analytics
Open a form and switch tabs in the builder:
- Responses. Every submission as a row, with the answers laid out by field. Export CSV downloads the lot for a spreadsheet or a pivot table.
- Analytics. Views, unique visitors, submissions, submission rate, and average time to complete, plus a funnel from viewed to interacted to tried-to-submit to submitted, and a daily trend chart. The Forms list also has a cross-form Analytics tab that rolls these up across every form in the project.
If you turn on Notify on submission in a form's settings, Usero emails the project owner each time someone submits (the email includes the answers and a link to the responses tab). This respects the owner's transactional email preference.
Next
A form response is feedback like any other in Usero, so it feeds the same loop as the widget and your imported GitHub issues. The AI clusters duplicate reports, and from a clustered item you can open a GitHub pull request with a first pass at the fix, which you review and merge yourself. Nothing auto-merges.
- Feedback widget: the floating button, for passive in-app feedback alongside your forms
- GitHub (AI pull requests): turn a clustered request into a PR
- Find your clientId