# Global flags

> The flags available on every Shoplazza CLI command — --format, --jq, --fields, --dry-run, and --help — with their defaults and worked examples.

These flags are available on all Shoplazza CLI commands.

| Flag | Type | Default | Description |
|------|------|---------|-------------|
| `--format <format>` | string | `json` | Output format: `json`, `pretty`, or `table` |
| `--jq <expression>` | string | — | Filter JSON output using a jq expression |
| `-q <expression>` | string | — | Shorthand alias for `--jq` |
| `--dry-run` | boolean | `false` | Preview the HTTP request without executing it |
| `--fields <fields>` | string | — | Comma-separated fields for output projection (shortcuts only) |
| `--help` / `-h` | boolean | — | Show help for the command |

## Examples

```shell
# Table output
shoplazza products list --format table

# Pretty print
shoplazza orders +search --format pretty

# Filter with jq
shoplazza products list --jq '.data.products[] | {id, title, price}'

# Dry run
shoplazza products create --data '{"product": {"title": "Test"}}' --dry-run

# Field projection (shortcuts)
shoplazza orders +search --fields "id,status,total_price" --format table
```