# Shortcuts

> Shoplazza CLI shortcut commands carry smart defaults for high-frequency work: which ones each topic offers, the flags they share, and worked examples.

Shortcuts are high-frequency commands prefixed with `+`, designed for both human developers and AI agents. They provide smart defaults and streamlined workflows.

## Syntax

```
shoplazza <topic> +<action> [flags]
```

## Available shortcuts

### Products (7 shortcuts)

| Command | Description |
|---------|-------------|
| `products +search` | Search products by keyword |
| `products +count` | Count products |
| `products +create` | Create a product |
| `products +set-price` | Update product pricing |
| `products +stock` | Update inventory |
| `products +publish` | Publish to online store |
| `products +unpublish` | Remove from online store |

### Orders (5 shortcuts)

| Command | Description |
|---------|-------------|
| `orders +search` | Search orders |
| `orders +count` | Count orders |
| `orders +ship` | Create fulfillment |
| `orders +refund` | Create refund |
| `orders +update-tracking` | Update tracking info |

### Discounts (8 shortcuts)

| Command | Description |
|---------|-------------|
| `discounts +search` | Search discounts |
| `discounts +rebate` | Create automatic rebate |
| `discounts +flashsale` | Create flash sale |
| `discounts +mn-discount` | Create M-N discount |
| `discounts +percent-code` | Create percentage code |
| `discounts +amount-code` | Create fixed amount code |
| `discounts +bxgy-code` | Create buy-X-get-Y code |
| `discounts +free-shipping-code` | Create free shipping code |

### Customers (2 shortcuts)

| Command | Description |
|---------|-------------|
| `customers +search` | Search customers |
| `customers +create` | Create a customer |

### Shop (1 shortcut)

| Command | Description |
|---------|-------------|
| `shop +upload-file` | Upload a file |

### Themes (6 shortcuts)

| Command | Description |
|---------|-------------|
| `themes init` | Scaffold new theme |
| `themes serve` | Preview with live reload |
| `themes pull` | Download from store |
| `themes push` | Upload to store |
| `themes package` | Package as ZIP |
| `themes share` | Share preview link |

## Common flags

All shortcuts support these flags:

| Flag | Description |
|------|-------------|
| `--format <json\|pretty\|table>` | Output format |
| `--fields <f1,f2>` | Project specific fields in output |
| `--jq <expr>` | Filter JSON output |

## Examples

```shell
# Search with table output
shoplazza products +search --keyword "dress" --format table

# Search with field projection
shoplazza orders +search --fields "id,status,total_price" --format table

# Create and filter output
shoplazza customers +create --jq '.data.id'
```