Feedback Components
Collect user feedback with ratings, NPS scores, and emoji reactions.
Feedback Components
Feedback components are purpose-built for collecting user sentiment. Each component captures a specific type of response — star ratings, NPS scores, emoji reactions, or binary thumbs up/down — and automatically tracks the value in your flow analytics.
All feedback values are recorded as analytics events with the component type and submitted value. You can view aggregated feedback data in the flow analytics dashboard and forward events to external tools like Amplitude, Mixpanel, or Segment.
Rating
A star-based rating component for collecting satisfaction scores on a 1-to-5 scale. Stars are tappable and fill progressively as the user selects a value.
Properties
| Property | Type | Description |
|---|---|---|
| Variable Name | text | Key used to store the rating value (1-5). |
| Max Stars | number | Number of stars to display. Default: 5. |
| Default Value | number | Pre-selected rating (0 for none). |
| Star Size | number | Size of each star in pixels. |
| Active Color | color | Color of filled (selected) stars. Default: gold. |
| Inactive Color | color | Color of empty (unselected) stars. |
| Allow Half | boolean | Enable half-star selections. |
| Required | boolean | Whether a rating is required to proceed. |
| Label | text | Optional label displayed above the stars. |
Branching
Rating values can drive conditional branching in your flow graph. For example:
- Ratings of 4-5 lead to a "Thank you" screen with an app store review prompt
- Ratings of 1-3 lead to a follow-up screen asking what went wrong
This pattern lets you route happy users toward reviews and dissatisfied users toward support, all within a single flow.
Analytics
Each rating submission is tracked as a component_rating event with the selected value. In the analytics dashboard, you can see the distribution of ratings across all users who encountered the flow.
NPS
A Net Promoter Score component that presents a 0-to-10 scale for measuring user loyalty. The NPS component renders as a horizontal row of numbered buttons, following the standard NPS survey format.
Properties
| Property | Type | Description |
|---|---|---|
| Variable Name | text | Key used to store the NPS score (0-10). |
| Required | boolean | Whether a score is required. |
| Low Label | text | Label at the left end of the scale (e.g., "Not likely"). Localizable. |
| High Label | text | Label at the right end of the scale (e.g., "Very likely"). Localizable. |
| Active Color | color | Color of the selected score button. |
| Inactive Color | color | Color of unselected score buttons. |
| Text Color | color | Number text color. |
| Size | select | Button size: small, medium, large. |
Branching
NPS scores naturally segment into three groups, and you can branch your flow accordingly:
- Promoters (9-10) — route to a referral or review prompt
- Passives (7-8) — route to a "what could be better?" follow-up
- Detractors (0-6) — route to a detailed feedback form or support offer
Create a branch node in the flow graph and map score ranges to different target screens.
Analytics
NPS submissions are tracked as component_nps events. The analytics dashboard calculates your overall NPS score (% Promoters minus % Detractors) and shows the score distribution over time.
Emoji Feedback
An emoji-based feedback component that lets users express their sentiment by selecting from a row of emoji faces — from very unhappy to very happy.
Properties
| Property | Type | Description |
|---|---|---|
| Variable Name | text | Key used to store the selected emoji value. |
| Options | array | The set of emoji options with values and labels. Defaults to a 5-point sentiment scale. |
| Required | boolean | Whether a selection is required. |
| Size | number | Emoji display size in pixels. |
| Show Labels | boolean | Display text labels beneath each emoji. |
| Label Color | color | Text color for labels. |
| Selected Background | color | Background highlight for the selected emoji. |
Use cases
- Quick sentiment check after a feature interaction
- Post-support satisfaction measurement
- Lightweight alternative to star ratings for casual contexts
Thumbs
A binary feedback component presenting thumbs-up and thumbs-down buttons. This is the simplest feedback mechanism — ideal when you need a quick positive/negative signal.
Properties
| Property | Type | Description |
|---|---|---|
| Variable Name | text | Key used to store the response ("up" or "down"). |
| Required | boolean | Whether a selection is required. |
| Up Color | color | Thumbs-up icon color. |
| Down Color | color | Thumbs-down icon color. |
| Size | number | Icon size in pixels. |
| Show Labels | boolean | Display "Yes"/"No" labels beneath the icons. |
| Up Label | text | Custom label for thumbs up. Localizable. |
| Down Label | text | Custom label for thumbs down. Localizable. |
| Selected Background | color | Background highlight for the selected thumb. |
Use cases
- "Was this helpful?" after a tooltip or announcement
- Quick feedback on a new feature
- Binary qualification questions ("Are you interested in X?")
Branching
Like other feedback components, thumbs responses can drive conditional branching. Route thumbs-up users to one screen and thumbs-down users to another for targeted follow-up.