# Scope

Source: https://zshot-cli.com/reference/navigator/scope/
Markdown: https://zshot-cli.com/reference/navigator/scope/index.md
Section: [Reference](https://zshot-cli.com/reference/) › [Navigator](https://zshot-cli.com/reference/navigator/)

The navigator may go where its [`--navigator-initial-scope`](/reference/flags/navigator/navigator-initial-scope) and any [`--navigator-allow-url`](/reference/flags/navigator/navigator-allow-url) globs admit. Links whose target is outside are hidden from the navigator, and every navigation outside is blocked.

## Initial Scope

`domain` is the registrable domain: the same scope a credential gets without [`--navigator-credential-origin`](/reference/flags/navigator/navigator-credential-origin), and the one a crawl stays within. A host without one, such as an IP address or `localhost`, is its origin. From an `http` start, `domain` admits `https` too.

`path` is the start URL's folder, up to its last `/`, so a start of `https://zshot-cli.com/example_assets` is the folder `/`: the whole origin. Use it to keep the navigator in one section, such as a wiki section or one tenant's area of a shared host.

The scope comes from the URL as given, so a redirect at start does not move it. A `file:` start is its folder and descendants under every scope.

## Globs

[`--navigator-allow-url`](/reference/flags/navigator/navigator-allow-url) and [`--navigator-credential-origin`](/reference/flags/navigator/navigator-credential-origin) take these globs.

| Glob | Matches |
|---|---|
| `*.zshot-cli.com` | every path on a subdomain of zshot-cli.com, on the default port |
| `*.zshot-cli.com/accounts/*` | only paths under `/accounts/` there |
| `localhost:8080` | every path on that host and port |
| `/docs/*` | that path on the start URL's own host |
| `https://zshot-cli.com` | every path on that origin, scheme as written |
| `*` | any URL |

A glob without a scheme is https, or http and https when the start URL is http. A port matches only when written; `host:*` is any port but the default. A `*` before the first `/` stays within the host, so `https://*.zshot-cli.com/*` never matches `https://evil.test/?x=www.zshot-cli.com/`. Within the path `*` spans `/`, and `*/**/admin/*` finds `admin` at any depth on any host. Alternation such as `{a,b}.zshot-cli.com/{x,y}/*` works within either half and cannot cross the first `/`. Write an IPv6 host as `[[]::1]:8080`.

From a `file:` start every glob without a scheme is a path: `/srv/site/*` as written, `*/admin` or `./*/admin` under the start file's folder, `../shared/*` one folder up. Name a web host from a file start with its scheme.

## New Tabs and Windows

A link or script that opens a new tab or window never opens one. In a navigation session its URL is listed for the navigator as a tab or window it can switch to, and only when the scope admits it.

## Related

Flags:

- [`--navigator-initial-scope`](https://zshot-cli.com/reference/flags/navigator/navigator-initial-scope/)
- [`--navigator-allow-url`](https://zshot-cli.com/reference/flags/navigator/navigator-allow-url/)
- [`--navigator-credential-origin`](https://zshot-cli.com/reference/flags/navigator/navigator-credential-origin/)
- [`--crawl-allow-url`](https://zshot-cli.com/reference/flags/archive/crawl-allow-url/)

## 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/)
  - [Agents](https://zshot-cli.com/reference/agents/)
  - [Configuration](https://zshot-cli.com/reference/configuration/)
  - [Crawling](https://zshot-cli.com/reference/crawling/)
  - [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/)
    - [Actions](https://zshot-cli.com/reference/navigator/actions/)
    - [Navigators](https://zshot-cli.com/reference/navigator/navigators/)
    - **Scope**
    - [Credentials](https://zshot-cli.com/reference/navigator/credentials/)
    - [Data and Files](https://zshot-cli.com/reference/navigator/data-and-files/)
  - [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