Statamic Feedback

Features • Installation • Quick Start • Documentation • Support

A visual feedback and annotation tool for Statamic. Pin feedback to page elements, capture screenshots, leave comments with @mentions, and track everything from the Control Panel. Works on both the frontend and in the CP.

Client feedback usually lives in email threads, Slack messages, and spreadsheets. By the time you figure out what "the thing on the about page" refers to, you've already lost 20 minutes. Statamic Feedback puts feedback directly on the page where it belongs.

Native to Statamic: Built with Statamic's own UI components, so it looks and feels like part of the Control Panel on every screen, including the frontend widget. Uses flat-file storage, respects your permissions and roles.
Visual: Pin feedback to specific elements, capture pixel-perfect screenshots, see exactly what your client sees.
Collaborative: @mention teammates, leave threaded comments, track read status per user.
Linked to your content: Leave feedback on a frontend page and it shows up on that entry in the CP. Edit the entry and see the same feedback. Everything stays connected through Statamic's entry system.
Zero external services: No third-party accounts, no monthly fees. Everything stays on your server in Laravel's storage directory.
Localized: Ships with translations for all 29 languages that Statamic supports.
Tested: Comprehensive test suite with 150+ assertions covering permissions, storage, notifications, entry linking, and more.

Features

Visual Feedback

Pin annotations — click to pin feedback to any page element. Pins use element-relative coordinates, so they survive layout changes and work across screen sizes.
Screenshot capture — pixel-perfect screenshots via the browser's native screen capture API.
Frontend widget — embed on any page with a single Antlers tag. Only visible to logged-in CP users.

Entry Linking

Feedback created on a frontend page (e.g. /about) is automatically linked to the Statamic entry behind that page. Open the same entry in the CP and you see the same feedback.
Works the other way too: feedback left on the CP entry editor shows up on the frontend page.
Multi-site support — localizations share feedback via the origin entry ID. Feedback on /sv/om-oss and /about both show up together.

Collaboration

@mentions — tag teammates in feedback or comments with autocomplete.
Threaded comments — reply to any feedback item. New comments reset read status so nothing gets missed.
Read tracking — per-user read/unread status with visual indicators.
Notification preferences — users choose between all feedback, mentions only, or nothing. Uses Statamic's built-in Preferences system.

Control Panel Integration

Feedback widget — floating button on every CP page with tabbed views (All, Unread, Mentions, Mine).
Page scope toggle — switch between feedback for the current page or everything across the site.
Collection listing column — feedback count injected into entry listings so you can see at a glance which pages have open items.
Permission system — four granular permissions (view, create, delete own, manage all) configured through Statamic's roles.
Dark mode — full support for both light and dark CP themes.

Storage

Feedback is stored as flat YAML files in Laravel's storage directory, right alongside the rest of your application data. Screenshots are saved as image files next to the YAML. No database required, no external services, and everything can be version-controlled if you want.

Installation


composer require eminos/statamic-feedback

Quick Start

1. Install and go. The CP widget is enabled by default. Super admins can start leaving feedback on any Control Panel page right away. No configuration needed.

2. Set up permissions. Four granular permissions (view, create, delete own, manage all) let you control who can do what. Assign them through Statamic's roles system to give your team and clients access.

3. Add it to your frontend. Drop the tag into any Antlers layout to let CP users leave feedback directly on the live site:

{{ feedback_widget }}

Or with a custom position:


{{ feedback_widget position="bottom-right" }}

The tag only renders for logged-in CP users with feedback permissions. Regular visitors see nothing.

Documentation

Complete documentation is available in DOCUMENTATION.md:

Support

For support, questions, or feature requests, please open an issue on this GitHub repository.

Roadmap

Ideas we're considering for future releases:

Private feedback — feedback only visible to tagged/mentioned users
Screenshot annotations — draw, highlight, and annotate on captured screenshots
Browser metadata — capture viewport size, browser, and OS with each feedback item
Export — download feedback as CSV or JSON
Email notifications — notify users via email when they're mentioned or new feedback is posted
Filter and search — filter feedback by page, user, status, or date range
Bulk actions — resolve or delete multiple items at once