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 |
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 | ❌ |
| 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 (Coming Soon)
In a future release, you'll be able to:
- Add custom text fields
- Add dropdown selections
- Add checkbox groups
- Define field validation rules