# @react-email/img

> Display an image in your email

Latest version **0.0.12** (published 2025-12-29) · MIT license · 0 weekly downloads

> **Deprecated.** This package is deprecated.

## Install

```sh
npm install @react-email/img
pnpm add @react-email/img
yarn add @react-email/img
bun add @react-email/img
```

## Health

**Score 10/100 (F)** — status: deprecated.

Negative: deprecated.

## Facts

| | |
|---|---|
| Version | 0.0.12 |
| Published | 2025-12-29 |
| First published | 2022-09-22 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Node | >=20.0.0 |
| Dependencies | 0 |
| Unpacked size | 9.4 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 19732 |
| Maintainers | zenorocha, bukinoshita, gabrielmfern |
| Keywords | react, email |

## Links

- npm: https://www.npmjs.com/package/@react-email/img
- Repository: https://github.com/resend/react-email
- Homepage: https://github.com/resend/react-email#readme
- Issues: https://github.com/resend/react-email/issues
- npm.io page: https://npm.io/package/@react-email/img

## Alternatives

- [@expo/fingerprint](https://npm.io/package/@expo/fingerprint.md) — 6.2M weekly downloads
- [@azure/monitor-opentelemetry-exporter](https://npm.io/package/@azure/monitor-opentelemetry-exporter.md) — 850.0K weekly downloads
- [@azure/monitor-opentelemetry](https://npm.io/package/@azure/monitor-opentelemetry.md) — 624.0K weekly downloads
- [@posthog/ai](https://npm.io/package/@posthog/ai.md) — 423.3K weekly downloads
- [fakefilter](https://npm.io/package/fakefilter.md) — 63.9K weekly downloads

## Recent versions

- 0.0.12 (latest) — 2025-12-29
- 0.0.12-tailwindv4.0 (tailwindv4) — 2025-10-01
- 0.0.11-canary.1 (canary) — 2024-12-03
- 0.0.11 — 2024-12-03
- 0.0.11-canary.0 — 2024-11-08
- 0.0.10 — 2024-08-22
- 0.0.10-canary.0 — 2024-07-23
- 0.0.9 — 2024-07-23
- 0.0.9-canary.1 — 2024-07-15
- 0.0.9-canary.0 — 2024-07-03
- 0.0.8 — 2024-04-29
- 0.0.7 — 2023-12-01
- 0.0.6 — 2023-10-27
- 0.0.5 — 2023-03-21
- 0.0.4 — 2023-01-27
- … 3 more at https://npm.io/package/@react-email/img/versions

## README

![React Email img cover](https://react.email/static/covers/img.png)

<div align="center"><strong>@react-email/img</strong></div>
<div align="center">Display an image in your email.</div>
<br />
<div align="center">
<a href="https://react.email">Website</a>
<span> · </span>
<a href="https://github.com/resend/react-email">GitHub</a>

</div>

## Install

Install component from your command line.

#### With yarn

```sh
yarn add @react-email/img -E
```

#### With npm

```sh
npm install @react-email/img -E
```

## Getting started

Add the component to your email template. Include styles where needed.

```jsx
import { Img } from "@react-email/img";

const Email = () => {
  return <Img src="cat.jpg" alt="Cat" width="300" height="300" />;
};
```

## Props

| Name   | Type   | Default | Description                        |
| ------ | ------ | ------- | ---------------------------------- |
| alt    | string |         | Alternate description for an image |
| src    | string |         | The path to the image              |
| width  | string |         | The width of an image in pixels    |
| height | string |         | The height of an image in pixels   |

## Support

This component was tested using the most popular email clients.

| <img src="https://react.email/static/icons/gmail.svg" width="48px" height="48px" alt="Gmail logo"> | <img src="https://react.email/static/icons/apple-mail.svg" width="48px" height="48px" alt="Apple Mail"> | <img src="https://react.email/static/icons/outlook.svg" width="48px" height="48px" alt="Outlook logo"> | <img src="https://react.email/static/icons/yahoo-mail.svg" width="48px" height="48px" alt="Yahoo! Mail logo"> | <img src="https://react.email/static/icons/hey.svg" width="48px" height="48px" alt="HEY logo"> | <img src="https://react.email/static/icons/superhuman.svg" width="48px" height="48px" alt="Superhuman logo"> |
| -------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ |
| Gmail ✔                                                                                           | Apple Mail ✔                                                                                           | Outlook ✔                                                                                             | Yahoo! Mail ✔                                                                                                | HEY ✔                                                                                         | Superhuman ✔                                                                                                |

## License

MIT License

---
_Source: https://npm.io/package/@react-email/img · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._