Back to Next Js

`next/image` Un-configured Host

errors/next-image-unconfigured-host.mdx

16.2.81.4 KB
Original Source

Why This Error Occurred

One of your pages that leverages the next/image component, passed a src value that uses a hostname in the URL that isn't defined in the images.remotePatterns in next.config.js.

Possible Ways to Fix It

Add the protocol, hostname, port, and pathname to the images.remotePatterns config in next.config.js:

js
module.exports = {
  images: {
    remotePatterns: [new URL('https://assets.example.com/account123/**')],
  },
}

Fixing older versions of Next.js

<details> <summary>Using Next.js prior to 15.3.0?</summary>

Older versions of Next.js can configure images.remotePatterns using the object:

js
module.exports = {
  images: {
    remotePatterns: [
      {
        protocol: 'https',
        hostname: 'assets.example.com',
        port: '',
        pathname: '/account123/**',
        search: '',
      },
    ],
  },
}
</details> <details> <summary>Using Next.js prior to 12.3.0?</summary>

Older versions of Next.js can configure images.domains instead:

js
module.exports = {
  images: {
    domains: ['assets.example.com'],
  },
}
</details>