FeedbackPilot

FeedbackPilot is the WordPress plugin that turns your visitors' bug reports directly into issues in your GitHub repository - with an annotated screenshot, the page URL, the browser and server context and the latest console entries attached. You triage in GitHub as usual; your visitors just click a small button on the side of the screen.

How FeedbackPilot works - in three steps

1. The visitor clicks on an unobtrusive „Report problem” button at the edge of the screen.
2. FeedbackPilot creates a screenshot of the current page. The visitor draws on it where there is a problem.
3. Add a short description, submit - and seconds later a new issue will appear in your connected GitHub repository.

Who FeedbackPilot is made for

• Site operator, who want a low-friction bug report channel that doesn't end up in an email inbox.
• Agencies, who maintain customer sites and want to show their developers real reproduction context directly in the issue tracker.
• Product teams, who use WordPress as the front end of a larger application and manage their engineering work via GitHub anyway.

What ends up in the GitHub issue

• Title: „[Bug] first 60 characters of the description...” (or „[Feedback]” for suggestions).
• Description of the users:in, cited.
• Annotated screenshot as an embedded PNG.
• Browser context: User agent, viewport, language, platform, pixel ratio, light/dark.
• Server context: WordPress version, PHP version, active theme, list of active plugins, locale.
• Console log: the last 200 entries (collapsed in a
  block).
• Labels: bug, feedbackpilot.

What is deliberately not transferred

• No cookies, no localStorage, no form content.
• No IP addresses, no tracking, no analytics pixels.
• No content from other browser tabs or windows.
• No tokens, no secrets, no admin-only data.

Why not another SaaS tool?

Bug reports from visitors are an engineering input. They belong in the same inbox as branch reviews, deploys and roadmap planning - which for most teams is GitHub. Tools such as Marker.io, Userback or Usersnap do similar things, but are external services with their own inbox, subscription and data storage. FeedbackPilot remains in the tools you already use: WordPress up front, GitHub behind, no new contracts, no additional tracking script on your site. The code is open source under the GPL 2.0 - you can read it, adapt it, host it yourself.

Connection to GitHub - in two clicks

After the installation, open Settings → FeedbackPilot and click Connect to GitHub. You will be redirected to github.com, authorize the FeedbackPilot app, and end up back in the WordPress admin - with an encrypted token. You then enter the target repository (format owner/repo) and select the visitor roles that should see the widget. Done.

If you cannot or do not want to use the OAuth flow, paste a fine-grained personal access token with „Issues: Read & Write” authorization on the target repository. Both methods work in the same way.

What you need

• WordPress 6.0 or newer.
• PHP 7.4 or newer (PHP 8.0 and higher recommended).
• A GitHub account with a repository in which you can create issues - the free GitHub plan is sufficient.

Installation in under two minutes

1. ZIP file after download via Plugins → Install → Upload plugin record.
2. Activate.
3. Under Settings → FeedbackPilot connect to GitHub and select the target repository.
4. Enter the license key - so that the plugin updates itself automatically in future.

Frequently asked questions

Do I need a paid GitHub plan?

No. Free GitHub accounts can also create issues in their own repositories. The plugin works identically in both worlds.

Does it work with private repositories?

Yes, the OAuth flow authorizes the FeedbackPilot app on the repos you select - including private ones. The manual PAT path works in the same way.

Does the widget slow down my site?

No. The only external library (html2canvas) is only loaded when a visitor actually clicks on the button. Until then, only a small CSS file and a small JavaScript file are active. The effect on page speed and core web vitals is negligible.

Does it work with caching plugins, Cloudflare or WP Rocket?

Yes, the widget scripts are static and are cached without any problems. Configuration changes are read when the page is loaded and do not require a cache reset.

Can I send reports to something other than GitHub?

In the current version 0.1.x, GitHub is the only target. If sending emails, Slack or linear tickets would unblock you, we would be happy to receive your suggestion in the GitHub repository.

Where is the screenshot?

On your WordPress page under wp-content/uploads/feedbackpilot/. The GitHub image links the image from there. It is not uploaded to a third-party provider.

License, updates and support

FeedbackPilot is free software under the GPL-2.0-or-later - the same license as WordPress itself. The download on this page is and remains free of charge. With the included license key, you will receive automatic updates via the normal WordPress update mechanism. You can find the complete source code on GitHub. Questions, bug reports and feature requests are welcome via the repository or by email to hello@isla-stud.io.