Add Qaid to your site
5 guidesGet the embed live and collecting feedback, then keep it healthy.
Dashboard Quick Start: Your First Feedback
Sign in, create a project, paste one script tag, and read the first piece of feedback.
Getting Started with Qaid Themes
Swap the plain feedback buttons for one of 17 built-in presets, from the dashboard or by hand.
Getting Started with Quests
Build a quest in the dashboard, paste its snippet onto your page, and start collecting step-by-step answers.
Install the Feedback Embed: Script Tag, npm and Browser Support
The script tag, the JSON config block, npm, the UMD build, self-hosting, which browsers it runs in, and every option the widget takes.
Troubleshooting: Common Issues and Solutions
Find why the feedback widget doesn't show, doesn't send, or sends less than you expected, and fix it.
Manage & route feedback
6 guidesTurn a busy inbox into insight, and share the work across your team.
Arrange Your Command Center
Add, move, resize and remove the panels on your dashboard home, and point each one at a project.
Triage the Inbox
Filter and search your feedback, act on one item or many at once, read the full record, keep notes and archive what is done.
Feedback Insights: See What Your Users Are Telling You
Read the totals and charts for a project, group its messages into AI themes, and jump from any bar to the items behind it.
Team Collaboration: Invites, Roles and Assignment
Invite teammates to a project, choose Owner or Member, and give each piece of feedback an owner.
Notifications: the Bell and Your Email
What the bell shows, how to turn on email, and which events send one.
Escalation Rules: Flag the Feedback That Matters
Write rules that flag urgent feedback by page, words, type, errors or screenshot, and see what an escalation sets off.
Customize the look
6 guidesMatch the feedback buttons and modal to your brand.
The Embed Customizer
Style the feedback buttons for one project, preview them live, and copy a snippet that carries every setting.
Styling the Feedback Embed: CSS, Tokens and Dark Mode
How your CSS reaches the feedback widget, every class it draws, the tokens it reads, dark mode, the phone sheet and the thank-you screen.
Brand Color Matching
The three colour settings, every part of the widget each one paints, the parts none of them reach, and dark mode.
Custom CSS: Button Styles and Effects
Replace the default feedback buttons with your own class and CSS, style each button apart, and add effects that respect reduced motion.
Custom Button Icons
Swap the thumbs for your own SVG or an emoji, on the buttons and in the message box.
Public Theme Gallery: Share Your Designs
Browse the community's feedback-button themes, use one on your site, and share your own.
Place & tailor the feedback embed
5 guidesDecide where feedback appears and what the form asks for.
Position & Placement: Where to Put Your Feedback Buttons
Pick a corner, move the buttons off the edge, stack them in a column, mount them inside your page, and settle stacking fights with other fixed things.
The Feedback Message Box: What It Holds and How It Behaves
The box that opens after a thumb click: its toggle, its one button, when the vote is saved, where it opens, its width and the thank-you screen.
Element Targeting: Pinpoint Feedback on Any Element
After a thumb click the visitor points at what the feedback is about, with a mouse, a finger or the keyboard. What they see, what arrives, and how to make the selectors readable.
Conditional Display: Show Feedback at the Right Time
Start the widget in code on the pages and for the people you choose, take it down again, and decide how visitors can hide it.
What Changes on a Phone
What the feedback widget does differently on a small or touch screen by itself, and the few settings worth changing for phones.
Capture richer feedback
4 guidesAttach the visual and technical context that makes a report actionable.
Screenshot Capture: Visual Context for Feedback
Attach a picture of the page to each report, from the browser or from Qaid's servers, and control who can see it.
Annotate & Redact Screenshots
Let visitors box, point at, draw on and black out parts of their screenshot before it is sent.
Video Feedback: Screen Recording for Bug Reports
Add a record button so visitors can send a short recording of the tab, with their own description, console lines and failed requests.
Console Error Capture: Debug Without Asking
The widget records the page's last 20 console lines and sends them with each report. What it catches, what it misses, and how to keep secrets out.
Build quests
6 guidesAsk structured, multi-step questions with the quests embed.
Build a Quest in the Dashboard
Start from a template, edit questions visually or as JSON, add show-if rules, publish a version and roll back.
Read Quest Responses and Analytics
Read each answer on a quest's Responses page, filter finished from in progress, and read the per-question charts on Analytics.
Branching Forms with `visibleIf`
Show a quest question only when earlier answers call for it: every operator, how they combine, and the rules the editor enforces.
Style the Quests Embed
Colours, fonts, presets, light and dark, --qaid-q tokens, custom CSS and saved themes for @qaiddev/quests-embed.
Design and Publish a Quest Theme
Build a reusable quest theme from colour, type and spacing tokens, publish a version, and wire it to your site from Customize.
Ask Follow-Up Questions: Link Thumbs Buttons to Quests
Open a quest after a thumbs-up, a thumbs-down or a screen recording, instead of the message box.
Integrations & automation
5 guidesPush feedback and quest events into the tools you already use, build on the data yourself, or hand it to an AI agent.
Webhooks & Slack: Push Feedback Into Your Stack
Post new feedback, escalations and quest answers to a Slack channel, or send them as signed JSON to your own endpoint.
Linear & Jira: Turn Feedback Into Tickets
Connect Linear or Jira to a project, file issues from one item or many, open them for escalations, and archive feedback when the issue closes.
GitHub Issues and AI Pull Requests
Link a repository, turn feedback into GitHub issues, and on Pro have Claude or Copilot propose the fix.
The Platform API: Build On Your Own Feedback Data
Read and change your project's data from your own code, over a JSON API.
The Dashboard Assistant: Ask For It Instead of Clicking For It
A chat panel in the dashboard that reads and triages your feedback, drafts quests and edits themes, acting as you.
Account, plans & projects
3 guidesYour plan, your billing, and each project’s keys and data.
Free vs Pro
Every limit and every feature by plan, with what Free does when you reach for a Pro one.
Your Account, Plan and Billing
Change your name and photo, add a sign-in, check your plan and seats, pay for Pro, export your data or delete your account.
Project Settings: Name, Domain, Keys and Data
Rename a project, lock it to your site, make and revoke embed keys, export its feedback, and archive it.
Words and access
2 guidesChange what the embed says, and what it does for keyboard and screen reader users.
Text Customization & Internationalization
Every string in the feedback widget, its default and its script attribute, how to translate them, and the words no option reaches yet.
Accessibility: What the Embeds Do and What Stays Yours
What the thumbs and quests widgets do for keyboard and screen-reader users today, how to check it on your site, and the gaps that are yours to cover.