Feedback
Intro
The feedback feature allows users to provide positive or negative feedback on Joule’s AI-generated responses.
Joule feedback selection view in compact Joule panel (left) and regular Joule panel (right)
Usage
Do
Provide the feedback feature for every Joule-generated response, even if the feature is unavailable.
Don’t
Don’t remove the feedback feature even if it is unavailable.
- Don’t remove the feedback feature even if it is unavailable. When it isn’t available, error states are shown when the user attempts to interact with it. This is important for establishing a mental model of the feature.
- Don’t change the style or placement of the feedback thumbs. They are intentionally styled and placed alongside other response-related actions.
Anatomy
Thumb Icon Buttons
The thumb icon buttons are placed inside the response action bar of the associated Joule-generated response.
A. Thumbs Up
Used for submitting positive feedback for a Joule response.
B. Thumbs Down
Used for submitting negative feedback for a Joule response.
Anatomy of thumb icon buttons
Feedback Selection View
The feedback selection view consists of a modal bottom sheet with the following component features.
A. Navigation Bar
Displays the “Close” icon button and bottom sheet title.
B. Feedback Categories
Display a list of single selection feedback category chips.
C. Text Input
Used to enter text.
D. Footer
Contains the “Submit” button for submitting feedback.
Anatomy of feedback selection view
Behavior and Interaction
Submit Positive Feedback
To submit positive feedback, the user can tap the “Thumbs up” icon button. A toast message appears to confirm the submission, which the user can manually dismiss.
Submitting positive feedback for a Joule-generated response
Submit Negative Feedback
To submit negative feedback, the user can tap the “Thumbs down” icon button. This opens the feedback selection view. In the feedback bottom sheet, users can edit their negative feedback submission by:
- Selecting a new feedback category
- A category must be selected to submit negative feedback
- “Not specified” is always the last category and is selected by default
- Adding free text (optional)
Once users have edited their negative feedback, they can submit it by tapping the “Submit” button. A Tost message appears to confirm the submission, which the user can manually dismiss.
Submitting negative feedback for a Joule-generated response
Cancel Negative Feedback
The user can cancel their negative feedback submission by either:
- Tapping the “Close” icon button
- Tapping outside the modal bottom sheet
If the user performs any of these actions, negative feedback is not submitted. However, if they select a non-default feedback category or enter text in the input field, that information is saved in case they reopen the bottom sheet by tapping the “Thumbs down” icon button again.
Methods for canceling a negative feedback submission
Variations
Error States
Joule can encounter various types of errors. The following errors specifically relate to failures in retrieving or submitting feedback. If a broader Joule error occurs, that takes priority and is displayed instead.
Retrieval Error
A retrieval error occurs when:
- The feedback functionality as a whole can’t be retrieved
- The feedback categories associated with the Joule response type can’t be retrieved
- Previously submitted user feedback can’t be retrieved
If this error occurs and the user attempts to interact with the thumb icon buttons, a toast message appears to inform them that the feedback feature is unavailable.
Submission Error
A submission error occurs when the user is able to open the feedback selection view, but a technical issue prevents the feedback from being submitted. If this happens, an illustrated message appears within the feedback bottom sheet, informing the user that their feedback was saved but not submitted, and prompting them to try again later.
Error handling for a retrieval error
Error handling for a submission error
Adaptive Design
The feedback selection view always fills the width of the Joule panel, while the bottom sheet adjusts its height to fit the content. On compact screen heights, the bottom sheet content may extend behind the “Submit” button footer.
Joule feedback selection view in a compact width and height (left) and medium width and compact height (right)