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

# Feedback

> Collect and triage visitor feedback on a pod from the CLI.

InstaPods can inject a pinned-comment widget into the pages your pod serves. Visitors click a spot on the page, leave a note, and it lands on your pod — no account, no setup on their side.

The `feedback` command drives the whole loop from the terminal: turn collection on, get the link to share, read what came back, and mark it done.

## Show the widget state and everything collected

```bash theme={null}
instapods feedback my-app
```

```
Feedback for my-app: enabled
Visibility:  link (only visitors who open the share link see the widget)
Share link:  https://my-app.nbg1-1.instapods.app/?fb=8f3c...

ID      FROM                  PAGE       STATUS  AGE            COMMENT
fb_a1   Dana <dana@acme.io>   /pricing   new     2 hours ago    The pricing table overflows on mobile
fb_b2   Sam                   /          read    1 day ago      Logo is blurry on retina

1 new  1 read  0 resolved
```

`instapods feedback list my-app` does the same thing, and takes a filter:

```bash theme={null}
instapods feedback list my-app --status new
```

Valid states: `new`, `read`, `resolved`.

## Turn collection on

```bash theme={null}
instapods feedback enable my-app
```

The widget is injected into the pod's live pages, so **the pod must be running**. On a stopped pod the setting is stored and applies on the next start.

Enabling prints the link to hand to your reviewers.

### Who sees the widget

| Visibility           | Behaviour                                                                                |
| -------------------- | ---------------------------------------------------------------------------------------- |
| `everyone` (default) | Every visitor of the pod URL sees the widget                                             |
| `link`               | The widget stays hidden unless the visitor opens the share link, which carries the token |

Use `link` to gather feedback from a named group — a client, a few teammates — without showing a comment box to the public.

```bash theme={null}
# Enable, visible only to people with the link
instapods feedback enable my-app --visibility link

# Change it later
instapods feedback visibility my-app everyone
```

### Rotate the share token

```bash theme={null}
instapods feedback rotate my-app
```

Mints a new token. Links you already handed out stop working — use it when a share link has spread further than you meant. `-f` skips the confirmation.

## Triage what came in

```bash theme={null}
# Mark one comment read or resolved
instapods feedback status my-app fb_a1 resolved

# Delete one comment
instapods feedback delete my-app fb_a1 -f
```

## Turn collection off

```bash theme={null}
instapods feedback disable my-app
```

The widget is removed from the pod's pages. Existing comments are kept — re-enabling shows them again.

## Flags

| Command  | Flag             | Description                                     |
| -------- | ---------------- | ----------------------------------------------- |
| `list`   | `-s`, `--status` | Only show `new`, `read`, or `resolved` feedback |
| `enable` | `--visibility`   | `everyone` or `link` (default `everyone`)       |
| `rotate` | `-f`, `--force`  | Skip the confirmation prompt                    |
| `delete` | `-f`, `--force`  | Skip the confirmation prompt                    |

<Note>
  Every command accepts `--json` for scripting.
</Note>