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:

• Merchants 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 banner displays in the customization page of the Shopify admin. The banner contains information about when errors started occurring. It also includes a link that merchants can use to share information with developers about failed function runs.

After a merchant has shared an error report, the developer receives an email notification.

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

When the merchant 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 banner displays on the relevant page in the Shopify admin. For example, if you've executed a discount function, then the banner displays on the Discounts page.

The banner contains information about when errors started occurring. It also includes a link that merchants can use 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 error banner.
3. Click Share the error reports with <developer-name>.
4. Select whether the error report includes the last ten times the customization ran on checkout.
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 merchant 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: