> To build a Wix site agentically, or add Wix features like bookings or a store to a site you already have, follow https://www.wix.com/headless/skill.md
> 
> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - If a reference page seems to be missing its schema (parameters, return types, or type definitions), append `?schema=true` to its `.md` URL (e.g. `https://dev.wix.com/docs/contexts/contexts/stores/category-info/use-category-info-context.md?schema=true`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

## Resource: Image Component

## Article: Image Component

## Article Link: https://dev.wix.com/docs/wix-design-system/components/media/image-component.md

## Article Content:

# Image

_Components/Media_

Interactive docs page: <https://wix-pages.com/design-system-documentation/#/component/image>

## Overview

```jsx
<Box align="center">
  <Image src="TravelExample6.jpg" width="30%" />
</Box>;
```

Images communicate product information to users with visuals.

### Do

- Use them to display images like product thumbnails.

### Don't

- Don't display photos of users. Use `<Avatar/>` instead.
- Don't display images that can be uploaded, updated or removed. Use a built-in `<ImageViewer/>` solution instead.

### Feature examples

#### Dimensions

Specify image dimensions in pixels or percentage with `width` and `height` props.

```jsx
<Image width="33%" height="180px" />;
```

#### Border

To separate images from backgrounds, enable the image border`showBorder`.

```jsx
<StorybookComponents.Stack width="25%">
  <Image showBorder />
</StorybookComponents.Stack>;
```

#### Border radius

Control the rounded corners of the image box with the `borderRadius` prop. Radius levels can be specified for every corner.

```jsx
<StorybookComponents.Stack>
  <Image />
  <Image borderRadius={'24px'} />
  <Image borderRadius={'36px 0px 0px 36px'} />
</StorybookComponents.Stack>;
```

#### States

Use the `src` prop to display a link to a media file. If the `src` prop is added without a link, the default placeholder shows.

```jsx
<StorybookComponents.Stack>
  <Image />
  <Image src="example.jpg" />
</StorybookComponents.Stack>;
```

#### Background fill

To remove the background color for PNG images or vector graphics, use the `transparent` prop.

```jsx
<StorybookComponents.Stack>
  <Image fit="contain" height="240" src="example.jpg" />
  <Image fit="contain" height="240" src="example.jpg" transparent />
  <Image fit="contain" src="PromotionalPromoteMarketingHomeEmail.svg" />
  <Image
    fit="contain"
    src="PromotionalPromoteMarketingHomeEmail.svg"
    transparent
  />
</StorybookComponents.Stack>;
```

#### Fit mode

Control how images are displayed when their dimensions don't match the size of their containers with the `fit` prop. It supports all default [object-fit](https://developer.mozilla.org/en-US/docs/Web/CSS/object-fit) values, but there are four that are most commonly used:

- `contain` maintains the aspect ratio while fitting images within containers.
- `cover` maintains the aspect ratio and clips images to fill containers.
- `none` loads the original image size and positions it in the center of the container.
- `tile` repeats images when their dimensions are smaller than the containers.

```jsx
<StorybookComponents.Stack>
  <Image fit="contain" height="300" src="example.jpg" />
  <Image fit="cover" height="300" src="example.jpg" />
  <Image fit="none" height="300" src="example.jpg" />
</StorybookComponents.Stack>;
```

#### Position

Control image placement inside of a bounding box with the `position` property. Specify the starting position of the image from where its fit will be defined.

```jsx
<StorybookComponents.Stack>
  <Image src="example.jpg" fit="none" position="top" />
  <Image src="example.jpg" fit="none" position="center left" />
  <Image src="example.jpg" fit="none" position="bottom right" />
</StorybookComponents.Stack>;
```

### Common use case examples

#### Mixed border radius

Use images with mixed corner radius levels in cases when they touch the edges of cards.

```jsx
() => {
  const renderImage = () => (
    <Image
      src="TravelExample7.jpg"
      borderRadius="15px 0px 0px 15px"
      height="200px"
      width="230px"
    />
  );

  const renderContent = () => (
    <Box
      direction="vertical"
      verticalAlign="space-between"
      padding="24px 29px 27px"
      backgroundColor="D80"
      flexGrow={1}
    >
      <Box direction="vertical">
        <Text weight="bold">Sunset</Text>
        <Text size="tiny" weight="thin" secondary>
          Jul 15, 2021 7:30pm, Cypher City
        </Text>
      </Box>
      <Box align="right" verticalAlign="middle" minWidth={115} gap="12px">
        <IconButton priority="secondary" size="small">
          <Icons.More />
        </IconButton>
        <Button priority="secondary" size="small">
          Edit
        </Button>
      </Box>
    </Box>
  );

  return (
    <Box minHeight={200}>
      {renderImage()}
      {renderContent()}
    </Box>
  );
};
```

#### Product list

Use images to display product thumbnails in lists and widgets.

```jsx
() => {
  const records = [
    {
      name: 'Hoodie',
      sku: 25232564,
      inStock: true,
      price: '$14.00',
      image: <Image src="ProductExample1.jpg" />,
    },
    {
      name: 'Watch',
      sku: 35246432,
      inStock: true,
      price: '$29.00',
      image: <Image src="ProductExample2.jpg" />,
    },
    {
      name: 'Glasses',
      sku: 4864310,
      inStock: false,
      price: '$69.00',
      image: <Image src="ProductExample3.jpg" />,
    },
    {
      name: 'Leather shoes',
      sku: 125156422,
      inStock: true,
      price: '$7.00',
      image: <Image src="ProductExample4.jpg" />,
    },
  ];

  const Status = ({ isInStock }) => (
    <Text size="small" secondary>
      {isInStock ? 'In Stock' : 'Out Of Stock'}
    </Text>
  );

  const secondaryAction = [
    {
      icon: <Icons.Duplicate />,
      text: 'Duplicate',
      onClick: () => {},
    },
    {
      icon: <Icons.Delete />,
      text: 'Delete',
      onClick: () => {},
    },
  ];

  const columns = [
    {
      title: '',
      render: (row) => row.image,
      width: '60px',
    },
    {
      title: 'Name',
      render: (row) => row.name,
      width: '30%',
    },
    {
      title: 'SKU',
      render: (row) => row.sku,
      width: '20%',
    },
    {
      title: 'Stock',
      render: (row) => <Status isInStock={row.inStock} />,
      width: '20%',
    },
    {
      title: 'Price',
      render: (row) => row.price,
      width: '10%',
    },
    {
      title: '',
      render: (row) => <TableActionCell secondaryActions={secondaryAction} />,
      width: '10%',
    },
  ];

  return (
    <Card>
      <Table data={records} columns={columns}>
        <TableToolbar>
          <TableToolbar.ItemGroup position="start">
            <TableToolbar.Item>
              <TableToolbar.Title>Products</TableToolbar.Title>
            </TableToolbar.Item>
          </TableToolbar.ItemGroup>
        </TableToolbar>
        <Table.Content />
      </Table>
    </Card>
  );
};
```

### Accessibility examples

#### Alt text

By default, all images have empty `alt` text.

- For decorative images, leave alt text empty.
- For informative images that need to be described to screen readers, add alt text which describes the image in context.
- For images that have links, the alt text should also tell the screen reader where the link goes.

Use this [_alt decision tree_](https://www.w3.org/WAI/tutorials/images/decision-tree/) to determine whether an image needs alt text.

```jsx
<Image width="33%" src="example.jpg" alt="" />;
```

## Code

```jsx
import { Image } from '@wix/design-system';
```

### Props

| Name | Type | Default | Description |
| --- | --- | --- | --- |
| `alt` | `string` | `''` | Specifies an alt text for an image. If not provided, it is set to empty and treated as decorative. |
| `borderRadius` | `string \| number \| string & {}` | — | Sets the border radius of the image box. |
| `dataHook` | `string` | — | Applies a data-hook HTML attribute that can be used in the tests. |
| `fit` | `"none" \| "fill" \| "contain" \| "cover" \| "scale-down" \| "tile"` | `cover` | Specifies image fit mode inside a box. `tile` repeats the image, and the other values set the CSS `object-fit` property. |
| `height` | `string \| number` | `undefined` | Sets the height of the image box. |
| `position` | `string` | `center` | Specifies source content position inside of an image box. Accepts any valid CSS position value, for example `center` or `top left`. |
| `showBorder` | `boolean` | `false` | Specifies whether to display a border around an image. |
| `src` | `string` | — | Specifies an URL link to image source. If not provided, a default placeholder image is displayed. |
| `transparent` | `boolean` | `false` | Specifies whether background of Image is transparent. |
| `width` | `string \| number` | `'100%'` | Sets the width of the image box. |

## Testkit

Import the driver matching your test environment:

```jsx
// UniDriver
import { ImageUniDriver } from '@wix/design-system/dist/testkit/unidriver';

// Vanilla
import { ImageTestkit } from '@wix/design-system/dist/testkit';

// Puppeteer
import { ImageTestkit } from '@wix/design-system/dist/testkit/puppeteer';

// Testing Library
import { ImageTestkit } from '@wix/design-system/dist/testkit/testing-library';
```

### Driver methods

| Method | Description |
| --- | --- |
| `isTransparent` | Checks whether background of Image is transparent |
| `exists` | Checks whether the component found with the given data hook. |
| `element` | Gets the component root element. |
| `click` | Clicks on the component root element. |
| `base` | Returns UniDriver for the base element. |

## Changelog

- **1.340.0** (2026-10-21) — maintenance release, no component-specific changes
- **1.339.0** (2026-10-19) — maintenance release, no component-specific changes
- **1.338.0** (2026-10-15) — maintenance release, no component-specific changes
- **1.336.0** (2026-10-13) — maintenance release, no component-specific changes
- **1.330.3** (2026-09-29) — maintenance release, no component-specific changes
- **1.329.0** (2026-09-24) — maintenance release, no component-specific changes
- **1.325.0** (2026-09-17) — maintenance release, no component-specific changes
- **1.324.0** (2026-09-14) — maintenance release, no component-specific changes
- **1.310.0** (2026-08-10) — maintenance release, no component-specific changes
- **1.292.0** (2026-06-22) — maintenance release, no component-specific changes
- **1.291.0** (2026-06-19) — maintenance release, no component-specific changes
- **1.266.0** (2026-04-07) — maintenance release, no component-specific changes
- **1.260.0** (2026-03-17) — maintenance release, no component-specific changes
- **1.222.0** (2025-10-23) — fix: add missing "scale-down" "fit" prop value ([#15431](invalid-url))
- **1.198.0** (2025-06-09) — maintenance release, no component-specific changes
- **1.194.0** (2025-05-30) — breaking: tokenization ([#14902](invalid-url))
- **1.138.1** (2024-10-30) — maintenance release, no component-specific changes
- **1.115.0** (2024-07-17) — maintenance release, no component-specific changes
- **1.102.0** (2024-04-16) — maintenance release, no component-specific changes
- **1.93.0** (2024-02-08) — maintenance release, no component-specific changes
- **1.92.1** (2024-02-05) — maintenance release, no component-specific changes