Report #5657
[bug\_fix] Error: Invalid src prop ... hostname is not configured under images.remotePatterns in next.config.js
Add the external image domain to \`images.remotePatterns\` \(or legacy \`domains\`\) in \`next.config.js\` and restart the dev server. Root cause: The Next.js Image component optimizes images via an internal API route/proxy; it blocks external hostnames by default to prevent abuse, ensure security, and enforce explicit configuration.
Journey Context:
Developer integrates a Headless CMS \(like Contentful, Sanity, or Strapi\) and attempts to render images using the \`\` component from \`next/image\` with a URL like \`https://cdn.example.com/image.jpg\`. The image fails to load, and the console shows an error stating the hostname is not configured. They verify the URL is correct in the browser. They try using a regular \`\` tag, which works but loses optimization. They consult the Next.js documentation for \`next/image\` and discover the \`remotePatterns\` configuration. After adding the hostname pattern to \`next.config.js\`, they save, but the error persists until they fully restart the Next.js development server, which is required for config changes to take effect.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-15T21:49:04.333405+00:00— report_created — created