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
Add custom input fields to your widget form to collect structured data from users.
Default Fields
Every project has four built-in fields that can be enabled or disabled per widget:
| Field ID | Label | Type | Purpose |
|---|---|---|---|
df_name | Name | Text | Collects the user's name |
df_email | Collects the user's email | ||
df_phone | Phone | Tel | Collects the user's phone number |
df_company | Company | Text | Collects the user's company name |
Default fields are pre-configured. Enable or disable them from your project settings under Custom Fields.
Values from df_name, df_email, and df_phone are automatically promoted to the feedback item's user info. They appear in the Context card in your dashboard alongside browser, OS, and location data.
Custom Fields
Beyond the defaults, you can define your own fields in Project Settings > Custom Fields. Supported types:
| Type | Description |
|---|---|
| Text | Single-line text input |
| Select | Dropdown menu with predefined options |
| Checkbox | Boolean toggle |
Custom field IDs are auto-generated with a cf_ prefix (e.g. cf_a8k2m1p5).
Custom Fields vs Custom Metadata
Custom fields and custom metadata both attach data to feedback, but they work differently:
- Custom fields are form inputs the end user fills out when submitting feedback. Values appear in the Custom Fields card in the dashboard.
- Custom metadata is set by the developer via
setMetadata()before the widget opens. Values appear in the Custom Data card.
If both provide user info (e.g. email), the custom field value takes priority. See Custom Metadata for details.