> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nocknock.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Project Settings: Manage Your NOCK Widget and Integrations

> Adjust your widget appearance, manage your widget token, configure the Customer Portal, connect Linear, and control project lifecycle from one place.

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

<Steps>
  <Step title="Open your project">
    From the NOCK dashboard, select the project you want to configure from the project switcher or the projects list.
  </Step>

  <Step title="Navigate to Settings">
    Click **Settings** in the left-hand navigation panel. The Project Settings page opens.
  </Step>
</Steps>

## 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:

| Setting                 | What it controls                                                                                             |
| ----------------------- | ------------------------------------------------------------------------------------------------------------ |
| **Position**            | Where the widget trigger appears on the page (bottom-right, bottom-left, etc.).                              |
| **Color**               | The primary accent colour of the widget.                                                                     |
| **Icon**                | The icon displayed on the widget trigger button.                                                             |
| **Label**               | The text shown on or next to the trigger button.                                                             |
| **Categories**          | The feedback categories users can choose from (includes built-in options and any custom categories you add). |
| **Keyboard shortcut**   | A keyboard combination that opens the widget without clicking the trigger.                                   |
| **Hidden mode**         | Hides the default trigger button so you can open the widget programmatically from your own UI.               |
| **Console log capture** | Automatically attaches recent browser console output to every ticket.                                        |
| **AI enhancement**      | Enables AI-generated follow-up questions to collect richer context from users.                               |

<Tip>
  For a full walkthrough of each widget option, including code examples for hidden mode and keyboard shortcuts, see [Configure Your Widget](/widget/configure-widget).
</Tip>

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

```html theme={null}
<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.

<Warning>
  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.
</Warning>

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

<Note>
  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.
</Note>

For setup instructions and customisation options, see [Enable & Share the Customer Portal](/customer-portal/enable-share-link).

## 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](/linear/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.

<Warning>
  **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.
</Warning>

<Steps>
  <Step title="Scroll to the Danger Zone section">
    It is located at the very bottom of the Project Settings page.
  </Step>

  <Step title="Click Delete Project">
    A confirmation dialog appears asking you to type the project name to confirm your intent.
  </Step>

  <Step title="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.
  </Step>
</Steps>

***

<CardGroup cols={3}>
  <Card title="Configure Your Widget" icon="sliders" href="/widget/configure-widget">
    Deep-dive into every widget configuration option with examples.
  </Card>

  <Card title="Customer Portal" icon="share" href="/customer-portal/enable-share-link">
    Enable the portal and get a shareable link for your users.
  </Card>

  <Card title="Connect Linear" icon="link" href="/linear/connect-linear">
    Link NOCK tickets to Linear issues for seamless issue tracking.
  </Card>
</CardGroup>