# --navigator-renders-when-impossible

Source: https://zshot-cli.com/reference/flags/navigator/navigator-renders-when-impossible/
Markdown: https://zshot-cli.com/reference/flags/navigator/navigator-renders-when-impossible/index.md
Section: [Reference](https://zshot-cli.com/reference/) › [Flags](https://zshot-cli.com/reference/flags/) › [Navigator](https://zshot-cli.com/reference/flags/navigator/)
CLI: `--navigator-renders-when-impossible` · REST: [`navigator_renders_when_impossible`](https://zshot-cli.com/reference/server/api/schema/#navigator_renders_when_impossible)
License: [Pro](https://zshot-cli.com/support/licenses/pro)

When the navigator answers `IMPOSSIBLE`, the navigation ends as one that succeeded and zshot exits 0. A `goal` output is the reason the navigator gave, and an `llm_text` or `llm_json` formatter reads it in its account of the navigation. Use it for a task the navigator may not be able to finish, where what it found is the answer: a JSON Schema with a field such as `incomplete_reasons` lets the formatter say what the form still needs. A navigation that runs out of steps or fails with an error still exits 9. The page the navigation ends on is judged by its HTTP status, so a session that stops on a form's error page, often a 422, renders only with `--no-fail`.

## Example

**CLI**

```sh
zshot -t llm_json -f claim.json \
  --navigator-type "anthropic://YOUR_API_KEY@" \
  --navigate "Fill in the claim form, or say what information it still needs" \
  --navigator-renders-when-impossible \
  --llm-format-expects '{"type":"object","properties":{"form_complete":{"type":"boolean"},"incomplete_reasons":{"type":"array","items":{"type":"string"}}},"required":["form_complete","incomplete_reasons"]}' \
  https://example.com/claim
```

**JSON** — `POST /` body for the [API](/reference/server/api), Pro license

```json
{
  "url": "https://example.com/claim",
  "output_type": "llm_json",
  "navigate": "Fill in the claim form, or say what information it still needs",
  "navigator_renders_when_impossible": true,
  "navigator_type": ["anthropic://YOUR_API_KEY@"],
  "llm_format_expects": "{\"type\":\"object\",\"properties\":{\"form_complete\":{\"type\":\"boolean\"},\"incomplete_reasons\":{\"type\":\"array\",\"items\":{\"type\":\"string\"}}},\"required\":[\"form_complete\",\"incomplete_reasons\"]}"
}
```

**curl**

```sh
curl -X POST http://127.0.0.1:3000/ \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/claim","output_type":"llm_json","navigate":"Fill in the claim form, or say what information it still needs","navigator_renders_when_impossible":true,"navigator_type":["anthropic://YOUR_API_KEY@"],"llm_format_expects":"{\"type\":\"object\",\"properties\":{\"form_complete\":{\"type\":\"boolean\"},\"incomplete_reasons\":{\"type\":\"array\",\"items\":{\"type\":\"string\"}}},\"required\":[\"form_complete\",\"incomplete_reasons\"]}"}' \
  -o claim.json
```

## Related

Flags:

- [`--navigate`](https://zshot-cli.com/reference/flags/navigator/navigate/)
- [`--navigator-max-steps`](https://zshot-cli.com/reference/flags/navigator/navigator-max-steps/)
- [`--no-fail`](https://zshot-cli.com/reference/flags/common/no-fail/)

Topics:

- [Exit Codes](https://zshot-cli.com/reference/exit_codes/)

## Navigation

- [Examples](https://zshot-cli.com/examples/)
- [Download](https://zshot-cli.com/download/)
- [Purchase](https://zshot-cli.com/purchase/)
- [Reference](https://zshot-cli.com/reference/)
  - [Formats](https://zshot-cli.com/reference/formats/)
  - [Flags](https://zshot-cli.com/reference/flags/)
    - [Common](https://zshot-cli.com/reference/flags/common/)
    - [Agents](https://zshot-cli.com/reference/flags/agents/)
    - [Archive](https://zshot-cli.com/reference/flags/archive/)
    - [Browser](https://zshot-cli.com/reference/flags/browser/)
    - [Diagnostics](https://zshot-cli.com/reference/flags/diagnostics/)
    - [Document](https://zshot-cli.com/reference/flags/document/)
    - [Image](https://zshot-cli.com/reference/flags/image/)
    - [Navigator](https://zshot-cli.com/reference/flags/navigator/)
      - [--navigate](https://zshot-cli.com/reference/flags/navigator/navigate/)
      - [--navigator-allow-url](https://zshot-cli.com/reference/flags/navigator/navigator-allow-url/)
      - [--navigator-captures-playwright](https://zshot-cli.com/reference/flags/navigator/navigator-captures-playwright/)
      - [--navigator-captures-puppeteer](https://zshot-cli.com/reference/flags/navigator/navigator-captures-puppeteer/)
      - [--navigator-captures-video](https://zshot-cli.com/reference/flags/navigator/navigator-captures-video/)
      - [--navigator-credential](https://zshot-cli.com/reference/flags/navigator/navigator-credential/)
      - [--navigator-credential-env](https://zshot-cli.com/reference/flags/navigator/navigator-credential-env/)
      - [--navigator-credential-helper](https://zshot-cli.com/reference/flags/navigator/navigator-credential-helper/)
      - [--navigator-credential-helper-env](https://zshot-cli.com/reference/flags/navigator/navigator-credential-helper-env/)
      - [--navigator-credential-helper-timeout](https://zshot-cli.com/reference/flags/navigator/navigator-credential-helper-timeout/)
      - [--navigator-credential-origin](https://zshot-cli.com/reference/flags/navigator/navigator-credential-origin/)
      - [--navigator-credential-secret](https://zshot-cli.com/reference/flags/navigator/navigator-credential-secret/)
      - [--navigator-data](https://zshot-cli.com/reference/flags/navigator/navigator-data/)
      - [--navigator-data-json](https://zshot-cli.com/reference/flags/navigator/navigator-data-json/)
      - [--navigator-escalation-max](https://zshot-cli.com/reference/flags/navigator/navigator-escalation-max/)
      - [--navigator-file](https://zshot-cli.com/reference/flags/navigator/navigator-file/)
      - [--navigator-file-size-limit](https://zshot-cli.com/reference/flags/navigator/navigator-file-size-limit/)
      - [--navigator-file-timeout](https://zshot-cli.com/reference/flags/navigator/navigator-file-timeout/)
      - [--navigator-goal](https://zshot-cli.com/reference/flags/navigator/navigator-goal/)
      - [--navigator-initial-scope](https://zshot-cli.com/reference/flags/navigator/navigator-initial-scope/)
      - [--navigator-max-steps](https://zshot-cli.com/reference/flags/navigator/navigator-max-steps/)
      - **--navigator-renders-when-impossible**
      - [--navigator-session-archived](https://zshot-cli.com/reference/flags/navigator/navigator-session-archived/)
      - [--navigator-stall-escalation](https://zshot-cli.com/reference/flags/navigator/navigator-stall-escalation/)
      - [--navigator-step-timeout](https://zshot-cli.com/reference/flags/navigator/navigator-step-timeout/)
      - [--navigator-type](https://zshot-cli.com/reference/flags/navigator/navigator-type/)
      - [--navigator-video-captions-position](https://zshot-cli.com/reference/flags/navigator/navigator-video-captions-position/)
      - [--navigator-video-height](https://zshot-cli.com/reference/flags/navigator/navigator-video-height/)
      - [--navigator-video-shows-captions](https://zshot-cli.com/reference/flags/navigator/navigator-video-shows-captions/)
      - [--navigator-video-shows-pointer](https://zshot-cli.com/reference/flags/navigator/navigator-video-shows-pointer/)
      - [--navigator-video-width](https://zshot-cli.com/reference/flags/navigator/navigator-video-width/)
    - [Security](https://zshot-cli.com/reference/flags/security/)
    - [Server](https://zshot-cli.com/reference/flags/server/)
    - [Video](https://zshot-cli.com/reference/flags/video/)
  - [Agents](https://zshot-cli.com/reference/agents/)
  - [Configuration](https://zshot-cli.com/reference/configuration/)
  - [Crawling](https://zshot-cli.com/reference/crawling/)
  - [Devices](https://zshot-cli.com/reference/devices/)
  - [Docker](https://zshot-cli.com/reference/docker/)
  - [Exit Codes](https://zshot-cli.com/reference/exit_codes/)
  - [Linux](https://zshot-cli.com/reference/linux/)
  - [LLM Connections](https://zshot-cli.com/reference/llm_connections/)
  - [LLM Formatting](https://zshot-cli.com/reference/llm_formatting/)
  - [Local Inputs](https://zshot-cli.com/reference/inputs/)
  - [Navigator](https://zshot-cli.com/reference/navigator/)
  - [Security](https://zshot-cli.com/reference/security/)
  - [Server](https://zshot-cli.com/reference/server/)
  - [Shell completions](https://zshot-cli.com/reference/shell_completions/)
  - [Storage](https://zshot-cli.com/reference/storage/)
  - [Timeouts](https://zshot-cli.com/reference/timeouts/)
  - [Web Bot Auth](https://zshot-cli.com/reference/web_bot_auth/)
- [Support](https://zshot-cli.com/support/)
- [Changelog](https://zshot-cli.com/changelog/)

Site index: https://zshot-cli.com/llms.txt