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

# Hidden Mode — Invisible Widget Button for Stealth Feedback

> Hidden mode removes the visible NOCK button from your UI. Users trigger the widget via a keyboard shortcut or a programmatic call instead.

Hidden mode makes the NOCK widget button completely invisible on the page. The widget itself still works exactly as normal — users just can't see a button to click. Instead, they open it using a keyboard shortcut you configure, or your application opens it programmatically at the right moment. Everything else — form, categories, AI follow-up, screenshots, console logs — works exactly as normal.

## When to use hidden mode

Hidden mode is a good fit for several scenarios:

* **Internal QA and testing workflows** — Your QA team can use a shared keyboard shortcut to file bugs without a feedback button being visible to end users during a testing session.
* **Consumer-facing products where UI cleanliness matters** — If a persistent button would feel intrusive or off-brand, hidden mode lets you offer feedback collection without cluttering the interface.
* **Embedded or white-labeled tools** — When NOCK is running inside a product where you don't want NOCK branding or any extra UI visible to the end user.
* **Programmatic trigger flows** — You can open the widget at a specific moment in your product's flow (for example, after a user completes a task) without showing a persistent button.

## Enabling hidden mode

<Steps>
  <Step title="Open Settings → Widget">
    In your NOCK Dashboard, click **Settings** in the sidebar and select the **Widget** tab.
  </Step>

  <Step title="Enable Hidden Mode">
    Find the **Hidden Mode** toggle and switch it on.
  </Step>

  <Step title="Save your changes">
    Click **Save**. The widget button will immediately become invisible on all pages that load the NOCK script.
  </Step>
</Steps>

<Warning>
  Once you enable hidden mode and save, the visible button disappears immediately. Make sure you have a keyboard shortcut configured before saving, so you (and any users who need it) can still open the widget.
</Warning>

## Setting a keyboard shortcut

You can configure a keyboard shortcut alongside hidden mode so that pressing a key combination opens the widget.

<Steps>
  <Step title="Open Settings → Widget">
    Navigate to **Settings → Widget** in your Dashboard.
  </Step>

  <Step title="Configure the Keyboard Shortcut">
    In the **Keyboard Shortcut** field, click the input and press the key combination you want to use (for example, `Shift + F` or `Ctrl + Shift + K`). NOCK records the combination you press.
  </Step>

  <Step title="Save your changes">
    Click **Save**. The shortcut is now active on every page that loads the widget.
  </Step>
</Steps>

<Note>
  Choose a shortcut that is unlikely to conflict with your application's own keyboard shortcuts or common browser shortcuts. A combination that includes **Shift** or both **Ctrl/Cmd** and another modifier key is usually safe.
</Note>

## Programmatic triggering

In addition to the keyboard shortcut, you can open the NOCK widget from your own application code. This is useful when you want to surface the feedback form in response to a specific user action — such as clicking a custom button you've built, completing a workflow step, or encountering an error state in your UI.

Refer to your Dashboard's **Settings → Widget** page for the programmatic trigger details specific to your project setup. No changes to the script tag are needed.

<Tip>
  Programmatic triggering pairs well with hidden mode in QA workflows: trigger the widget automatically when an assertion fails in a test, and have NOCK capture the page state, console logs, and a screenshot all at once.
</Tip>

<CardGroup cols={2}>
  <Card title="Configure the Widget" icon="sliders" href="/widget/configure-widget">
    Review all widget settings including keyboard shortcut options.
  </Card>

  <Card title="Troubleshooting" icon="wrench" href="/widget/troubleshooting">
    Widget not opening in hidden mode? Check the troubleshooting guide.
  </Card>
</CardGroup>