Widget Fields
Configure which input fields appear in your feedback widget
Widget Fields
Each widget template comes with configurable fields. You can enable, disable, or require specific fields based on your needs.
Available Fields
Feedback Text
The main text input for feedback.
| Setting | Options |
|---|---|
| Enabled | Always (cannot be disabled) |
| Required | Yes |
| Max length | 5000 characters |
Categories
Let users categorize their feedback.
| Setting | Options |
|---|---|
| Enabled | Yes / No |
| Categories | Bug, Feature Request, Question, Other (customizable) |
| Required | Optional |
Custom categories:
- Add your own categories like "UI/UX", "Performance", "Documentation"
- Reorder categories to show most common first
- Maximum 10 categories
Rating
Collect satisfaction ratings or scores.
| Setting | Options |
|---|---|
| Enabled | Yes / No |
| Scale | 1-5 stars, 1-10, Emoji |
| Required | Optional / Required |
Rating scales:
- Stars (1-5): Classic star rating
- Numeric (1-10): NPS-style scoring
- Emoji: 😞 😐 🙂 😊 😍
Screenshot
Allow users to capture and submit screenshots.
| Setting | Options |
|---|---|
| Enabled | Yes / No |
| Mode | Optional / Required |
Screenshot features:
- Captures visible viewport
- Automatically masks sensitive elements (inputs, iframes)
- Compressed before upload
- Maximum file size: 5MB
File Attachment
Let users attach files to their feedback.
| Setting | Options |
|---|---|
| Enabled | Yes / No |
| Allowed types | Images, Documents, All |
| Max size | 5MB |
Audio Recording
Available on Pro and Pro Max plans only.
Let users record audio feedback with their microphone, or upload a pre-recorded audio file.
| Setting | Options |
|---|---|
| Mode | Off / Optional / Required |
| Record | Microphone via MediaRecorder |
| Upload | Pre-recorded files |
| Max duration | 5 minutes |
| Max file size | 10 MB |
| Formats | WebM, MP4, MPEG, OGG, WAV |
Audio features:
- Live recording indicator with timer
- Playback preview before submission
- Upload existing audio files
- Automatic format detection
Video Recording
Available on Pro and Pro Max plans only.
Let users record video feedback via screen capture or webcam, or upload a pre-recorded video file.
| Setting | Options |
|---|---|
| Mode | Off / Optional / Required |
| Sources | Screen, Webcam, File upload |
| Max duration | 3 minutes |
| Max file size | 50 MB |
| Formats | WebM, MP4 |
Video features:
- Screen recording via browser share dialog
- Webcam recording
- Source picker (Screen / Webcam / Upload)
- Preview before submission
- Handles browser "Stop sharing" automatically
Optionally collect the user's email for follow-up.
| Setting | Options |
|---|---|
| Enabled | Yes / No |
| Required | Optional / Required |
| Pre-fill | From identify() call |
Steps to Reproduce
Text field for describing how to reproduce an issue (Bug Report template).
| Setting | Options |
|---|---|
| Enabled | Yes / No |
| Required | Optional |
Field Configuration by Template
| Field | Floating | Bug Report | Rating |
|---|---|---|---|
| Feedback Text | ✅ | ✅ | Optional |
| Categories | Optional | ❌ | ❌ |
| Rating | Optional | ❌ | ✅ Required |
| Screenshot | Optional | Optional | ❌ |
| File Attachment | Optional | Optional | ❌ |
| Audio Recording | Optional | Optional | ❌ |
| Video Recording | Optional | Optional | ❌ |
| Optional | Optional | Optional | |
| Steps to Reproduce | ❌ | Optional | ❌ |
Privacy Considerations
Field settings interact with your project's privacy settings:
Privacy ceiling: If screenshot capture is disabled at the project level, you cannot enable it per-widget. Project settings act as a hard limit.
See Privacy Controls for more details.
Custom Fields
Custom fields add structured form inputs to your widget so users can provide specific information when they submit feedback. Configure your fields in Project Settings > Custom Fields, then enable them per widget from the Fields tab here in the Widget Builder.
See Custom Fields for a full guide covering all field types, validation settings, and where field data appears in the dashboard.