Shopify Functions error handling

Functions can fail by raising an exception, exceeding memory or time limits, or returning data that doesn't match the schema of the specific Function API.

The following diagram shows the activities that happen when monitoring functions:

• App users receive error notifications and share error reports with developers.
• App developers monitor functions in their Partner Dashboard.

When a function is executed and an error occurs, a warning notification is displayed in the customization page of the Shopify admin. The warning notification contains information about when errors started occurring. It also includes a link that enables store admin users to share information about function runs with the developer.

After an app user has shared an error report, the developer receives an email notification.

If you're working in a development store, then all details for failed and successful function runs are visible by default. You don't need to share the error report for the run details to display in the Partner Dashboard.

When the user shares an error report from the Shopify admin, you can access it from the app's Extensions section in your Partner Dashboard.

When a function is executed and an error occurs, a warning notification is displayed on the relevant page in the Shopify admin. For example, if you've executed a discount function, then the warning notification appears on the Discounts page.

The warning notification contains information about when errors started occurring. It also includes a link that enables users to share information with developers about function runs that failed.

1. From your Shopify admin, navigate to the page associated with your executed function.
2. Click the warning notification.
3. Click Share the error reports with <developer-name>.
4. Choose whether to include every time the customization ran within the last 24 hours.
5. Click Share.

You'll receive an email notification.

1. From your Partner Dashboard, go to Apps.
2. Click the app that you deployed your function to.
3. Click Extensions.
4. Click the name of your function.

5. In the Total errors box, click Error runs.

   All of the function runs that failed display in a list.

6. From the list, click the failed function run that you shared.

You can view the error report.

You can debug errors from the app's Extensions section in your Partner Dashboard. After the app user has consented to send the execution logs, you can inspect the details of each individual error.

1. Input (STDIN): The JSON formatted input that you can copy to your clipboard. For illustrative purposes, the input in the screenshot has been omitted.
2. Output (STDOUT): Contains the output, if the function returned output
3. Logs (STDERR): Contains the STDERR logs of the function

4. Error message: Contains the final message sent to STDERR before the function failed

The following table provides a complete list of errors that can occur when running your function: