> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jelou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Shop

> Manage Jelou Shop from the CLI: catalog, branches, categories, coupons, orders, imports, external catalog syncs, and metrics.

`jelou shop` manages your company's store: catalog, orders, coupons, and the app
configuration.

## Get started

```bash theme={null}
jelou shop info        # show the current Shop app
jelou shop activate    # enable Shop for the active company
jelou shop settings    # update the app settings
jelou shop usage       # plan usage and catalog totals
```

<Tip>
  `jelou shop usage` is the quick way to see how many products you have against
  your plan limit before a large import.
</Tip>

## Products

| Subcommand                    | Description                                                                           |
| ----------------------------- | ------------------------------------------------------------------------------------- |
| `products list`               | List and search catalog products                                                      |
| `products search`             | Discovery search (the one the storefront uses)                                        |
| `products show <id>`          | Product details                                                                       |
| `products upsert`             | Create or update depending on existence                                               |
| `products update`             | Bulk patch by id (`--file`) or a single product (`--id --status\|--patch`)            |
| `products status`             | Change the status of several products at once (`--ids p1,p2 --status true\|false`)    |
| `products delete`             | Bulk delete products (`--ids p1,p2`), with a confirmation prompt (`--yes` to skip it) |
| `products bulk`               | Bulk operations                                                                       |
| `products images add\|delete` | Manage the product's images (by SKU)                                                  |

```bash theme={null}
jelou shop products list --json
jelou shop products search "black t-shirt"
jelou shop products images add SKU-123 --file product.jpg --json

# Update products
jelou shop products update --file product-patch.json       # bulk patch by id
jelou shop products update --id prod_123 --status false    # a single product

# Change status or delete in bulk
jelou shop products status --ids p1,p2 --status false
jelou shop products delete --ids p1,p2 --yes
```

<Note>
  `products list` and `products search` are not the same: `list` walks your catalog
  as an administrator, `search` uses the storefront's discovery engine — what the
  end customer actually sees.
</Note>

## Branches and categories

```bash theme={null}
jelou shop branches list
jelou shop branches show <id>
jelou shop branches create --name "North Branch"
jelou shop branches update <id> --name "Downtown Branch"
jelou shop branches delete <id>

jelou shop categories list
jelou shop categories create --name "Shoes"
jelou shop categories update <id> --name "Footwear"
jelou shop categories delete <id>
```

## Coupons

| Subcommand            | Description                              |
| --------------------- | ---------------------------------------- |
| `coupons list`        | List coupons                             |
| `coupons show <code>` | Coupon details, by code                  |
| `coupons create`      | Create a coupon                          |
| `coupons update <id>` | Update a coupon                          |
| `coupons delete <id>` | Delete a coupon                          |
| `coupons uses <code>` | The coupon's redemption history, by code |

```bash theme={null}
jelou shop coupons list --json
jelou shop coupons show WELCOME10 --json
jelou shop coupons uses WELCOME10 --json
```

## Orders

```bash theme={null}
jelou shop orders list
jelou shop orders show ord_01h2xcejq
```

## Imports

Bulk product upload from an XLSX file:

```bash theme={null}
jelou shop imports template                                          # download the XLSX template
jelou shop imports upload --file products.xlsx --uploaded-by alex --json
jelou shop imports show imp_01h2xcejq --json                         # status of one import
```

<Warning>
  Check `jelou shop usage` before a large import: if the file exceeds your plan's
  product limit, the upload fails partway through.
</Warning>

## External catalogs

When you connect an external catalog (for example Shopify from the
[marketplace](/en/guides/cli/marketplace)), these commands show the connected
accounts and the sync history:

```bash theme={null}
jelou shop accounts              # connected catalog accounts
jelou shop syncs <accountId>     # sync runs for that account
```

Use them to answer "why isn't this product showing in the store?": check whether
the account's last sync ran, and with what result.

## Activity

```bash theme={null}
jelou shop activity list --json
```

Lists the store's activity log, grouped by entity (`app`, `product`,
`product_variation`, `branch`, `category`, `coupon`). Useful for auditing what
changed and when.

## Metrics

```bash theme={null}
jelou shop metrics overview     # composite summary: sales, search, catalog, and customers
jelou shop metrics sales        # sales over completed carts, AOV, conversion
jelou shop metrics search       # total searches, zero-result rate, top queries
jelou shop metrics catalog      # inventory snapshot: active products, out of stock, variations
jelou shop metrics customers    # new vs. returning customers, top spenders
```

Company-scoped store analytics: sales, search, catalog, and customers.