Step 1 — Check the widget button appears
Open your live site
Navigate to any page of your site where the snippet is installed. Use the same browser you use day-to-day (no special browser or incognito mode needed for this check).
Step 2 — Send a test ticket
Click the feedback button
Click the floating widget button. The feedback form opens as an overlay on your page.
Fill in the form
Choose a feedback type — Bug, Feature, or General — then type a short test message such as:
“This is a test ticket from the NOCK setup guide.”You don’t need to fill in every field. A type and a message are enough to send a valid submission.
Step 3 — Verify the ticket in the Dashboard
Open your project in the NOCK Dashboard
Go to nocknock.cloud, open your workspace, and select the project you installed the widget on.
Find the ticket in your inbox
Click Inbox or Tickets in the left sidebar. Your test submission should appear at the top of the list within a few seconds of submitting it.
Open the ticket and inspect the captured context
Click on the ticket to open it. NOCK automatically captures and attaches the following context alongside every submission:
If the ticket appears with all this context, your installation is complete and working correctly.
| Data | What you’ll see |
|---|---|
| Browser | Browser name and version (e.g. Chrome 124) |
| Operating system | OS name and version (e.g. macOS 14.4) |
| Viewport | Screen dimensions of the submitter’s device |
| Page URL | The exact URL where the widget was open when feedback was submitted |
| Screenshot | A screenshot of the page at the time of submission (if enabled) |
| Console logs | Recent browser console output (if enabled) |
Screenshot capture and console log capture can be toggled on or off in Settings → Widget. If you don’t see these fields on your test ticket, check that the features are enabled in your project settings.
The button isn’t appearing
If you don’t see the widget button after loading your site, work through this checklist:- Wrong placement — The snippet might be inside a component that doesn’t render on every page, or it was added to
<head>instead of<body>. Confirm the script tag is inside<body>, before</body>, in a persistent layout. - Token mismatch or missing token — Open your browser’s developer console (F12) and check for errors mentioning
nock.jsor an invalid token. Compare thedata-tokenvalue in your HTML against the token shown in Settings → Widget. - Script blocked by an ad blocker or CSP — Some browser extensions or Content Security Policies block third-party scripts. Try in a clean browser profile without extensions, or review your CSP headers to ensure
nocknock.cloudis allowed. - Caching — If you’re testing after a deployment, do a hard refresh (
Ctrl + Shift + R/Cmd + Shift + R) or clear your browser cache to make sure you’re seeing the latest version of your page. - Snippet on wrong environment — If you installed the snippet in a staging environment but are testing in production (or vice versa), the button won’t appear because the script simply isn’t loaded on that page.
What’s next?
Your widget is live and verified. Explore the configuration options to tailor the widget’s appearance, behaviour, and data-capture features to your product.Configure the Widget
Customise button position, colours, feedback types, and data capture settings.
Invite Your Team
Bring your teammates into the workspace so they can triage and respond to feedback.