Skip to main content
Project Settings is where you control everything about how NOCK behaves for a specific project — from the look and feel of the feedback widget to third-party integrations and the project’s overall lifecycle. Changes you make here take effect for new widget sessions; some settings (like appearance and categories) are reflected immediately, while integration changes may require a page reload on the end-user side.

Accessing project settings

1

Open your project

From the NOCK dashboard, select the project you want to configure from the project switcher or the projects list.
2

Navigate to Settings

Click Settings in the left-hand navigation panel. The Project Settings page opens.

Widget configuration

The Widget Configuration section lets you control every aspect of how the NOCK widget looks and behaves on your site. Here’s a summary of what you can adjust:
SettingWhat it controls
PositionWhere the widget trigger appears on the page (bottom-right, bottom-left, etc.).
ColorThe primary accent colour of the widget.
IconThe icon displayed on the widget trigger button.
LabelThe text shown on or next to the trigger button.
CategoriesThe feedback categories users can choose from (includes built-in options and any custom categories you add).
Keyboard shortcutA keyboard combination that opens the widget without clicking the trigger.
Hidden modeHides the default trigger button so you can open the widget programmatically from your own UI.
Console log captureAutomatically attaches recent browser console output to every ticket.
AI enhancementEnables AI-generated follow-up questions to collect richer context from users.
For a full walkthrough of each widget option, including code examples for hidden mode and keyboard shortcuts, see Configure Your Widget.

Widget token

Your widget token is the unique identifier that connects the NOCK script on your site to this specific project. It is displayed in the Widget Token section of Project Settings and is used in your script tag embed.
<script src="https://cdn.usenock.com/widget.js" data-token="YOUR_TOKEN_HERE"></script>
Keep these points in mind:
  • Your widget token is not a secret password — it is embedded in your public-facing HTML, and that is expected. Anyone who views your page source can see it.
  • However, it is project-specific. Use the correct token for each project; mixing tokens across projects will route feedback to the wrong place.
  • If you need to rotate a token (for example, after accidentally assigning one to the wrong environment), contact support or delete and recreate the project.
Never paste another project’s token into your script tag. Tickets will appear under the wrong project and you will lose context about where the feedback originated.

Customer Portal

The Customer Portal is a shareable, read-only page where your users can view the status of their submitted tickets. The Customer Portal section in Project Settings lets you:
  • Enable or disable the portal for this project.
  • Copy the share link to distribute to your users or add to your product’s “My Feedback” page.
When the portal is disabled, the share link returns a 404 for anyone who tries to visit it. Make sure to disable the portal before archiving or sunsetting a project.
For setup instructions and customisation options, see Enable & Share the Customer Portal.

Linear integration

Connect NOCK to your Linear workspace to create and link Linear issues directly from ticket detail pages. The Linear Integration section in Project Settings is where you initiate and manage this connection. Once connected, a Create Linear Issue button appears on every ticket detail page, and any linked issues are shown inline with the ticket. For a step-by-step setup guide, see Connect Linear.

Danger zone

The Danger Zone section appears at the bottom of the Project Settings page. It contains irreversible actions — specifically, deleting the project.
Deleting a project is permanent. All tickets, comments, screenshots, and configuration for this project will be immediately and irrecoverably removed. This action cannot be undone. Make sure you have exported or recorded any information you need before proceeding.
1

Scroll to the Danger Zone section

It is located at the very bottom of the Project Settings page.
2

Click Delete Project

A confirmation dialog appears asking you to type the project name to confirm your intent.
3

Type the project name and confirm

Enter the project name exactly as shown, then click Delete. The project and all its data are removed immediately.

Configure Your Widget

Deep-dive into every widget configuration option with examples.

Customer Portal

Enable the portal and get a shareable link for your users.

Connect Linear

Link NOCK tickets to Linear issues for seamless issue tracking.