---
title: app function run
description: >-
  Runs the function from your current directory for [testing
  purposes](/docs/apps/functions/testing-and-debugging). To learn how you can
  monitor and debug functions when errors occur, refer to [Shopify Functions
  error handling](/docs/api/functions/errors).
api_name: shopify-cli
source_url:
  html: 'https://shopify.dev/docs/api/shopify-cli/app/app-function-run'
  md: 'https://shopify.dev/docs/api/shopify-cli/app/app-function-run.md'
---

# app function run

Runs the function from your current directory for [testing purposes](https://shopify.dev/docs/apps/functions/testing-and-debugging). To learn how you can monitor and debug functions when errors occur, refer to [Shopify Functions error handling](https://shopify.dev/docs/api/functions/errors).

## Flags

The following flags are available for the `app function run` 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 function directory.

* **--reset**

  **env: SHOPIFY\_FLAG\_RESET**

  Reset all your settings.

* **--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.

* **-e, --export \<value>**

  **string**

  **env: SHOPIFY\_FLAG\_EXPORT**

  Name of the WebAssembly export to invoke.

* **-i, --input \<value>**

  **string**

  **env: SHOPIFY\_FLAG\_INPUT**

  The input JSON to pass to the function. If omitted, standard input is used.

* **-j, --json**

  **env: SHOPIFY\_FLAG\_JSON**

  Output the result as JSON.

Examples

### Examples

* #### app function run

  ##### app function run

  ```bash
  shopify app function run [flags]
  ```