Some checks failed
Test examples / Test Examples (20) (push) Has been cancelled
Test examples / Test Examples (22) (push) Has been cancelled
Lock Threads / action (push) Has been cancelled
Trigger Release / start (push) Has been cancelled
Stale issue handler / stale (push) Has been cancelled
Update Font Data / create-pull-request (push) Has been cancelled
build-and-deploy / deploy-target (push) Has been cancelled
build-and-deploy / build (push) Has been cancelled
build-and-deploy / stable - aarch64-unknown-linux-musl - node@16 (push) Has been cancelled
build-and-deploy / stable - x86_64-unknown-linux-musl - node@16 (push) Has been cancelled
build-and-deploy / stable - aarch64-unknown-linux-gnu - node@16 (push) Has been cancelled
build-and-deploy / stable - x86_64-unknown-linux-gnu - node@16 (push) Has been cancelled
build-and-deploy / stable - aarch64-pc-windows-msvc - node@16 (push) Has been cancelled
build-and-deploy / stable - x86_64-pc-windows-msvc - node@16 (push) Has been cancelled
build-and-deploy / stable - aarch64-apple-darwin - node@16 (push) Has been cancelled
build-and-deploy / stable - x86_64-apple-darwin - node@16 (push) Has been cancelled
build-and-deploy / build-wasm (nodejs) (push) Has been cancelled
build-and-deploy / build-wasm (web) (push) Has been cancelled
build-and-deploy / Deploy preview tarball (push) Has been cancelled
build-and-deploy / Potentially publish release (push) Has been cancelled
build-and-deploy / publish-turbopack-npm-packages (push) Has been cancelled
build-and-deploy / Deploy examples (push) Has been cancelled
build-and-deploy / thank you, build (push) Has been cancelled
build-and-deploy / Upload Turbopack Bytesize metrics to Datadog (push) Has been cancelled
Rspack Next.js development integration tests / Rspack integration tests (push) Has been cancelled
Rspack Next.js production integration tests / Rspack integration tests (push) Has been cancelled
Turbopack Next.js development integration tests / Next.js integration tests (push) Has been cancelled
Turbopack Next.js production integration tests / Next.js integration tests (push) Has been cancelled
Update Rspack test manifest / Update and upload Rspack development test manifest (push) Has been cancelled
Update Rspack test manifest / Update and upload Rspack production test manifest (push) Has been cancelled
Upload bundler test manifests to areweturboyet.com / Upload test results (push) Has been cancelled
Update React / create-pull-request (push) Has been cancelled
test-e2e-project-reset-cron / reset-test-project (push) Has been cancelled
Notify about the top 15 issues/PRs/feature requests (most reacted) in the last 90 days / run (push) Has been cancelled
88 lines
2.7 KiB
Plaintext
88 lines
2.7 KiB
Plaintext
---
|
|
title: No img element
|
|
---
|
|
|
|
> Prevent usage of `<img>` element due to slower LCP and higher bandwidth.
|
|
|
|
## Why This Error Occurred
|
|
|
|
An `<img>` element was used to display an image instead of `<Image />` from `next/image`.
|
|
|
|
## Possible Ways to Fix It
|
|
|
|
1. Use [`next/image`](/docs/pages/api-reference/components/image) to improve performance with automatic [Image Optimization](/docs/pages/api-reference/components/image).
|
|
|
|
> **Note**: If deploying to a [managed hosting provider](/docs/pages/getting-started/deploying), remember to check provider pricing since optimized images might be charged differently than the original images.
|
|
>
|
|
> Common image optimization platform pricing:
|
|
>
|
|
> - [Vercel pricing](https://vercel.com/pricing)
|
|
> - [Cloudinary pricing](https://cloudinary.com/pricing)
|
|
> - [imgix pricing](https://imgix.com/pricing)
|
|
|
|
> **Note**: If self-hosting, remember to install [`sharp`](https://www.npmjs.com/package/sharp) and check if your server has enough storage to cache the optimized images.
|
|
|
|
```jsx filename="pages/index.js"
|
|
import Image from 'next/image'
|
|
|
|
function Home() {
|
|
return (
|
|
<Image
|
|
src="https://example.com/hero.jpg"
|
|
alt="Landscape picture"
|
|
width={800}
|
|
height={500}
|
|
/>
|
|
)
|
|
}
|
|
|
|
export default Home
|
|
```
|
|
|
|
2. If you would like to use `next/image` features such as blur-up placeholders but disable Image Optimization, you can do so using [unoptimized](/docs/pages/api-reference/components/image#unoptimized):
|
|
|
|
```jsx filename="pages/index.js"
|
|
import Image from 'next/image'
|
|
|
|
const UnoptimizedImage = (props) => {
|
|
return <Image {...props} unoptimized />
|
|
}
|
|
```
|
|
|
|
3. You can also use the `<picture>` element with the nested `<img>` element:
|
|
|
|
```jsx filename="pages/index.js"
|
|
function Home() {
|
|
return (
|
|
<picture>
|
|
<source srcSet="https://example.com/hero.avif" type="image/avif" />
|
|
<source srcSet="https://example.com/hero.webp" type="image/webp" />
|
|
<img
|
|
src="https://example.com/hero.jpg"
|
|
alt="Landscape picture"
|
|
width={800}
|
|
height={500}
|
|
/>
|
|
</picture>
|
|
)
|
|
}
|
|
```
|
|
|
|
4. You can use a [custom image loader](/docs/pages/api-reference/components/image#loader) to optimize images. Set [loaderFile](/docs/pages/api-reference/components/image#loaderfile) to the path of your custom loader.
|
|
|
|
```js filename="next.config.js"
|
|
module.exports = {
|
|
images: {
|
|
loader: 'custom',
|
|
loaderFile: './my/image/loader.js',
|
|
},
|
|
}
|
|
```
|
|
|
|
## Useful Links
|
|
|
|
- [Image Component and Image Optimization](/docs/pages/api-reference/components/image)
|
|
- [next/image API Reference](/docs/pages/api-reference/components/image)
|
|
- [Largest Contentful Paint (LCP)](/learn/seo/web-performance/lcp)
|
|
- [Next.js config loaderFile option](/docs/pages/api-reference/components/image#loaderfile)
|