ESLint plugin

The essential plugin for use with the Atlassian Design System.

no-html-image

Don't use native HTML images. The Atlassian Design System provides a ready-made image component that ensures accessible implementations and provides access to ADS styling features like design tokens.

Use the Atlassian Design System Image component when suitable.

Examples

This rule marks code as violations when it finds native HTML image elements.

Incorrect

<img src="foo.jpg" alt="The word 'foo' written on a white background." />
 ^^^ Using a native HTML `<img>`

<div role="img" src="foo.jpg" alt="The word 'foo' written on a white background." />
 ^^^ Using `role="img"` to create images

Correct

import Image from '@atlaskit/image';

<Image src="foo.jpg" alt="The word 'foo' written on a white background." />;
Was this page helpful?
We use this feedback to improve our documentation.
© 2026 AtlassianTrademark, (opens new window)Privacy, (opens new window)License