Icon Tile with design language improvements is default from v35, migration may be required

The new design language updates for IconTile — previewed at Team '26 and previously rolling out behind feature flags — are now the default in @atlaskit/icon v35.0.0.

(image)

(image)

Alongside the feature flag cleanup, there are API changes you'll need to be aware of.

Size prop changes — pixel values removed, t-shirt sizes only

The size prop on IconTile no longer accepts pixel number strings. All sizes now use t-shirt size names. The following pixel values have been removed and must be migrated:

Removed value	New value	Rendered size
"24"	"small"	24px
"32"	"medium"	32px
"40"	"large"	40px
"48"	"xlarge"	48px

The default size has also changed from "small" (24px) to "medium" (32px). If you were relying on the default, explicitly pass size="small" to retain the previous behaviour.

New size: xsmall (20px)

A new "xsmall" size has been introduced, rendering at 20px. This is now the smallest available IconTile size.

16px icon tile removed — migrate to a standalone colored icon

The size="16" option for IconTile has been removed entirely as it was too small to be accessible. There is no 16px tile — the smallest tile is now "xsmall" at 20px.

If you previously used a 16px IconTile, migrate to rendering the 16px icon directly with a colour token:

- import { IconTile } from '@atlaskit/icon';
- import CommentIcon from '@atlaskit/icon/core/comment';
-
- <IconTile icon={CommentIcon} label="" appearance="gray" size="16" />

+ import CommentIcon from '@atlaskit/icon/core/comment';
+ import { token } from '@atlaskit/tokens';
+
+ <CommentIcon label="" color={token('color.icon.accent.gray')} />

(image)

LegacyIconTileSize and NewIconTileSize types removed

The transitional types LegacyIconTileSize and NewIconTileSize have been removed. Use IconTileSize directly:

- import type { LegacyIconTileSize } from '@atlaskit/icon/types';
- import type { NewIconTileSize } from '@atlaskit/icon/types';

+ import type { IconTileSize } from '@atlaskit/icon/types';

IconTileSize is now the single canonical type, defined as:

type IconTileSize = 'xsmall' | 'small' | 'medium' | 'large' | 'xlarge';

Circular appearance (shape="circle") - removal imminent

The shape prop on IconTile has been deprecated for over 6 months now and will be removed in a future version very soon. Circular icon tiles will not be supported.

If you are currently using shape="circle", you must plan your migration now:

• Assess the need for circular icon appearance: We’re asking you to migrate to square Icon tiles where possible, otherwise
• Use ADS primitives: Rebuild using ADS primitives (Box with borderRadius: radius.full for example).

Forge UI Kit - Coming soon

The IconTile component is coming soon to Forge UI Kit.

Related resources

• IconTile documentation on atlassian.design