---
title: Error console
description: Learn how to use the error console to debug server errors on Oxygen.
source_url:
  html: >-
    https://shopify.dev/docs/storefronts/headless/legacy/hydrogen/debugging/error-console
  md: >-
    https://shopify.dev/docs/storefronts/headless/legacy/hydrogen/debugging/error-console.md
api_name: hydrogen
---

Legacy Hydrogen

These pages refer to Hydrogen versions 2026-04 and earlier. For versions 2026-10 and later, refer to the latest [Hydrogen docs](https://shopify.dev/docs/storefronts/hydrogen). If you're not using the latest version of Hydrogen, then we recommend that you migrate your storefront. To learn more, refer to [Migrate to the latest version of Hydrogen](https://shopify.dev/docs/storefronts/hydrogen/migrate).

# Error console

The error console helps you debug server errors in Hydrogen code deployed to Oxygen.

![Screenshot of the error console in Oxygen](https://shopify.dev/assets/assets/images/custom-storefronts/hydrogen/error-console-FtDEBZXp.png)

***

## Accessing the error console

The error console is available to apps [deployed to Oxygen](https://shopify.dev/docs/storefronts/headless/legacy/hydrogen/deployments). To open the error console for a deployment, click on any error in the runtime log on its deployment detail page. The error console highlights the line that caused a server error and allows you to explore the complete source code of the deployed worker bundle.

The error console and stack trace within it require a [source map](https://developer.chrome.com/blog/sourcemaps) file to be generated along with your worker bundle. The Hydrogen CLI generates the source map file by default when you run the [`build`](https://shopify.dev/docs/api/shopify-cli/hydrogen/hydrogen-build) command.

***

## Raw stack traces

Prettified source maps can occasionally be inaccurate. If the formatted stack trace doesn't work, then you can inspect the raw stack trace for more detail about the error. To view a raw stack trace, do the following:

1. On the deployment detail page, click the error you want to inspect.
2. In the **Stack trace** panel, click **Raw traces**.

Download the worker bundle and use the raw stack trace to dig deeper into the problem.

***

## Disabling source maps

You can disable source maps by passing the `--no-sourcemap` flag when running the [`build`](https://shopify.dev/docs/api/shopify-cli/hydrogen/hydrogen-build) command. Doing so means you won't have access to the error console or stack traces in your runtime logs.

## Terminal

```sh
npx shopify hydrogen build --no-sourcemap
```

***