Avatar group

An avatar group displays a number of avatars grouped together in a stack or grid.

Neutral selected states

When the platform-dst-tokens-finesse feature flag is enabled, this component uses the new neutral treatment for selected states.

Motion in Early Access

Motion updates for this component are in Early Access and available behind the platform-dst-motion-uplift feature flag.

14.3.7

Patch Changes

  • Updated dependencies

14.3.6

Patch Changes

  • Updated dependencies

14.3.5

Patch Changes

  • Updated dependencies

14.3.4

Patch Changes

  • a7ec100f7d560, (opens new window) - The top-layer code path now uses @atlaskit/top-layer's useAnchoredPopover, so these popovers are capped to the viewport and one too wide for the space beside its trigger moves to a roomier side rather than wrapping into it. No public API change. Behind the platform-dst-top-layer gate (platform-dst-top-layer-tooltip for @atlaskit/tooltip, platform-dst-top-layer-spotlight for @atlaskit/spotlight); legacy (flag-off) behaviour is unchanged.
  • Updated dependencies

14.3.3

Patch Changes

  • Updated dependencies

14.3.2

Patch Changes

14.3.1

Patch Changes

14.3.0

Minor Changes

Patch Changes

  • Updated dependencies

14.2.3

Patch Changes

14.2.2

Patch Changes

14.2.1

Patch Changes

14.2.0

Minor Changes

  • d82e6f76528ab, (opens new window) - Add direct subpath package exports as part of the linking-platform, search, media, and design-system barrel-removal (de-barrel) migration.

    These packages now expose their individual modules via explicit package.json exports subpaths so that consumers can import directly from the leaf module (e.g. @atlaskit/pkg/thing) instead of the package barrel/index. This adds new public entry points without changing or removing any existing exports, so it is a backwards-compatible additive change.

    No runtime behaviour changes; this is an API-surface (entry-point) addition to support tree-shaking and to unblock removal of the barrel index files.

Patch Changes

  • Updated dependencies

14.1.0

Minor Changes

Patch Changes

  • Updated dependencies

14.0.1

Patch Changes

  • Updated dependencies

14.0.0

Major Changes

  • f6328151ae86c, (opens new window) - Apply Volt entry-point and multi-export standards via volt-migrate-package. This is a major change to @atlaskit/avatar-group: the package exports map has been restructured so every public subpath now resolves directly to its ./src/* implementation instead of going through an intermediate ./src/entry-points/* re-export. No public subpaths were removed.

    Why this is breaking

    Because each subpath now points straight at its implementation module, a subpath and the package root can resolve to the same module instance. Consumers that deep-import the internal entry-points/* files, or that jest.mock() a specific subpath, may observe changed resolution/behaviour and need updating.

    Migration — public imports are unchanged

    Importing the published subpaths (or the package root) continues to work as before:

    // Still valid — no change required import AvatarGroup from '@atlaskit/avatar-group/avatar-group';

    If you were reaching into the internal entry-point modules, switch to the public subpath:

    -import AvatarGroup from '@atlaskit/avatar-group/entry-points/avatar-group'; +import AvatarGroup from '@atlaskit/avatar-group/avatar-group';

    Before / after exports map

    "exports": { ".": "./src/index.tsx", - "./avatar-group": "./src/entry-points/avatar-group.tsx", + "./avatar-group": "./src/components/avatar-group.tsx", - "./types": "./src/entry-points/types.tsx", + "./types": "./src/components/types.tsx", }

    Note that ./types now resolves to the whole ./src/components/types.tsx module, so it exposes additional types beyond the previously re-exported AvatarProps and AvatarGroupOverrides.

Patch Changes

  • Updated dependencies

13.2.7

Patch Changes

  • Updated dependencies

13.2.6

Patch Changes

  • Updated dependencies

13.2.5

Patch Changes

  • Updated dependencies

13.2.4

Patch Changes

  • Updated dependencies

13.2.3

Patch Changes

  • 2625970306ba3, (opens new window) - Cleanup feature gate platform-avatar-group-pass-avatar-to-item. Custom avatar components and Avatar overrides are now always forwarded to overflowed items inside the avatar group dropdown, making this behaviour permanent.
  • Updated dependencies

13.2.2

Patch Changes

  • Updated dependencies

13.2.1

Patch Changes

  • 3a45d08ff1c62, (opens new window) - Add xxsmall as the public 16px Avatar size and deprecate xsmall as the legacy 16px alias. This starts the migration from the existing 16/24px Avatar size scale to 16/20/24px. Static Avatar usages in AFM should migrate from xsmall to xxsmall; xsmall remains available for now and continues to render as 16px while the migration feature gate is off.

    AvatarGroup continues to exclude the Avatar-only 16px and 20px sizes.

  • fb8662a810538, (opens new window) - [ux] Removing unused support for a hexagonal more indicator in the avatar group component

  • Updated dependencies

13.2.0

Minor Changes

Patch Changes

  • Updated dependencies

13.1.3

Patch Changes

  • 0a1dac0483f0a, (opens new window) - AvatarGroupSize now also excludes the new UNSAFE_xsmall (20px) avatar size, in addition to the already-excluded xsmall (16px). The more indicator and grouped avatars cannot be displayed in an accessible manner at these sizes, so they remain unsupported on AvatarGroup.
  • Updated dependencies

13.1.2

Patch Changes

  • Updated dependencies

13.1.1

Patch Changes

13.1.0

Minor Changes

  • cd097a2111788, (opens new window) - Republish packages depending on @atlaskit/react-compiler-gating so their published dependency reference is updated to the renamed @atlaskit/react-compiler-gating scope.

    The earlier rename of @atlassian/react-compiler-gating to @atlaskit/react-compiler-gating only bumped the renamed package itself, so dependent packages were never republished and their published versions still referenced the old @atlassian/react-compiler-gating name, which is not available in the public npm registry. This minor bump republishes all affected packages with the corrected dependency.

Patch Changes

  • Updated dependencies

13.0.1

Patch Changes

13.0.0

Major Changes

  • f2dc9097319f0, (opens new window) - ### Dropped support for legacy Typescript 4 types. Typescript 5 is now the new minimum.

    Removes the typesVersions property and dist/types-ts4.5 directory from the dist.

    Types are now exclusively via the "types": "dist/types/index.d.ts" property.

    - "typesVersions": { - ">=4.5 <4.9": { - "*": [ - "dist/types-ts4.5/*", - "dist/types-ts4.5/index.d.ts" - ] - } - },

Patch Changes

  • Updated dependencies

12.11.0

Minor Changes

  • 032135d12186b, (opens new window) - Top-layer: fix initial focus regressions on the top-layer adapters for @atlaskit/avatar-group and @atlaskit/popup. Behind the platform-dst-top-layer feature gate.

Patch Changes

  • Updated dependencies

12.10.12

Patch Changes

  • Updated dependencies

12.10.11

Patch Changes

  • Updated dependencies

12.10.10

Patch Changes

  • 6d0485dce81c4, (opens new window) - Internal: updated to the new @atlaskit/top-layer Popover/Dialog behaviour where the host element unmounts after the exit animation completes. No consumer action required.
  • Updated dependencies

12.10.9

Patch Changes

  • Updated dependencies

12.10.8

Patch Changes

12.10.7

Patch Changes

  • Updated dependencies

12.10.6

Patch Changes

  • Updated dependencies

12.10.5

Patch Changes

  • Updated dependencies

12.10.4

Patch Changes

  • Updated dependencies

12.10.3

Patch Changes

  • Updated dependencies

12.10.2

Patch Changes

  • Updated dependencies

12.10.1

Patch Changes

  • Updated dependencies

12.10.0

Minor Changes

  • a8dd7ae55feff, (opens new window) - Passes the custom avatar component prop from AvatarGroup down to AvatarGroupItem in the overflow dropdown menu, ensuring custom avatar components are used consistently for both visible and overflowed avatars. This change is behind the platform-avatar-group-pass-avatar-to-item feature flag.

12.9.0

Minor Changes

  • 7250582895c0b, (opens new window) - Top-layer adoption work behind the platform-dst-top-layer feature flag. Public adopter APIs are intentionally kept narrow while the top-layer API surface settles, with one exception called out below.

    Highlights:

    • Pass the full [along, away] legacy popper offset through to the new top-layer placement.offset API (via fromLegacyPlacement). Previously only the away axis was forwarded, which dropped the along offset for consumers of Popup, PopupSelect, Spotlight, and Tooltip when platform-dst-top-layer is enabled.
    • Fix broken import of dialogHeight and dialogWidth from the removed utils module in @atlaskit/modal-dialog.

    Public API:

    • @atlaskit/tooltip (minor): add an optional testId?: string field to TriggerProps. This is additive (no existing prop changes shape). Required because @atlaskit/button/new (and other Pressable-backed primitives) overwrite data-testid from spread, so the legacy (triggerProps as any)['data-testid'] workaround is silently absorbed by those consumers. A typed testId field flows through their own testId destructure instead, restoring data-testid propagation onto the rendered trigger element.
    • @atlaskit/popup, @atlaskit/dropdown-menu (patch): no public type changes. Wider aria-haspopup unions that the FF-on path produces are bridged at the package boundary into @atlaskit/top-layer with localised FUDGE(top-layer-api) casts, documented in packages/design-system/top-layer/notes/decisions/migration-roadmap.md ("Open API decisions deferred to a follow-up PR"). They will be widened in a follow-up minor PR once the top-layer API is committed.
    • @atlaskit/modal-dialog, @atlaskit/select, @atlaskit/spotlight (patch/minor): no public type changes; bug fixes only.

    Merge-readiness fixes (FF-on test wiring + adopter behavior):

    • @atlaskit/popup (minor): wire the compositional PopupContent to delegate to PopupContentTopLayer when platform-dst-top-layer is enabled. Previously only the legacy Popup component had the FF branch, leaving consumers of the compositional API on the legacy popper path.
    • @atlaskit/select (minor): add an onClick handler to the PopupSelect top-layer trigger so clicks open/close the menu (mirrors the legacy global click handler in popup-select.tsx). Add explicit Escape handling on the menu's onKeyDown so the menu closes and focus returns to the trigger.
    • @atlaskit/top-layer (patch): the <dialog> rendered by the Dialog primitive now sets aria-modal="true" explicitly. Modern browsers infer modal semantics from .showModal() but some assistive tech still keys off the explicit attribute.
    • @atlaskit/top-layer (patch): guard use-anchor-positioning against environments where ResizeObserver is not defined (e.g. jest's node environment, used by the post-office test suite). The observer is used to wait for the popover's first valid layout before measuring; consumers in non-DOM jest environments now get a no-op observer and the scroll/resize listeners still apply if the host environment polyfills showPopover. Real browsers always have ResizeObserver.
    • @atlaskit/modal-dialog (patch): on the FF-on path, drop the tabIndex={-1} (and unused :focus-visible outline) from the modal content wrapper. The native <dialog>.showModal() focus-delegate algorithm picks the first focusable descendant (including tabindex=-1), and the wrapper was hijacking initial focus from the close button. Also honor shouldReturnFocus={ref} on the FF-on path (an unmount-cleanup focuses the ref after dialog.close() so it overrides the browser's automatic return-to-trigger). Boolean shouldReturnFocus={false} is not yet honored on the FF-on path — see top-layer/notes/merge-blockers.md.
    • @atlaskit/datetime-picker (patch): on the FF-on path, set mode="manual" on the Popup.Content rendered by both internal/menu-top-layer.tsx (date-picker calendar) and internal/fixed-layer-menu-top-layer.tsx (time-picker menu). With the default mode="auto", the same click event that opens the menu (which targets the react-select combobox input — outside the popover element) bubbles to the browser's native popover light-dismiss handler and immediately closes the menu. react-select / DateTimePicker already own outside-click and Esc dismissal via their own state, so opting out of the native auto-dismiss is the correct integration. Also extend the existing Esc → trigger-focus restoration in components/date-picker.tsx to the FF-on path (manual mode disables the browser's built-in focus return, and the legacy code path was already handling this for itself behind an FF negation).
    • @atlaskit/popup (no public API change): no source changes — only FF-on Playwright spec/example fixes drove the suite from 21/3/2 to 27/0/0. Notable: the two test.fixme'd nested-popover cases were not browser limitations; popover="auto" chains correctly via DOM ancestry (the original fixmes had the wrong testId selector). Added testId props to two examples (16-popup-with-a11y-props, 18-should-fit-container) so default-shape tests can reach the trigger.
    • Test alignment for FF-on Playwright suites across popup, select, datetime-picker, inline-dialog, inline-message, and modal-dialog: selector updates to match the new top-layer testId convention (${testId}--content, [role="dialog"][aria-label="calendar"]), per-spec skipAxeCheck() for example-level color-contrast violations unrelated to the migration, and focus assertions adjusted to match native <dialog> / Popup.Content auto-focus semantics (focus lands on the first focusable child, not the dialog container itself).
    • @atlassian/capacity-planning-capacity-graph, @atlaskit/color-picker, @atlassian/timeline-table, @atlassian/global-side-navigation (patch): scope fg mocks in unit tests so platform-dst-top-layer returns false. JSDOM does not implement the native Popover API (showPopover/hidePopover/toggle events), so leaving the gate ON in unit tests caused popover content to remain in the DOM after close and broke close-behaviour assertions. Browser coverage for the FF-on path is provided by the Playwright suites listed above.
    • @atlaskit/dropdown-menu (no public API change): test/example-only fixes for the FF-on Playwright suite. Added role="menuitem" to the nested-trigger ButtonItem in examples/93-testing-nested-keyboard-navigation-top-layer.tsx to satisfy axe's aria-required-children rule on the parent menu. Added a test.beforeEach(skipAxeCheck) to dropdown-menu.spec.tsx (FF-on suite) for example-level color-contrast violations on the pre-existing color.text.selected/color.background.selected token pair (3.91:1). Replaced a deadlocking await expect(moveItem).not.toBeFocused() pre-open assertion (Playwright's auto-wait blocks 5s on the absent element) with await expect(moveItem).not.toBeVisible(). Suite result: 22/22 passing.

Patch Changes

  • Updated dependencies

12.8.0

Minor Changes

  • 2bed6255731de, (opens new window) - Top-layer adoption work behind the platform-dst-top-layer feature flag. Public adopter APIs are intentionally kept narrow while the top-layer API surface settles, with one exception called out below.

    Highlights:

    • Pass the full [along, away] legacy popper offset through to the new top-layer placement.offset API (via fromLegacyPlacement). Previously only the away axis was forwarded, which dropped the along offset for consumers of Popup, PopupSelect, Spotlight, and Tooltip when platform-dst-top-layer is enabled.
    • Fix broken import of dialogHeight and dialogWidth from the removed utils module in @atlaskit/modal-dialog.

    Public API:

    • @atlaskit/tooltip (minor): add an optional testId?: string field to TriggerProps. This is additive (no existing prop changes shape). Required because @atlaskit/button/new (and other Pressable-backed primitives) overwrite data-testid from spread, so the legacy (triggerProps as any)['data-testid'] workaround is silently absorbed by those consumers. A typed testId field flows through their own testId destructure instead, restoring data-testid propagation onto the rendered trigger element.
    • @atlaskit/popup, @atlaskit/dropdown-menu (patch): no public type changes. Wider aria-haspopup unions that the FF-on path produces are bridged at the package boundary into @atlaskit/top-layer with localised FUDGE(top-layer-api) casts, documented in packages/design-system/top-layer/notes/decisions/migration-roadmap.md ("Open API decisions deferred to a follow-up PR"). They will be widened in a follow-up minor PR once the top-layer API is committed.
    • @atlaskit/modal-dialog, @atlaskit/select, @atlaskit/spotlight (patch/minor): no public type changes; bug fixes only.

    Merge-readiness fixes (FF-on test wiring + adopter behavior):

    • @atlaskit/popup (minor): wire the compositional PopupContent to delegate to PopupContentTopLayer when platform-dst-top-layer is enabled. Previously only the legacy Popup component had the FF branch, leaving consumers of the compositional API on the legacy popper path.
    • @atlaskit/select (minor): add an onClick handler to the PopupSelect top-layer trigger so clicks open/close the menu (mirrors the legacy global click handler in popup-select.tsx). Add explicit Escape handling on the menu's onKeyDown so the menu closes and focus returns to the trigger.
    • @atlaskit/top-layer (patch): the <dialog> rendered by the Dialog primitive now sets aria-modal="true" explicitly. Modern browsers infer modal semantics from .showModal() but some assistive tech still keys off the explicit attribute.
    • @atlaskit/top-layer (patch): guard use-anchor-positioning against environments where ResizeObserver is not defined (e.g. jest's node environment, used by the post-office test suite). The observer is used to wait for the popover's first valid layout before measuring; consumers in non-DOM jest environments now get a no-op observer and the scroll/resize listeners still apply if the host environment polyfills showPopover. Real browsers always have ResizeObserver.
    • @atlaskit/modal-dialog (patch): on the FF-on path, drop the tabIndex={-1} (and unused :focus-visible outline) from the modal content wrapper. The native <dialog>.showModal() focus-delegate algorithm picks the first focusable descendant (including tabindex=-1), and the wrapper was hijacking initial focus from the close button. Also honor shouldReturnFocus={ref} on the FF-on path (an unmount-cleanup focuses the ref after dialog.close() so it overrides the browser's automatic return-to-trigger). Boolean shouldReturnFocus={false} is not yet honored on the FF-on path — see top-layer/notes/merge-blockers.md.
    • @atlaskit/datetime-picker (patch): on the FF-on path, set mode="manual" on the Popup.Content rendered by both internal/menu-top-layer.tsx (date-picker calendar) and internal/fixed-layer-menu-top-layer.tsx (time-picker menu). With the default mode="auto", the same click event that opens the menu (which targets the react-select combobox input — outside the popover element) bubbles to the browser's native popover light-dismiss handler and immediately closes the menu. react-select / DateTimePicker already own outside-click and Esc dismissal via their own state, so opting out of the native auto-dismiss is the correct integration. Also extend the existing Esc → trigger-focus restoration in components/date-picker.tsx to the FF-on path (manual mode disables the browser's built-in focus return, and the legacy code path was already handling this for itself behind an FF negation).
    • @atlaskit/popup (no public API change): no source changes — only FF-on Playwright spec/example fixes drove the suite from 21/3/2 to 27/0/0. Notable: the two test.fixme'd nested-popover cases were not browser limitations; popover="auto" chains correctly via DOM ancestry (the original fixmes had the wrong testId selector). Added testId props to two examples (16-popup-with-a11y-props, 18-should-fit-container) so default-shape tests can reach the trigger.
    • Test alignment for FF-on Playwright suites across popup, select, datetime-picker, inline-dialog, inline-message, and modal-dialog: selector updates to match the new top-layer testId convention (${testId}--content, [role="dialog"][aria-label="calendar"]), per-spec skipAxeCheck() for example-level color-contrast violations unrelated to the migration, and focus assertions adjusted to match native <dialog> / Popup.Content auto-focus semantics (focus lands on the first focusable child, not the dialog container itself).
    • @atlassian/capacity-planning-capacity-graph, @atlaskit/color-picker, @atlassian/timeline-table, @atlassian/global-side-navigation (patch): scope fg mocks in unit tests so platform-dst-top-layer returns false. JSDOM does not implement the native Popover API (showPopover/hidePopover/toggle events), so leaving the gate ON in unit tests caused popover content to remain in the DOM after close and broke close-behaviour assertions. Browser coverage for the FF-on path is provided by the Playwright suites listed above.
    • @atlaskit/dropdown-menu (no public API change): test/example-only fixes for the FF-on Playwright suite. Added role="menuitem" to the nested-trigger ButtonItem in examples/93-testing-nested-keyboard-navigation-top-layer.tsx to satisfy axe's aria-required-children rule on the parent menu. Added a test.beforeEach(skipAxeCheck) to dropdown-menu.spec.tsx (FF-on suite) for example-level color-contrast violations on the pre-existing color.text.selected/color.background.selected token pair (3.91:1). Replaced a deadlocking await expect(moveItem).not.toBeFocused() pre-open assertion (Playwright's auto-wait blocks 5s on the absent element) with await expect(moveItem).not.toBeVisible(). Suite result: 22/22 passing.

Patch Changes

  • Updated dependencies

12.7.2

Patch Changes

  • Updated dependencies

12.7.1

Patch Changes

  • Updated dependencies

12.7.0

Minor Changes

Patch Changes

  • Updated dependencies

12.6.2

Patch Changes

  • Updated dependencies

12.6.1

Patch Changes

  • Updated dependencies

12.6.0

Minor Changes

12.5.2

Patch Changes

12.5.1

Patch Changes

12.5.0

Minor Changes

Patch Changes

  • Updated dependencies

12.4.13

Patch Changes

  • Updated dependencies

12.4.12

Patch Changes

12.4.11

Patch Changes

  • Updated dependencies

12.4.10

Patch Changes

  • Updated dependencies

12.4.9

Patch Changes

  • 6d96b2f268a28, (opens new window) - Remove external image dependencies from ads examples by using fallback avatars instead of third-party images.

    Changes:

    • Circle avatars now display user initials (semantically correct for person avatars)
    • Square/hexagon avatars display appropriate fallback icons (correct usage for non-person entities)
    • Aligns constellation examples with VR test examples which already use fallback only
    • Improves reliability by removing dependency on third-party image hosting

12.4.8

Patch Changes

12.4.7

Patch Changes

  • Updated dependencies

12.4.6

Patch Changes

  • Updated dependencies

12.4.5

Patch Changes

  • Updated dependencies

12.4.4

Patch Changes

12.4.3

Patch Changes

  • Updated dependencies

12.4.2

Patch Changes

  • Updated dependencies

12.4.1

Patch Changes

  • Updated dependencies

12.4.0

Minor Changes

12.3.3

Patch Changes

  • Updated dependencies

12.3.2

Patch Changes

  • Updated dependencies

12.3.1

Patch Changes

  • a37090c1d91de, (opens new window) - Updates the documentation to show how to use AvatarGroup with non-circular Avatars. Be aware the "more" indicator does not take multiple appearances.
  • Updated dependencies

12.3.0

Minor Changes

  • e314c4cb133f7, (opens new window) - [ux] Updates avatar and avatar group styles to reflect our new visual design language. These changes were previously behind a feature flag and are now fully rolled out.

Patch Changes

  • Updated dependencies

12.2.10

Patch Changes

12.2.9

Patch Changes

12.2.8

Patch Changes

12.2.7

Patch Changes

  • Updated dependencies

12.2.6

Patch Changes

12.2.5

Patch Changes

  • Updated dependencies

12.2.4

Patch Changes

12.2.3

Patch Changes

12.2.2

Patch Changes

  • Updated dependencies

12.2.1

Patch Changes

12.2.0

Minor Changes

12.1.4

Patch Changes

  • Updated dependencies

12.1.3

Patch Changes

12.1.2

Patch Changes

  • Updated dependencies

12.1.1

Patch Changes

  • Updated dependencies

12.1.0

Minor Changes

12.0.15

Patch Changes

  • Updated dependencies

12.0.14

Patch Changes

  • Updated dependencies

12.0.13

Patch Changes

  • Updated dependencies

12.0.12

Patch Changes

  • Updated dependencies

12.0.11

Patch Changes

  • Updated dependencies

12.0.10

Patch Changes

  • Updated dependencies

12.0.9

Patch Changes

  • Updated dependencies

12.0.8

Patch Changes

  • Updated dependencies

12.0.7

Patch Changes

  • Updated dependencies

12.0.6

Patch Changes

  • Updated dependencies

12.0.5

Patch Changes

12.0.4

Patch Changes

  • Updated dependencies

12.0.3

Patch Changes

  • Updated dependencies

12.0.2

Patch Changes

  • Updated dependencies

12.0.1

Patch Changes

  • Updated dependencies

12.0.0

Major Changes

Patch Changes

  • Updated dependencies

11.2.0

Minor Changes

Patch Changes

  • Updated dependencies

11.1.4

Patch Changes

11.1.3

Patch Changes

  • Updated dependencies

11.1.2

Patch Changes

  • Updated dependencies

11.1.1

Patch Changes

  • Updated dependencies

11.1.0

Minor Changes

Patch Changes

  • Updated dependencies

11.0.0

Major Changes

  • #104933, (opens new window) 8a592509504c7, (opens new window) - Migrated from @emotion/react to @compiled/react in order to improve performance, align with the rest of the Atlaskit techstack, and support React 18 Streaming SSR.

    Please note, in order to use this version of @atlaskit/avatar-group, you will need to ensure that your bundler is configured to handle .css imports correctly. Most bundlers come with built-in support for .css imports, so you may not need to do anything. If you are using a different bundler, please refer to the documentation for that bundler to understand how to handle .css imports.

    For more information on the migration, please refer to RFC-73 Migrating our components to Compiled CSS-in-JS, (opens new window).

10.1.5

Patch Changes

10.1.4

Patch Changes

10.1.3

Patch Changes

  • Updated dependencies

10.1.2

Patch Changes

10.1.1

Patch Changes

  • Updated dependencies

10.1.0

Minor Changes

10.0.4

Patch Changes

10.0.3

Patch Changes

10.0.2

Patch Changes

10.0.1

Patch Changes

  • Updated dependencies

10.0.0

Major Changes

  • 8aee79daf4012, (opens new window) - Removed xsmall size option for AvatarGroup since it is too small to display elements like the more indicator in an accessible way. Use the small size instead. The standalone Avatar component will continue to support the xsmall size.

9.11.5

Patch Changes

  • Updated dependencies

9.11.4

Patch Changes

  • Updated dependencies

9.11.3

Patch Changes

9.11.2

Patch Changes

9.11.1

Patch Changes

  • Updated dependencies

9.11.0

Minor Changes

  • #127511, (opens new window) db30e29344013, (opens new window) - Widening range of react and react-dom peer dependencies from ^16.8.0 || ^17.0.0 || ~18.2.0 to the wider range of ``^16.8.0 || ^17.0.0 || ^18.0.0` (where applicable).

    This change has been done to enable usage of react@18.3 as well as to have a consistent peer dependency range for react and react-dom for /platform packages.

Patch Changes

  • Updated dependencies

9.10.0

Minor Changes

Patch Changes

  • Updated dependencies

9.9.1

Patch Changes

9.9.0

Minor Changes

Patch Changes

  • Updated dependencies

9.8.0

Minor Changes

9.7.0

Minor Changes

Patch Changes

  • Updated dependencies

9.6.1

Patch Changes

9.6.0

Minor Changes

Patch Changes

  • Updated dependencies

9.5.4

Patch Changes

9.5.3

Patch Changes

9.5.2

Patch Changes

9.5.1

Patch Changes

9.5.0

Minor Changes

9.4.6

Patch Changes

  • Updated dependencies

9.4.5

Patch Changes

9.4.4

Patch Changes

  • Updated dependencies

9.4.3

Patch Changes

9.4.2

Patch Changes

9.4.1

Patch Changes

9.4.0

Minor Changes

9.3.6

Patch Changes

9.3.5

Patch Changes

9.3.4

Patch Changes

9.3.3

Patch Changes

9.3.2

Patch Changes

9.3.1

Patch Changes

9.3.0

Minor Changes

Patch Changes

  • Updated dependencies

9.2.4

Patch Changes

9.2.3

Patch Changes

  • Updated dependencies

9.2.2

Patch Changes

9.2.1

Patch Changes

9.2.0

Minor Changes

9.1.4

Patch Changes

  • Updated dependencies

9.1.3

Patch Changes

  • Updated dependencies

9.1.2

Patch Changes

  • Updated dependencies

9.1.1

Patch Changes

9.1.0

Minor Changes

Patch Changes

  • Updated dependencies

9.0.4

Patch Changes

9.0.3

Patch Changes

9.0.2

Patch Changes

9.0.1

Patch Changes

9.0.0

Major Changes

  • #21570, (opens new window) 92bb02bc46b, (opens new window) - [ux] There are no code changes required to consume this major, but you should be aware that internal changes have been made to how @atlaskit/avatar loads images.

    Before, the image loading behaviour was written in JS. Now, it leans on a standard HTML img tag if you provide a src prop, allowing it to rely on the browser to optimise the loading. These changes should result in faster image loading and an improved server-side rendering story.

    In this version, the breaking change is that you will no longer see a fallback icon while the image is loading. We have intentionally removed this loading behaviour as it is no longer consistent with our native img behaviour-first approach, and was a source of SSR bugs. Avatar images will load either instantly from the cache, or very fast from a CDN. In the edge cases where there is an error with the image src provided, we will still fall back to a default icon.

Patch Changes

8.5.15

Patch Changes

8.5.14

Patch Changes

  • Updated dependencies

8.5.13

Patch Changes

8.5.12

Patch Changes

  • Updated dependencies

8.5.11

Patch Changes

8.5.10

Patch Changes

  • Updated dependencies

8.5.9

Patch Changes

8.5.8

Patch Changes

  • 19d72473dfb, (opens new window) - Updates usage of deprecated token names so they're aligned with the latest naming conventions. No UI or visual changes
  • Updated dependencies

8.5.7

Patch Changes

  • Updated dependencies

8.5.6

Patch Changes

8.5.5

Patch Changes

8.5.4

Patch Changes

8.5.3

Patch Changes

8.5.2

Patch Changes

  • Updated dependencies

8.5.1

Patch Changes

  • Updated dependencies

8.5.0

Minor Changes

Patch Changes

  • Updated dependencies

8.4.0

Minor Changes

Patch Changes

8.3.2

Patch Changes

8.3.1

Patch Changes

8.3.0

Minor Changes

  • #12328, (opens new window) 5ba523fc937, (opens new window) - Now the AvatarGroup is marked with ul and li elements. This makes it easier for users with assistive technologies to distinguish AvatarGroup ( which is a list of avatars ) among other page components. The default label that the screen reader announces when a user selects the AvatarGroup is list avatar group x items. When one of AvatarGroupItems is selected screen reader announcement is [avatar label], i of n where i - index of a selected item, n - the length of the list.

    To change the label of a list you can use label props.

Patch Changes

8.2.0

Minor Changes

Patch Changes

  • Updated dependencies

8.1.1

Patch Changes

  • Updated dependencies

8.1.0

Minor Changes

Patch Changes

  • Updated dependencies

8.0.15

Patch Changes

8.0.14

Patch Changes

8.0.13

Patch Changes

  • Updated dependencies

8.0.12

Patch Changes

8.0.11

Patch Changes

8.0.10

Patch Changes

8.0.9

Patch Changes

  • Updated dependencies

8.0.8

Patch Changes

8.0.7

Patch Changes

  • Updated dependencies

8.0.6

Patch Changes

8.0.5

Patch Changes

8.0.4

Patch Changes

8.0.3

Patch Changes

  • Updated dependencies

8.0.2

Patch Changes

8.0.1

Patch Changes

8.0.0

Major Changes

  • #3428, (opens new window) cde426961a, (opens new window) - AvatarGroup has been migrated to lite-mode. Users should see performance improvements and reduced bundlesize.

    Change summary:

    • name is now a required property of the data attribute. This was previously not required simply because we forwarded avatars props. Names should always be supplied so that avatars can be differentiated in a meaningful way (although they are not required to be unique).
    • new prop isTooltipDisabled has been provided to allow users to disable tooltips
    • AvatarGroup now uses @emotion

    Misc.

    • Fixed broken margin styling bug with stack groups
    • Replaced dropdown-menu with a lighter and more performant popup component
    • Removed custom dropdown-menu styling
    • Removed all HOC usage
    • More indicator is now just a stylized Avatar rather than a complete style re-implementation of Avatar

Patch Changes

7.0.1

Patch Changes

7.0.0

Major Changes

Patch Changes

  • Updated dependencies

6.0.3

Patch Changes

6.0.2

Patch Changes

6.0.1

Patch Changes

6.0.0

Major Changes

  • #2137, (opens new window) a7ca7039c7, (opens new window) - AvatarGroup previously depended heavily on Avatar internals such as styles, getProps and withPseudoState. These have been moved directly into AvatarGroup to finally decouple the two components. We will revisit this when we convert AvatarGroup to lite-mode and most likely remove them entirely.

    Previously, it was possible to pass arbritray props to the underlying Avatar via the data prop. This is no longer supported. Please pass props directly to the custom avatar / presence / status components.

Patch Changes

  • Updated dependencies

5.1.2

Patch Changes

5.1.1

Patch Changes

5.1.0

Minor Changes

Patch Changes

5.0.4

Patch Changes

  • [patch]6548261c9a, (opens new window):

    Remove namespace imports from React, ReactDom, and PropTypes- Updated dependencies 6548261c9a, (opens new window):

    • @atlaskit/docs@8.3.2
    • @atlaskit/visual-regression@0.1.9
    • @atlaskit/avatar@17.1.7
    • @atlaskit/button@13.3.7
    • @atlaskit/code@11.1.3
    • @atlaskit/dropdown-menu@8.2.4
    • @atlaskit/field-base@14.0.1
    • @atlaskit/icon@20.0.1
    • @atlaskit/item@11.0.1
    • @atlaskit/theme@9.5.1
    • @atlaskit/toggle@8.1.4

5.0.3

Patch Changes

5.0.2

Patch Changes

5.0.1

Patch Changes

5.0.0

Major Changes

  • [major]40bda8f796, (opens new window):

    @atlaskit/avatar-group has been converted to Typescript. Typescript consumers will now get static type safety. Flow types are no longer provided. No API or behavioural changes.

4.0.13

4.0.12

Patch Changes

  • [patch]097b696613, (opens new window):

    Components now depend on TS 3.6 internally, in order to fix an issue with TS resolving non-relative imports as relative imports

4.0.11

Patch Changes

4.0.10

Patch Changes

4.0.9

Patch Changes

4.0.8

Patch Changes

4.0.7

4.0.6

  • Updated dependencies 06326ef3f7, (opens new window):
    • @atlaskit/docs@8.1.3
    • @atlaskit/avatar@16.0.6
    • @atlaskit/button@13.0.9
    • @atlaskit/dropdown-menu@8.0.8
    • @atlaskit/field-base@13.0.6
    • @atlaskit/item@10.0.5
    • @atlaskit/toggle@7.0.3
    • @atlaskit/tooltip@15.0.2
    • @atlaskit/icon@19.0.0

4.0.5

Patch Changes

4.0.4

  • Updated dependencies 67f06f58dd, (opens new window):
    • @atlaskit/avatar@16.0.4
    • @atlaskit/dropdown-menu@8.0.5
    • @atlaskit/icon@18.0.1
    • @atlaskit/item@10.0.3
    • @atlaskit/tooltip@15.0.0

4.0.3

  • Updated dependencies cfc3c8adb3, (opens new window):
    • @atlaskit/docs@8.1.2
    • @atlaskit/avatar@16.0.3
    • @atlaskit/button@13.0.8
    • @atlaskit/dropdown-menu@8.0.4
    • @atlaskit/field-base@13.0.4
    • @atlaskit/item@10.0.2
    • @atlaskit/toggle@7.0.1
    • @atlaskit/tooltip@14.0.3
    • @atlaskit/icon@18.0.0

4.0.2

4.0.1

4.0.0

  • [major]7c17b35107, (opens new window):
    • Updates react and react-dom peer dependencies to react@^16.8.0 and react-dom@^16.8.0. To use this package, please ensure you use at least this version of react and react-dom.

3.0.4

  • Updated dependencies 9c0b4744be, (opens new window):
    • @atlaskit/docs@7.0.3
    • @atlaskit/avatar@15.0.4
    • @atlaskit/button@12.0.3
    • @atlaskit/code@9.0.1
    • @atlaskit/dropdown-menu@7.0.6
    • @atlaskit/field-base@12.0.2
    • @atlaskit/icon@16.0.9
    • @atlaskit/item@9.0.1
    • @atlaskit/toggle@6.0.4
    • @atlaskit/tooltip@13.0.4
    • @atlaskit/theme@8.1.7

3.0.3

  • Updated dependencies 1e826b2966, (opens new window):
    • @atlaskit/docs@7.0.2
    • @atlaskit/avatar@15.0.3
    • @atlaskit/dropdown-menu@7.0.4
    • @atlaskit/icon@16.0.8
    • @atlaskit/theme@8.1.6
    • @atlaskit/toggle@6.0.3
    • @atlaskit/tooltip@13.0.3
    • @atlaskit/button@12.0.0

3.0.2

  • [patch]ea173a3ee2, (opens new window):
    • Internal changes only. Component is now SSR compatible. If server side rendered, Avatar Images will begin to load immediately; before client bundle is ready. If this is undesired, imageUrl can be passed in after component is mounted.

3.0.1

  • Updated dependencies 9d5cc39394, (opens new window):
    • @atlaskit/docs@7.0.1
    • @atlaskit/avatar@15.0.1
    • @atlaskit/dropdown-menu@7.0.1
    • @atlaskit/icon@16.0.5
    • @atlaskit/theme@8.0.1
    • @atlaskit/toggle@6.0.1
    • @atlaskit/tooltip@13.0.1
    • @atlaskit/button@11.0.0

3.0.0

  • [major]76299208e6, (opens new window):

    • Drop ES5 from all the flow modules

    Dropping CJS support in all @atlaskit packages

    As a breaking change, all @atlaskit packages will be dropping cjs distributions and will only distribute esm. This means all distributed code will be transpiled, but will still contain import and export declarations.

    The major reason for doing this is to allow us to support multiple entry points in packages, e.g:

    import colors from `@atlaskit/theme/colors`;

    Previously this was sort of possible for consumers by doing something like:

    import colors from `@atlaskit/theme/dist/esm/colors`;

    This has a couple of issues. 1, it treats the file system as API making internal refactors harder, we have to worry about how consumers might be using things that aren't actually supposed to be used. 2. We are unable to do this internally in @atlaskit packages. This leads to lots of packages bundling all of theme, just to use a single color, especially in situations where tree shaking fails.

    To support being able to use multiple entrypoints internally, we unfortunately cannot have multiple distributions as they would need to have very different imports from of their own internal dependencies.

    ES Modules are widely supported by all modern bundlers and can be worked around in node environments.

    We may choose to revisit this solution in the future if we find any unintended condequences, but we see this as a pretty sane path forward which should lead to some major bundle size decreases, saner API's and simpler package architecture.

    Please reach out to #fabric-build (if in Atlassian) or create an issue in Design System Support, (opens new window) (for external) if you have any questions or queries about this.

2.1.12

2.1.11

2.1.10

  • Updated dependencies d7ef59d432, (opens new window):
    • @atlaskit/docs@6.0.1
    • @atlaskit/avatar@14.1.8
    • @atlaskit/button@10.1.2
    • @atlaskit/dropdown-menu@6.1.26
    • @atlaskit/field-base@11.0.14
    • @atlaskit/item@8.0.15
    • @atlaskit/toggle@5.0.15
    • @atlaskit/tooltip@12.1.15
    • @atlaskit/icon@16.0.0

2.1.9

  • Updated dependencies 58b84fa, (opens new window):
    • @atlaskit/avatar@14.1.7
    • @atlaskit/button@10.1.1
    • @atlaskit/code@8.2.2
    • @atlaskit/dropdown-menu@6.1.25
    • @atlaskit/field-base@11.0.13
    • @atlaskit/icon@15.0.2
    • @atlaskit/item@8.0.14
    • @atlaskit/theme@7.0.1
    • @atlaskit/toggle@5.0.14
    • @atlaskit/tooltip@12.1.13
    • @atlaskit/docs@6.0.0

2.1.8

  • Updated dependencies d13242d, (opens new window):
    • @atlaskit/docs@5.2.3
    • @atlaskit/button@10.0.4
    • @atlaskit/code@8.2.1
    • @atlaskit/dropdown-menu@6.1.24
    • @atlaskit/field-base@11.0.12
    • @atlaskit/icon@15.0.1
    • @atlaskit/item@8.0.13
    • @atlaskit/toggle@5.0.13
    • @atlaskit/tooltip@12.1.12
    • @atlaskit/theme@7.0.0
    • @atlaskit/avatar@14.1.6

2.1.7

  • Updated dependencies ab9b69c, (opens new window):
    • @atlaskit/docs@5.2.2
    • @atlaskit/avatar@14.1.5
    • @atlaskit/button@10.0.1
    • @atlaskit/dropdown-menu@6.1.23
    • @atlaskit/field-base@11.0.11
    • @atlaskit/item@8.0.12
    • @atlaskit/toggle@5.0.12
    • @atlaskit/tooltip@12.1.11
    • @atlaskit/icon@15.0.0

2.1.6

  • Updated dependencies 6998f11, (opens new window):
    • @atlaskit/docs@5.2.1
    • @atlaskit/avatar@14.1.4
    • @atlaskit/dropdown-menu@6.1.22
    • @atlaskit/icon@14.6.1
    • @atlaskit/theme@6.2.1
    • @atlaskit/toggle@5.0.11
    • @atlaskit/tooltip@12.1.10
    • @atlaskit/button@10.0.0

2.1.5

2.1.4

2.1.3

  • [patch] Updated dependencies 65c6514, (opens new window)
    • @atlaskit/docs@5.0.8
    • @atlaskit/avatar@14.0.11
    • @atlaskit/button@9.0.13
    • @atlaskit/dropdown-menu@6.1.17
    • @atlaskit/field-base@11.0.8
    • @atlaskit/item@8.0.8
    • @atlaskit/toggle@5.0.9
    • @atlaskit/tooltip@12.1.1
    • @atlaskit/icon@14.0.0

2.1.1

  • [patch] Updated dependencies df22ad8, (opens new window)
    • @atlaskit/theme@6.0.0
    • @atlaskit/tooltip@12.0.9
    • @atlaskit/toggle@5.0.6
    • @atlaskit/item@8.0.5
    • @atlaskit/icon@13.2.5
    • @atlaskit/field-base@11.0.5
    • @atlaskit/dropdown-menu@6.1.8
    • @atlaskit/code@8.0.1
    • @atlaskit/button@9.0.6
    • @atlaskit/avatar@14.0.8
    • @atlaskit/docs@5.0.6

2.1.0

2.0.8

2.0.7

2.0.6

2.0.5

2.0.4

  • [patch] Updated dependencies acd86a1, (opens new window)
    • @atlaskit/tooltip@12.0.4
    • @atlaskit/item@8.0.3
    • @atlaskit/icon@13.2.2
    • @atlaskit/toggle@5.0.4
    • @atlaskit/button@9.0.4
    • @atlaskit/theme@5.1.2
    • @atlaskit/code@7.0.2
    • @atlaskit/docs@5.0.2
    • @atlaskit/dropdown-menu@6.1.4
    • @atlaskit/avatar@14.0.5
    • @atlaskit/field-base@11.0.2

2.0.3

  • [patch] Add a SSR test for every package, add react-dom and build-utils in devDependencies 7e331b5, (opens new window)
  • [none] Updated dependencies 7e331b5, (opens new window)
    • @atlaskit/tooltip@12.0.3
    • @atlaskit/field-base@11.0.1
    • @atlaskit/toggle@5.0.3
    • @atlaskit/button@9.0.3
    • @atlaskit/theme@5.1.1
    • @atlaskit/code@7.0.1
    • @atlaskit/item@8.0.2
    • @atlaskit/icon@13.2.1
    • @atlaskit/dropdown-menu@6.1.3
    • @atlaskit/avatar@14.0.4

2.0.2

2.0.1

  • [patch] Updated dependencies e6b1985, (opens new window)
    • @atlaskit/tooltip@12.0.0
    • @atlaskit/item@8.0.1
    • @atlaskit/icon@13.1.1
    • @atlaskit/dropdown-menu@6.1.1
    • @atlaskit/avatar@14.0.1

2.0.0

  • [major] Updates to React ^16.4.0 7edb866, (opens new window)
  • [major] Updated dependencies 7edb866, (opens new window)
    • @atlaskit/tooltip@11.0.0
    • @atlaskit/field-base@11.0.0
    • @atlaskit/toggle@5.0.0
    • @atlaskit/button@9.0.0
    • @atlaskit/theme@5.0.0
    • @atlaskit/code@7.0.0
    • @atlaskit/docs@5.0.0
    • @atlaskit/item@8.0.0
    • @atlaskit/icon@13.0.0
    • @atlaskit/dropdown-menu@6.0.0
    • @atlaskit/avatar@14.0.0

1.0.2

1.0.1

1.0.0

Was this page helpful?
We use this feedback to improve our documentation.
© 2026 AtlassianTrademark, (opens new window)Privacy, (opens new window)License