Configure the NOCK Widget
Configure the widget launcher layout, position, icon, label, colors, shortcut, and hidden-mode trigger from Settings > Widget.
The Widget tab controls the launcher users click to open the feedback form. It does not control categories, console capture, AI, or the install snippet; those live in their own settings tabs.
Open your project, go to Settings > Widget, adjust the launcher, then click Save Widget. Changes apply to newly loaded widget sessions without changing your script tag.
Layout
| Layout | Use it when | Position options |
|---|---|---|
| Floating | You want the classic round feedback button. | bottom-right, bottom-left, top-right, top-left |
| Side Tab | You want a narrow vertical tab on the screen edge. | side-right, side-left |
| Pill | You want a compact edge capsule. | side-right, side-left |
| Bottom Bar | You want a full-width bar at the bottom. | Position is ignored |
Choose the smallest launcher that users can still discover. Floating is the default; side tab and pill are useful when your app already has bottom-corner controls.
Mode
| Mode | Behavior |
|---|---|
| Visible | The launcher is visible as soon as the widget loads. |
| Hidden | The launcher is hidden until a shortcut, ?nock, or secret gesture reveals it. |
Hidden mode keeps the widget installed without adding persistent UI. See Hidden Mode for the trigger details.
Icon
You can choose one of the built-in icon presets:
| Preset | Good fit |
|---|---|
| Message | General feedback |
| Chat | Support-style feedback |
| Idea | Feature requests |
| Announce | Campaign or beta feedback |
| Bug | Bug reporting |
| Heart | Customer sentiment |
| Star | Reviews or praise |
| Zap | Fast issue reporting |
| Pencil | Editorial or content feedback |
| Hand | Human help or contact |
You can also set a custom icon URL. A custom URL overrides the selected preset.
Label
The label field appears for Side Tab and Bottom Bar layouts.
| Layout | Label behavior |
|---|---|
| Side Tab | Label is displayed vertically on the side tab. |
| Bottom Bar | Label is displayed beside the icon. |
| Floating or Pill | Label is not shown. |
Keep labels short, for example Feedback or Send feedback.
Colors
Set:
| Field | What it controls |
|---|---|
| Primary Color | Launcher background and primary accents. |
| Text Color | Text and icon color on the launcher. |
Use enough contrast for the launcher to remain readable on your site.
Shortcut
The keyboard shortcut opens the widget without clicking the launcher. The default is Ctrl+Shift+F, which fires on both Ctrl (Windows/Linux) and Cmd (macOS).
Supported modifiers include Ctrl, Cmd, Meta, Shift, Alt, and Option, plus a final key such as F.
Note
Shortcuts are global while the widget is loaded. Avoid combinations already used by your app or common browser shortcuts.
Related settings
Use these pages for settings outside the Widget tab: