# --axtree

Source: https://zshot-cli.com/reference/flags/diagnostics/axtree/
Markdown: https://zshot-cli.com/reference/flags/diagnostics/axtree/index.md
Section: [Reference](https://zshot-cli.com/reference/) › [Flags](https://zshot-cli.com/reference/flags/) › [Diagnostics](https://zshot-cli.com/reference/flags/diagnostics/)
CLI: `--axtree` · REST: [`with_axtree`](https://zshot-cli.com/reference/server/api/schema/#with_axtree)
Value: `PATH`
License: [Standard](https://zshot-cli.com/support/licenses/standard)

Writes an [accessibility tree](/reference/formats/axtree) alongside the render. The path's extension picks the form: `.txt` or `.text` for the indented snapshot, anything else for JSON with bounding boxes.

## Several URLs

Each render writes its own tree, numbered like the primary output: `page.json` becomes `page-1.json`, `page-2.json`.

## Timed Output

With video or an animated image, the tree reflects the last frame. `--log-level warn` reports this.

## Server

`with_axtree` takes `true` or `json` for the JSON tree and `text` for the snapshot. The tree is returned as a `Link` response header.

## Example

**CLI**

```sh
zshot -f page.png \
  --axtree page.json \
  https://zshot-cli.com/example_assets/gazette/
```

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

```json
{
  "url": "https://zshot-cli.com/example_assets/gazette/",
  "output_type": "png",
  "with_axtree": "json"
}
```

**curl**

```sh
curl -X POST http://127.0.0.1:3000/ \
  -H "Content-Type: application/json" \
  -d '{"url":"https://zshot-cli.com/example_assets/gazette/","output_type":"png","with_axtree":"json"}' \
  -D - -o page.png
```

## Related

Flags:

- [`--axtree-only-visible`](https://zshot-cli.com/reference/flags/diagnostics/axtree-only-visible/)
- [`--server-additional-asset-expiration`](https://zshot-cli.com/reference/flags/server/server-additional-asset-expiration/)

Topics:

- [AXTree](https://zshot-cli.com/reference/formats/axtree/)
- [API](https://zshot-cli.com/reference/server/api/)
- [Chrome Accessibility Tree](https://developer.chrome.com/blog/full-accessibility-tree)

## 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/)
      - **--axtree**
      - [--axtree-only-visible](https://zshot-cli.com/reference/flags/diagnostics/axtree-only-visible/)
      - [--llm-debug](https://zshot-cli.com/reference/flags/diagnostics/llm-debug/)
      - [--llm-usage](https://zshot-cli.com/reference/flags/diagnostics/llm-usage/)
      - [--network-log](https://zshot-cli.com/reference/flags/diagnostics/network-log/)
      - [--pprof-captures-navigation](https://zshot-cli.com/reference/flags/diagnostics/pprof-captures-navigation/)
      - [--pprof-cpu](https://zshot-cli.com/reference/flags/diagnostics/pprof-cpu/)
      - [--pprof-cpu-interval-us](https://zshot-cli.com/reference/flags/diagnostics/pprof-cpu-interval-us/)
      - [--pprof-memory](https://zshot-cli.com/reference/flags/diagnostics/pprof-memory/)
      - [--pprof-memory-interval-bytes](https://zshot-cli.com/reference/flags/diagnostics/pprof-memory-interval-bytes/)
      - [--pprof-no-gzip](https://zshot-cli.com/reference/flags/diagnostics/pprof-no-gzip/)
      - [--trace](https://zshot-cli.com/reference/flags/diagnostics/trace/)
      - [--trace-captures-navigation](https://zshot-cli.com/reference/flags/diagnostics/trace-captures-navigation/)
      - [--trace-no-gzip](https://zshot-cli.com/reference/flags/diagnostics/trace-no-gzip/)
      - [--trace-no-screenshots](https://zshot-cli.com/reference/flags/diagnostics/trace-no-screenshots/)
    - [Document](https://zshot-cli.com/reference/flags/document/)
    - [Image](https://zshot-cli.com/reference/flags/image/)
    - [Navigator](https://zshot-cli.com/reference/flags/navigator/)
    - [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/)
  - [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

