> ## Documentation Index
> Fetch the complete documentation index at: https://react.email/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Image

> Display an image in your email.

## Install

Install component from your command line.

```sh npm theme={"theme":{"light":"github-light","dark":"vesper"}}
npm install react-email -E
```

```sh yarn theme={"theme":{"light":"github-light","dark":"vesper"}}
yarn add react-email -E
```

```sh pnpm theme={"theme":{"light":"github-light","dark":"vesper"}}
pnpm add react-email -E
```

## Getting started

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

```jsx theme={"theme":{"light":"github-light","dark":"vesper"}}
import { Img } from "react-email";

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

> [!TIP]
>
> All email clients can display `.png`, `.gif`, and `.jpg` images.
> Unfortunately, `.svg` images are not well supported, regardless of how they're
> referenced, so avoid using these. See [Can I
> Email](https://www.caniemail.com/features/image-svg/) for more information.

## Props

**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

All components were tested using the most popular email clients.

![Gmail](https://react.email/static/icons/gmail.svg)

Gmail

![Apple Mail](https://react.email/static/icons/apple-mail.svg)

Apple Mail

![Outlook](https://react.email/static/icons/outlook.svg)

Outlook

![Yahoo! Mail](https://react.email/static/icons/yahoo-mail.svg)

Yahoo! Mail

![HEY](https://react.email/static/icons/hey.svg)

HEY

![Superhuman](https://react.email/static/icons/superhuman.svg)

Superhuman


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.