---
title: app logs
description: Opens a real-time stream of detailed app logs from the selected app and store.
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'
api_name: shopify-cli
---

# app logs

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=extensions.discount-function`

#### Flags

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

* **--auth-alias \<value>**

  **string**

  **env: SHOPIFY\_FLAG\_AUTH\_ALIAS**

  Alias of the Shopify account to use for authentication.

* **--client-id \<value>**

  **string**

  **env: SHOPIFY\_FLAG\_CLIENT\_ID**

  The Client ID of your app.

* **--json-schema**

  **env: SHOPIFY\_FLAG\_JSON\_SCHEMA**

  Print the command's JSON schemas.

* **--no-color**

  **env: SHOPIFY\_FLAG\_NO\_COLOR**

  Disable color output.

* **--no-input**

  **env: SHOPIFY\_FLAG\_NO\_INPUT**

  Disable interactive prompts and browser authentication.

* **--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. May include sensitive data.

* **-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. Automatically disables color output.

* **-s, --store \<value>**

  **string**

  **env: SHOPIFY\_FLAG\_STORE**

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

Examples

### Examples

* ####

  ##### app logs

  ```sh
  shopify app logs [flags]
  ```

***