@atlaskit/icon
An icon is a symbol representing a command, device, directory, or common action.
37.5.2
source
What this package is like to depend on
Last release today
26 Aug 2026
Ships on a steady schedule
a new release about every 1 weeks
Nearly every release is documented
notes for 397 of 417 stable releases
1 version withdrawn
withdrawn after publishing
10 years old
418 releases · first in 2017
71 releases in the last 12 months
see the full history below
Release timeline
418 releases · Jan 2017 to Aug 2026Releases
latest 60 of 418-
22.0.222 Feb 2024Release notes
Open source →Patch Changes
- #64934
532734a858a1- Update to internal metadata order, following update of @atlaskit/icon-build-process
- #64934
-
22.0.115 Feb 2024Release notes
Open source →Patch Changes
- #72130
b037e5451037- Update new button text color fallback for default theme (non-token) to match that of old button current text color
- #72130
-
22.0.017 Nov 2023Release notes
Open source →Major Changes
- #41812
48b3b440f51- Removed all remaining legacy theming logic from the Icon and ProgressIndicator components.
- #41812
-
21.12.825 Oct 2023Release notes
Open source →Patch Changes
- #42106
f4b2c484864- Improve typing and prop naming in icon explorer utility.
- #42106
-
21.12.708 Aug 2023Release notes
Open source →Patch Changes
- #38199
8a5ce2c105e- This package is now onboarded onto the product push model.Th
- #38199
-
21.12.613 Jul 2023Release notes
Open source →Patch Changes
- #36754
4ae083a7e66- Use@af/accessibility-testingfor default jest-axe config and jest-axe import in accessibility testing.
- #36754
-
21.12.504 Jul 2023Release notes
Open source →Patch Changes
- #35441
599bfe90ee3- Internal change to use shape tokens. There is no expected visual change.
- #35441
-
21.12.430 May 2023Release notes
Open source →Patch Changes
- #33652
e7ea6832ad2- Bans the use of React.FC/React.FunctionComponent type in ADS components as part of the React 18 migration work. The change is internal only and should not introduce any changes for the component consumers.
- #33652
-
21.12.329 May 2023Release notes
Open source →Patch Changes
- #32935
b1bdec7cce2- Internal change to enforce token usage for spacing properties. There is no expected visual or behaviour change.
- #32935
-
21.12.217 May 2023Release notes
Open source →Patch Changes
- #33793
9d00501a414- Ensure legacy types are published for TS 4.5-4.8
- #33793
-
21.12.115 May 2023Release notes
Open source →Patch Changes
- #33649
41fae2c6f68- Upgrade Typescript from4.5.5to4.9.5
- #33649
-
21.12.008 May 2023Release notes
Open source → -
21.11.507 Feb 2023 -
21.11.429 Dec 2022 -
21.11.328 Dec 2022 -
21.11.230 Nov 2022 -
21.11.107 Nov 2022Release notes
Open source →Patch Changes
- #25860
88a34a8c2dd- Remove redundantrole=presentationon wrapping @atlaskit/icon and @atlaskit/logo spans. 15d704e3090- For an SVG icon, do not render aaria-labelwhen empty.
- #25860
-
21.11.011 Oct 2022Release notes
Open source →Minor Changes
- #24710
a3973745679- Updates@emotion/coreto@emotion/react; v10 to v11. There is no expected behavior change.
- #24710
-
21.10.804 Oct 2022Release notes
Open source →Patch Changes
- #24874
8cc2f888c83- Upgrade Typescript from4.3.5to4.5.5
- #24874
-
21.10.717 May 2022 -
21.10.607 Apr 2022 -
21.10.517 Mar 2022 -
21.10.403 Mar 2022 -
21.10.314 Feb 2022Release notes
Open source →Patch Changes
- #16752
58884c2f6c1- Internal code change turning on a new linting rule.
- #16752
-
21.10.228 Jan 2022Release notes
Open source →Patch Changes
19d72473dfb- Updates usage of deprecated token names so they're aligned with the latest naming conventions. No UI or visual changes- Updated dependencies
-
21.10.125 Jan 2022 -
21.10.006 Jan 2022Release notes
Open source →Minor Changes
-
#17576
1c835620aa5- Note: It is a re-release of the wronglypatchedversion21.9.2that should have been aminorrelease.CETI-16 added remove emoji icon so that it appears in mobilekit too
Patch Changes
- Updated dependencies
-
-
21.9.321 Dec 2021Release notes
Open source →Patch Changes
- #17475
c55c736ecea- Patch VULN AFP-3486 AFP-3487 AFP-3488 AFP-3489
- #17475
-
21.9.217 Nov 2021 withdrawnWRONG RELEASE TYPE - DON'T USE
Release notes
Open source →Minor Changes
WRONG RELEASE TYPE - DON'T USE
- #15998
229177bb85d- CETI-16 added remove emoji icon so that it appears in mobilekit too
Patch Changes
f460cc7c411- Builds for this package now pass through a tokens babel plugin, removing runtime invocations of the tokens() function and improving bundle size.- Updated dependencies
- #15998
-
21.9.129 Oct 2021 -
21.9.016 Sep 2021Release notes
Open source →Minor Changes
- #14319
cf853e39278- [ux] add single layout support for layout
Patch Changes
- Updated dependencies
- #14319
-
21.8.131 Aug 2021 -
21.8.026 Aug 2021Release notes
Open source →Minor Changes
-
#13864
22b8dd3f590- Instrumented Icon with the new theming package,@atlaskit/tokens.New tokens will be visible only in applications configured to use the new Tokens API (currently in alpha). These changes are intended to be interoperable with the legacy theme implementation. Legacy dark mode users should expect no visual or breaking changes.
-
88ff832bd2b- Add @atlaskit/icon/glyph/editor/file-preview to atlaskit/icon package for media group toolbar
Patch Changes
- Updated dependencies
-
-
21.7.419 Aug 2021Release notes
Open source →Patch Changes
- #13302
af4bca32ad4- Internal changes to supress eslint rules.
- #13302
-
21.7.328 Jul 2021Release notes
Open source →Patch Changes
- #12837
0d0ecc6e790- Corrects eslint supressions. 8279380176b- Internal code changes.9a84a3ceb82- Internal code changes.- Updated dependencies
- #12837
-
21.7.223 Jul 2021Release notes
Open source →Patch Changes
- #13102
0c0c4315085- [ux] Fixed a regression where Icons used static colors in High Contrast Mode when they should actually dynamically respond to changes to theprimaryColorandsecondaryColorprops.
- #13102
-
21.7.116 Jul 2021Release notes
Open source →Patch Changes
- #12880
378d1cef00f- Bump@atlaskit/themeto version^11.3.0.
- #12880
-
21.7.008 Jul 2021Release notes
Open source →Minor Changes
- #12328
662739d8c28- Icon now uses internal techstack "design-system: v1" and "styling: emotion".
Patch Changes
2368dfabe46- fix Icon appearance in windows high contrast mode54b0730475e- Fixed an a11y bug associated with the role of the SVGIcon component. The role now correctly adapts to whether a user provides a label or not.
- #12328
-
21.6.125 Jun 2021Release notes
Open source →Patch Changes
- #11649
9f5d6ed95f0- Added aria-hidden to icon wrapper when there is no label provided
- #11649
-
21.6.027 May 2021Release notes
Open source →Minor Changes
- #11113
b9c78813d40- Use named export of base icon instead of default in icon glyphs
- #11113
-
21.5.126 May 2021 -
21.5.030 Mar 2021Release notes
Open source →Minor Changes
- #9083
017587eca78- Icon now exposes an additional componentSVGwhich can be used to for custom icon use cases. 4203387aa43- Internal changes to the way Icon styles are generated. Additional types have also been exposed to match the glyph component.
Patch Changes
469f36d9629- Icon build tooling has been updated.d6580503ce9- Internal refactor for JSDoc annotated modules.3de10e7652e- Documentation updates and fixes to types for all icon packages.d98f1bb1169- Local build tooling improvements.
- #9083
-
21.4.009 Mar 2021Release notes
Open source →Minor Changes
- #8644
2f1a299688b- ThesizeOptstype has been renamed toSize, available in both the./and./typesentrypoints.
Patch Changes
79c23df6340- Use injected package name and version for analytics instead of version.json.f922302ad53- Icons no longer ship with thefocusableattribute in their glyph exports. This attribute was only required for IE11 support. This is purely a build change and has no effect on user API.
- #8644
-
21.3.024 Feb 2021Release notes
Open source →Minor Changes
-
#8178
b9265389fa0- Icon now exposes a base icon via the@atlaskit/icon/baseentrypoint. This is used in all generated glyphs inside the icon package. -
83944ca2cf2- Icon now ships with cjs, esm, and es2019 bundles for components and utils exported in the icon package. Glyphs unfortunately aren't included and still only export cjs bundles. -
6ef8824baee- - Icon now uses React.memo() to stop unnecessary re-renders.- A bug in the types for icon sizes has been resolved
This change also includes a number of quality of life fixes as part of lite mode.
Internal changes
- class components have been changed to functional components
- styled-components has been removed as a peer dependency
- @emotion/core has been added a direct dependency, base components now use emotion for styling
- An internal gradient function
insertDynamicGradientIdhas been removed from the runtime - Enzyme removed in favour of RTL
Updating tests
Tests that rely on
enzymemay have issues with this update. We've mostly seen issues with one of the following cases.Can't find internal react test id
Because icon is now wrapped in
memoyou won't be able to easily find it. This code will fail:import BookIcon from '@atlaskit/icon/glyph/book'; <BookIcon />; wrapper.find('BookIcon');As a fix you can add memo to the target:
wrapper.find('Memo(BookIcon)');Even better, use the test id.
<BookIcon testId="book-icon" />; wrapper.find('[data-testid="book-icon"]');Treating the icon as a button
Icon hasn't had an
onClickhandler since many major versions. This code will fail:const Example = () => <Button testId="test-id" iconBefore={<SomeGlyph />} />; // in some teat wrapper.find(SomeGlyph).click(); // OR wrapper.find('SomeGlyph').click();As a fix you can target the button instead:
wrapper.find('[data-testid="test-id"]').click();
Patch Changes
0741b1556f6- All icon glpyhs are now built without inline extends helpers, reducing their bundlesize.8d6c79b9055- Typedefs of glyphs have been updated to reflect an API change that occured in version 15. For context,onClickwas removed as a functional prop but it was still supported by the types. This may have resulted in a confusing developer experience although the fundamental behaviour has been consistent since version 15.
-
-
21.2.409 Feb 2021Release notes
Open source →Patch Changes
- #7762
37afe4a0fd5- [ux] Update Dropbox icon and arrow-left icon
- #7762
-
21.2.327 Jan 2021Release notes
Open source →Patch Changes
- #7425
b9f0d16300- Re-generated icons using a newer version of the build process
- #7425
-
21.2.220 Jan 2021Release notes
Open source →Patch Changes
-
#7589
c65f28c058- Change codemod to return raw source if it is not transforming a file.Otherwise it would run prettier which can lead to some invalid syntax outputted in edge cases. This is likely due to an issue in either
codemod-cliorjscodeshift.
-
-
21.2.115 Jan 2021Release notes
Open source →Patch Changes
-
#7458
bc896a20b0- Add a missing codemod for the entrypoint change in 21.2.0
Running the codemod cli
To run the codemod: You first need to have the latest version installed before you can run the codemod
yarn upgrade @atlaskit/PACKAGE@^VERSIONOnce upgraded, use the Atlaskit codemod-cli;
npx @atlaskit/codemod-cli --parser [PARSER] --extensions [FILE_EXTENSIONS] [TARGET_PATH]Or run
npx @atlaskit/codemod-cli -hfor more details on usage. For Atlassians, refer to this doc for more details on the codemod CLI.
-
-
21.2.004 Jan 2021Release notes
Open source →Minor Changes
- #7170
fbdf356800- Remove undocumented metadata export from main entry point. To import metadata instead do it from the /metadata entrypoint.
- #7170
-
21.1.415 Oct 2020Release notes
Open source →Patch Changes
- #5497
5f58283e1f- Export types using Typescript's new "export type" syntax to satisfy Typescript's --isolatedModules compiler option. This requires version 3.8 of Typescript, read more about how we handle Typescript versions here: https://atlaskit.atlassian.com/get-started Also addtypescripttodevDependenciesto denote version that the package was built with.
- #5497
-
21.1.302 Oct 2020 -
21.1.202 Sep 2020Release notes
Open source →Patch Changes
- #4649
d6ff4c7dce- Removes unused (and incorrect) es2019 key in package.json
- #4649
-
21.1.101 Sep 2020Release notes
Open source →Patch Changes
- #4682
f51e6ff443- License updated to Apache 2.0 (previously under the ADG license)
- #4682
-
21.1.001 Sep 2020Release notes
Open source →Minor Changes
- #4424
2f414dd083- The new ArchiveIcon is now available to use viaimport ArchiveIcon from '@atlaskit/icon/glyph/archive';
- #4424
-
21.0.324 Aug 2020Release notes
Open source →Patch Changes
-
#3885
6c525a8229- Upgraded to TypeScript 3.9.6 and tslib to 2.0.0Since tslib is a dependency for all our packages we recommend that products also follow this tslib upgrade to prevent duplicates of tslib being bundled.
-
-
21.0.217 Aug 2020Release notes
Open source →Patch Changes
- #3823
6262f382de- Use the 'lodash' package instead of single-function 'lodash.*' packages
- #3823
-
21.0.115 Jul 2020Release notes
Open source →Patch Changes
- #3428
db053b24d8- Update all the theme imports to be tree-shakable
- #3428
-
21.0.002 Jul 2020Release notes
Open source →Major Changes
- #3335
87f4720f27- Officially dropping IE11 support, from this version onwards there are no warranties of the package working in IE11. For more information see: https://community.developer.atlassian.com/t/atlaskit-to-drop-support-for-internet-explorer-11-from-1st-july-2020/39534
Patch Changes
- Updated dependencies
- #3335
-
20.1.207 May 2020 -
20.1.124 Apr 2020Release notes
Open source →Patch Changes
-
[patch]449ef134b3:
Add a clear icon for datepicker, timepicker and datetimepicker- Updated dependencies dfc4dba1b3:
-
Updated dependencies 3940bd71f1:
-
Updated dependencies 6b8e60827e:
-
Updated dependencies f6667f2909:
-
Updated dependencies 9a534d6a74:
-
Updated dependencies 57c0487a02:
- @atlaskit/[email protected]
- @atlaskit/[email protected]
- @atlaskit/[email protected]
- @atlaskit/[email protected]
- @atlaskit/[email protected]
-