Skip to main content
Once you’ve added the snippet to your site, spend two minutes running through this quick test to make sure everything is working end to end. You’ll confirm the widget button is visible, submit a real piece of test feedback, and verify the ticket arrives in your NOCK Dashboard with all the automatic context attached.

Step 1 — Check the widget button appears

1

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).
2

Look for the NOCK feedback button

The NOCK widget button appears as a small floating button, typically in the bottom-right corner of the page. By default it shows a chat or feedback icon. If you see it, the script loaded successfully.
If you customised the button position or colour in Settings → Widget, look in the position you configured rather than the default corner.

Step 2 — Send a test ticket

1

Click the feedback button

Click the floating widget button. The feedback form opens as an overlay on your page.
2

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.
3

Submit the feedback

Click Send (or the equivalent submit button in your widget theme). You should see a confirmation message inside the widget overlay telling you the feedback was received.

Step 3 — Verify the ticket in the Dashboard

1

Open your project in the NOCK Dashboard

Go to nocknock.cloud, open your workspace, and select the project you installed the widget on.
2

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.
3

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:
DataWhat you’ll see
BrowserBrowser name and version (e.g. Chrome 124)
Operating systemOS name and version (e.g. macOS 14.4)
ViewportScreen dimensions of the submitter’s device
Page URLThe exact URL where the widget was open when feedback was submitted
ScreenshotA screenshot of the page at the time of submission (if enabled)
Console logsRecent browser console output (if enabled)
If the ticket appears with all this context, your installation is complete and working correctly.
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.js or an invalid token. Compare the data-token value 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.cloud is 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.
Using the wrong project token won’t prevent the button from appearing, but any tickets submitted will arrive in the wrong project’s inbox. Always double-check the token matches the project you’re monitoring.

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.