---
title: app logs
description: "

  \  Opens a real-time stream of detailed app logs from the selected app and store.

  \  Use the `--source` argument to limit output to a particular log source, such as a specific Shopify Function handle. Use the `shopify app logs sources` command to view a list of sources.

  \  Use the `--status` argument to filter on status, either `success` or `failure`.

  \  ```

  \  shopify app logs --status=success --source=extension.discount-function

  \  ```

  \  "
api_name: shopify-cli
source_url:
  html: https://shopify.dev/docs/api/shopify-cli/app/app-logs
  md: https://shopify.dev/docs/api/shopify-cli/app/app-logs.md
---

# app logscommand

Opens a real-time stream of detailed app logs from the selected app and store. Use the `--source` argument to limit output to a particular log source, such as a specific Shopify Function handle. Use the `shopify app logs sources` command to view a list of sources. Use the `--status` argument to filter on status, either `success` or `failure`.

```
shopify app logs --status=success --source=extension.discount-function
```

## Flags

The following flags are available for the `app logs` command:

* \--client-id \<value>

  string

  env: SHOPIFY\_FLAG\_CLIENT\_ID

  The Client ID of your app.

* \--no-color

  env: SHOPIFY\_FLAG\_NO\_COLOR

  Disable color output.

* \--path \<value>

  string

  env: SHOPIFY\_FLAG\_PATH

  The path to your app directory.

* \--reset

  env: SHOPIFY\_FLAG\_RESET

  Reset all your settings.

* \--source \<value>

  string

  env: SHOPIFY\_FLAG\_SOURCE

  Filters output to the specified log source.

* \--status \<value>

  string

  env: SHOPIFY\_FLAG\_STATUS

  Filters output to the specified status (success or failure).

* \--verbose

  env: SHOPIFY\_FLAG\_VERBOSE

  Increase the verbosity of the output.

* -c, --config \<value>

  string

  env: SHOPIFY\_FLAG\_APP\_CONFIG

  The name of the app configuration.

* -j, --json

  env: SHOPIFY\_FLAG\_JSON

  Output the result as JSON.

* -s, --store \<value>

  string

  env: SHOPIFY\_FLAG\_STORE

  Store URL. Must be an existing development or Shopify Plus sandbox store.

### Examples

* #### app logs

  ##### app logs

  ```bash
  shopify app logs [flags]
  ```