gatsbyjs/gatsby · error

Missing allowed URLs in your Netlify configuration. Add foll

Error message

Missing allowed URLs in your Netlify configuration. Add following entries to your existing `images.remote_images` configuration in netlify.toml:
```toml
${entriesToAddToToml}
```

What it means

Error "Missing allowed URLs in your Netlify configuration. Add following entries to your existing `images.remote_images` configuration in netlify.toml: ```toml ${entriesToAddToToml} ```" thrown in gatsbyjs/gatsby.

Source

Thrown at packages/gatsby-adapter-netlify/src/allowed-remote-urls.ts:46

      if (!isAlreadyAllowed) {
        missingAllowedUrlsInNetlifyToml.push(remoteFileAllowedUrl.regexSource)
      }
    }

    if (missingAllowedUrlsInNetlifyToml.length > 0) {
      const entriesToAddToToml = `${missingAllowedUrlsInNetlifyToml
        .map(
          missingAllowedUrlInNetlifyToml =>
            `  ${JSON.stringify(missingAllowedUrlInNetlifyToml)}`
        )
        .join(`,\n`)},\n`

      if (typeof cfg.config.images?.remote_images === `undefined`) {
        reporter.warn(
          `Missing allowed URLs in your Netlify configuration. Add following to your netlify.toml:\n\`\`\`toml\n[images]\nremote_images = [\n${entriesToAddToToml}]\n\`\`\``
        )
      } else {
        reporter.warn(
          `Missing allowed URLs in your Netlify configuration. Add following entries to your existing \`images.remote_images\` configuration in netlify.toml:\n\`\`\`toml\n${entriesToAddToToml}\`\`\``
        )
      }
    }
  } else {
    reporter.verbose(`[gatsby-adapter-netlify] no netlify.toml found`)
  }
}

View on GitHub (pinned to e85d62f177)

Solutions

1. Append the listed entries to the existing images.remote_images array in netlify.toml

When it happens

Trigger: Thrown at packages/gatsby-adapter-netlify/src/allowed-remote-urls.ts:46 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/fa0050f40e03947a. Report an issue: GitHub.