Web Parts
Feedback
Collect user feedback with customizable forms, star ratings, categories, and submission history.
CommunicationFeature Parity: 90%
Get Feedback Working in 3 Steps
15-30 minutes
Prerequisites
- Bonzai 2 package installed on your site
- Feedback list created with required columns
1
Create the Feedback list
Create a SharePoint list (default name "Feedback") with the required columns: Title, Description, Category, Rating, IsAnonymous, SubmittedBy, SubmittedByName.
2
Add Feedback web part
Edit the page, add the Bonzai Feedback web part to your desired section.
3
Configure and publish
Pick the list in the List Picker, set comma-separated categories, toggle rating/anonymous options, then publish.
When to Use This Web Part
Use this when you need to...
- Collect user feedback on the intranet
- Gather feature requests and suggestions
- Enable quick contact with site administrators
- Capture ratings for content or services
- Create support request forms
- Allow anonymous or identified feedback
Best page locations
- Homepage footer — quick feedback access
- Support pages — contact forms
- Department pages — team feedback collection
- Any page — sidebar feedback widget
Consider alternatives when...
- • Complex multi-step forms — use PowerApps
- • Survey with multiple questions — use Microsoft Forms
- • Event registration — use Events Rollup
Related web parts:
Microsoft Forms — complex surveysPowerApps — custom business forms
Step-by-Step Configuration
1
Create a Feedback SharePoint list
Go to Site Contents → New → List. Name it "Feedback" (or any name — you'll pick it in the property pane).
2
Add required columns
Add: Description (Multiple lines of text), Category (Single line or Choice), Rating (Number), IsAnonymous (Yes/No), SubmittedBy (Single line of text), SubmittedByName (Single line of text).
Title is already present on every list. The code treats Category as a plain text value, so either Single line or Choice works — Choice is recommended for controlled values.
3
Add the web part to your page
Edit the target page, click +, and add "Bonzai Feedback".
4
Select the Feedback list
In the property pane → Data Source, optionally set Site URL (leave blank for the current site) and pick the list from the List Picker.
5
Configure categories
Enter comma-separated categories like "General,Bug Report,Feature Request,Other". Leave blank to hide the dropdown entirely.
6
Configure rating options
Toggle "Show Star Rating" and set Max Rating (3-10 stars).
7
Configure anonymous option
Enable "Allow Anonymous Submission" to let users submit without their name attached.
8
Set up submissions display
Enable "Show Submissions" so users see their past feedback. Enable "Show All Users' Feedback" to show entries from everyone (admin view).
9
Optional: add help and "View All" links
Set Help URL to show a help icon next to the title, and Show More URL / Show More Text to add a footer link (e.g., to the raw SharePoint list).
10
Publish and test
Publish the page and submit test feedback to verify it saves to the list.
Common Configurations
Quick Feedback Widget
Compact feedback in the page footer
Best for: Site-wide feedback collection
Configuration
| Title | Share Your Feedback |
| Show Rating | Yes |
| Max Rating | 5 |
| Categories | General,Suggestion |
| Chrome Type | Title Only |
Full Feedback Form
Complete form with all options
Best for: Dedicated feedback page
Configuration
| Title | Feedback & Suggestions |
| Show Rating | Yes |
| Allow Anonymous | Yes |
| Show My Submissions | Yes |
| Max Items | 10 |
Support Request
IT or HR support form
Best for: Help desk pages
Configuration
| Title | Submit a Request |
| Categories | Hardware,Software,Access,Other |
| Show Rating | No |
| Allow Anonymous | No |
| Chrome Type | Title and Border |
Content Rating
Star rating focused
Best for: Content rating pages
Configuration
| Title | Rate This Page |
| Show Rating | Yes |
| Max Rating | 5 |
| Is Collapsible | Yes |
| Default Collapsed | Yes |
Best Practices
Make feedback easy to find
Place the Feedback web part in a consistent location across pages (e.g., footer or sidebar) so users know where to find it.
Review feedback regularly
Set up Power Automate notifications to alert admins when new feedback is submitted. Respond promptly to build engagement.
Use categories for routing
Categories help route feedback to the right team. Set up different views in SharePoint for IT, HR, and Content teams.
Anonymous vs. identified feedback
When "Allow Anonymous Submission" is on, a checkbox appears on the form. If a user submits anonymously, both
SubmittedBy and SubmittedByName are written as the literal string Anonymous. Because the "My Previous Submissions" list filters by the current user's email, anonymous entries will not appear in a user's personal history — they only surface when "Show All Users' Feedback" is enabled.Show All Users' Feedback
Turning on "Show All Users' Feedback" automatically keeps the submissions section visible even if "Show Submissions" is off — otherwise the list would have nowhere to render. The list title switches to "All Feedback" and each row displays the submitter's name (or "Anonymous").
Link your help documentation
Set
Help URL in the Title & Navigation group to render a help icon next to the title. It opens in a new tab — point it at your intranet's feedback policy or FAQ.Reference
Feedback List Schema
Create a SharePoint list named "Feedback" with these columns:
- Create a list named Feedback.
- Add the required columns below (Title is already present).
- Ensure users have Contribute permissions to submit feedback.
| Column | Type | Required | Notes |
|---|---|---|---|
| Title | Single line of text | Yes | Default column — feedback subject |
| Description | Multiple lines of text | Yes | Plain text feedback content |
| Category | Choice or Single line of text | Yes | e.g., General, Bug Report, Feature Request. Code writes the category name as a plain string. |
| Rating | Number | Yes | Stores star rating value (0 when rating is hidden) |
| IsAnonymous | Yes/No | Yes | Whether the user chose to submit anonymously |
| SubmittedBy | Single line of text | Yes | User email, or the literal string "Anonymous" |
| SubmittedByName | Single line of text | Yes | User display name, or the literal string "Anonymous" |
Created is used automatically for the submission date — no SubmittedDate column is required. If a custom SubmittedDate column exists it will be preferred, but it is optional.
Property Pane Configuration
| Property | Type | Group | Description |
|---|---|---|---|
title | Text | Title & Navigation | Web part title (default: "Feedback") |
titleUrl | Text | Title & Navigation | Optional URL to make the title clickable |
titleIconOption | Dropdown | Title & Navigation | Title icon mode: custom or none (default: custom) |
titleIconName | Text | Title & Navigation | Fluent UI icon name (default: "Feedback"). Hidden when option is None. |
titleIconUrl | Text | Title & Navigation | Custom image URL for the title icon. Overrides titleIconName when set. |
description | Text (multiline) | Title & Navigation | Description shown below the title |
showMoreUrl | Text | Title & Navigation | URL for the "View All" footer link |
showMoreText | Text | Title & Navigation | Footer link text (default: "View All Feedback") |
helpUrl | Text | Title & Navigation | URL to help documentation (renders a help icon in the header) |
siteUrl | Text | Data Source | Absolute URL of the site that hosts the list. Leave empty for current site. |
listName | List Picker | Data Source | Feedback list (stores list id + title, rename-resilient) |
categories | Text (multiline) | Form Configuration | Comma-separated categories (default: "General,Bug Report,Feature Request,Other") |
showRating | Toggle | Form Configuration | Show star rating on the form (default: true) |
maxRating | Slider (3-10) | Form Configuration | Maximum rating value (default: 5). Disabled when showRating is off. |
allowAnonymous | Toggle | Form Configuration | Allow anonymous submissions (default: true) |
showMySubmissions | Toggle | Submissions Display | Show the submissions section (default: true). Auto-enabled if showAllSubmissions is on. |
showAllSubmissions | Toggle | Submissions Display | Show all users' feedback instead of only the current user's (default: false) |
maxItems | Slider (1-50) | Submissions Display | Max submissions to display (default: 10) |
chromeType | Dropdown | Appearance | None / Title Only / Border Only / Title and Border (default: titleAndBorder) |
fixedHeight | Slider (0-800) | Appearance | Fixed height in pixels; 0 means auto height (default: 0) |
isCollapsible | Toggle | Appearance | Allow users to collapse/expand the web part (default: false) |
defaultCollapsed | Toggle | Appearance | Start collapsed on page load (default: false). Requires isCollapsible. |
successMessage | Text (multiline) | Messages | Post-submit confirmation (default: "Thank you for your feedback!") |
enableAudienceTargeting | Toggle | Audience Targeting | Hide the web part from users not in the target list (default: false) |
targetAudience | Text (multiline) | Audience Targeting | Comma-separated user emails or group names. Disabled unless targeting is enabled. |
Features Checklist
- ✅ Feedback form submission (title, description, category, rating, anonymous)
- ✅ Configurable star rating (3-10 stars) with hover and keyboard support
- ✅ Customizable categories (comma-separated, rendered as a dropdown)
- ✅ Anonymous submission option (stores "Anonymous" for submitter)
- ✅ View past submissions (current user only)
- ✅ View all submissions (admin feature — shows every user's feedback with submitter name)
- ✅ Chrome type configuration (None / Title Only / Border Only / Title and Border)
- ✅ Collapsible / expandable with optional start-collapsed default
- ✅ Fixed height with internal scrolling
- ✅ Custom success message
- ✅ Built-in error messaging (list not found, permission denied, network errors)
- ✅ Graceful "List Not Found" state with inline setup instructions
- ✅ Audience targeting (hide web part from non-targeted users)
- ✅ Title icon via Fluent UI name or custom image URL
- ✅ Optional help link in header
- ✅ "View All Feedback" footer link
- ✅ List picker with rename-resilient list id tracking
- ✅ Cross-site list support via
siteUrl - ✅ Responsive design
Migration from Classic Bonzai
| Classic Feature | Modern Equivalent | Notes |
|---|---|---|
| Feedback form | Feedback component | Same functionality |
| Star rating | showRating + maxRating | Configurable 3-10 stars, keyboard-accessible |
| Category dropdown | categories property | Comma-separated text |
| Anonymous mode | allowAnonymous | Toggle in property pane; stores "Anonymous" literal |
| Chrome types | chromeType | None / Title Only / Border Only / Title and Border |
| Submissions history | showMySubmissions + showAllSubmissions | Per-user by default; admin view shows everyone |
| Audience targeting | enableAudienceTargeting + targetAudience | Hide the web part from users outside the list |