gatsbyjs/gatsby · error

React Profiling is enabled. This can have a performance impa

Error message

React Profiling is enabled. This can have a performance impact. See https://www.gatsbyjs.com/docs/profiling-site-performance-with-react-profiler/#performance-impact

What it means

Build-time notice in the build command when --profile (React Profiler) is passed. Profiling instruments React renders, which slows the build and the site, so Gatsby warns up front and links to docs describing the performance impact.

Source

Thrown at packages/gatsby/src/commands/build.ts:90

module.exports = async function build(
  program: IBuildArgs,
  // Let external systems running Gatsby to inject attributes
  externalTelemetryAttributes: Record<string, any>
): Promise<void> {
  // global gatsby object to use without store
  global.__GATSBY = {
    buildId: uuid.v4(),
    // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
    root: program!.directory,
  }

  if (isTruthy(process.env.VERBOSE)) {
    program.verbose = true
  }
  report.setVerbose(program.verbose)

  if (program.profile) {
    report.warn(
      `React Profiling is enabled. This can have a performance impact. See https://www.gatsbyjs.com/docs/profiling-site-performance-with-react-profiler/#performance-impact`
    )
  }

  report.verbose(`Running build in "${process.env.NODE_ENV}" environment`)

  await updateInternalSiteMetadata({
    name: program.sitePackageJson.name,
    sitePath: program.directory,
    lastRun: Date.now(),
    pid: process.pid,
  })

  markWebpackStatusAsPending()

  const publicDir = path.join(program.directory, `public`)
  if (!externalTelemetryAttributes) {
    await initTracer(

View on GitHub (pinned to e85d62f177)

Solutions

1. Only pass --profile when actually diagnosing render performance
2. Remove --profile from production build scripts/CI
3. Profile locally against representative data instead of in deployed builds

When it happens

Trigger: Thrown at packages/gatsby/src/commands/build.ts:90 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of gatsbyjs/gatsby@e85d62f177 (2026-08-26). Data as JSON: /api/errors/f46940a2ad727afc. Report an issue: GitHub.