Top nav items
Buttons and elements for the top nav.Props
AppSwitcher
The trigger button for the app switcher. Use the optional icon prop to replace the default app
switcher icon with a custom visual, such as a product logo.
| Description | Identifies the popup element that the trigger controls.
Should match the |
|---|---|
| Type | string |
| Description | Announces to assistive technology whether the popup is currently open or closed. |
|---|---|
| Type | boolean |
| Description | Informs assistive technology that this element triggers a popup.
With |
|---|---|
| Type | boolean | "dialog" | "menu" | "listbox" | "tree" | "grid" |
| Description | Allows a custom visual to be used instead of the Atlassian AppSwitcher icon. Defaults to the Atlassian app switcher icon. |
|---|---|
| Type | ComponentClass<(Omit<IconProps, "size"> | Omit<NewIconProps, "size" | "spacing">) & { motionOvershoot?: string; }, any> | FunctionComponent<...> |
| Description | An optional name used to identify events for React UFO (Unified Frontend Observability) press interactions. For more information, see React UFO integration into Design System components. |
|---|---|
| Type | string |
| Description | Indicates that the button is selected. |
|---|---|
| Type | boolean |
| Description | Provide an accessible label, often used by screen readers. |
|---|---|
| Type | string | number | boolean | ReactElement<any, string | JSXElementConstructor<any>> | Iterable<ReactNode> | ReactPortal |
| Description | Handler called on click. |
|---|---|
| Type | (event: MouseEvent<HTMLButtonElement, globalThis.MouseEvent>) => void |
| Description | Called when the mouse enters the element container. Allows preloading popup components |
|---|---|
| Type | (event: MouseEvent<HTMLButtonElement, globalThis.MouseEvent>) => void |
| Description | Allows getting a ref to the component instance.
Once the component unmounts, React will set @see {@link https://react.dev/learn/referencing-values-with-refs#refs-and-the-dom React Docs} |
|---|---|
| Type | string | Ref<HTMLButtonElement> |
| Description | A |
|---|---|
| Type | string |
AppLogo
The app logo for the top navigation, when an app logo from @atlaskit/logo is used. Use the
optional secondaryName prop to display supporting context below the app name in wider viewports.
| Description | The URL to navigate to when the element is clicked. |
|---|---|
| Type | string |
| Description | The icon to render. |
|---|---|
| Type | (props: BaseLogoProps) => JSX.Element |
| Description | Provide an accessible label, often used by screen readers. This label should include the name of the app, and if applicable, the location the user will navigate to on click. |
|---|---|
| Type | string |
| Description | The name of the app. Will be displayed next to the logo in wider viewports. |
|---|---|
| Type | string |
| Description | Handler called on click. |
|---|---|
| Type | (event: React.MouseEvent<HTMLAnchorElement, MouseEvent>) => void |
| Description | Provide a secondaryName for the app. Will be displayed below the name in wider viewports. |
|---|---|
| Type | string |
CustomLogo
The logo for the top navigation, when a custom icon and logo component are used.
| Description | The URL to navigate to when the element is clicked. |
|---|---|
| Type | string |
| Description | The icon component to render. It will be used for small viewports. |
|---|---|
| Type | (props: BaseLogoProps) => JSX.Element |
| Description | Provide an accessible label, often used by screen readers. |
|---|---|
| Type | string |
| Description | The logo component to render. It will be used for large viewports. |
|---|---|
| Type | (props: BaseLogoProps) => JSX.Element |
| Description | Handler called on click. |
|---|---|
| Type | (event: React.MouseEvent<HTMLAnchorElement, MouseEvent>) => void |
Search
Note: Instead of using this component directly, you may want to use the search component from
@atlassian/search-page/quick-find instead.
| Description | No description. |
|---|---|
| Type | boolean | "dialog" | "menu" | "listbox" | "tree" | "grid" | "true" | "false" |
| Description | The component to render after the search input. |
|---|---|
| Type | string | number | boolean | React.ReactElement<any, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |
| Description | The icon component to render before the search input. |
|---|---|
| Type | React.ComponentClass<NewIconProps & { spacing: "spacious"; }, any> | React.FunctionComponent<NewIconProps & { spacing: "spacious"; }> |
| Description | An optional name used to identify events for React UFO (Unified Frontend Observability) press interactions. For more information, see React UFO integration into Design System components. |
|---|---|
| Type | string |
| Description | Provide an accessible label, often used by screen readers. |
|---|---|
| Type | string | number | boolean | React.ReactElement<any, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |
| Description | Handler called on click. |
|---|---|
| Type | (event: React.MouseEvent<HTMLButtonElement, MouseEvent>) => void |
Note: Instead of using this button directly, you may want to use the create button from
@atlassian/universal-create instead.
| Description | The content of the button. |
|---|---|
| Type | string | number | boolean | ReactElement<any, string | JSXElementConstructor<any>> | Iterable<ReactNode> | ReactPortal |
| Description | An optional name used to identify events for React UFO (Unified Frontend Observability) press interactions. For more information, see React UFO integration into Design System components. |
|---|---|
| Type | string |
| Description | Handler called on click. You can use the second argument to fire Atlaskit analytics events on custom channels. They could then be routed to GASv3 analytics. See the pressable or anchor primitive code examples for information on firing Atlaskit analytics events or routing these to GASv3 analytics. |
|---|---|
| Type | (e: MouseEvent<HTMLElement, globalThis.MouseEvent>, analyticsEvent: UIAnalyticsEvent) => void |
| Description | Allows getting a ref to the component instance.
Once the component unmounts, React will set @see {@link https://react.dev/learn/referencing-values-with-refs#refs-and-the-dom React Docs} |
|---|---|
| Type | string | Ref<HTMLButtonElement> |
| Description | A unique string that appears as data attribute |
|---|---|
| Type | string |
Instead of using this button directly, you may want to use the chat button from
@atlassian/conversation-assistant-ui-components instead.
| Description | Text content to be rendered in the button. |
|---|---|
| Type | string | number | boolean | React.ReactElement<any, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | React.ReactPortal |
| Description | An optional name used to identify events for React UFO (Unified Frontend Observability) press interactions. For more information, see React UFO integration into Design System components. |
|---|---|
| Type | string |
| Description | Indicates that the button is selected. |
|---|---|
| Type | boolean |
| Description | Handler called on click. |
|---|---|
| Type | (event: React.MouseEvent<HTMLButtonElement, MouseEvent>) => void |
Notifications
The trigger button for the notifications menu.
| Description | Identifies the popup element that the trigger controls.
Should match the |
|---|---|
| Type | string |
| Description | Announces to assistive technology whether the popup is currently open or closed. |
|---|---|
| Type | boolean |
| Description | Informs assistive technology that this element triggers a popup.
With |
|---|---|
| Type | boolean | "dialog" | "menu" | "listbox" | "tree" | "grid" |
| Description | The component to render as the badge.
You are recommended to use the Badge component from |
|---|---|
| Type | ComponentClass<{}, any> | FunctionComponent<{}> |
| Description | An optional name used to identify events for React UFO (Unified Frontend Observability) press interactions. For more information, see React UFO integration into Design System components. |
|---|---|
| Type | string |
| Description | Can be used to disable the default This is intended for when the item is a popup trigger,
and requires you to render your own @example |
|---|---|
| Default | true |
| Type | boolean |
| Description | Indicates that the button is selected. |
|---|---|
| Type | boolean |
| Description | Provide an accessible label, often used by screen readers. |
|---|---|
| Type | string | number | boolean | ReactElement<any, string | JSXElementConstructor<any>> | Iterable<ReactNode> | ReactPortal |
| Description | Handler called on click. You can use the second argument to fire Atlaskit analytics events on custom channels. They could then be routed to GASv3 analytics. See the pressable or anchor primitive code examples for information on firing Atlaskit analytics events or routing these to GASv3 analytics. |
|---|---|
| Type | (e: MouseEvent<HTMLElement, globalThis.MouseEvent>, analyticsEvent: UIAnalyticsEvent) => void |
| Description | Called when the mouse enters the element container. Allows preloading popup components |
|---|---|
| Type | (event: MouseEvent<HTMLButtonElement, globalThis.MouseEvent>) => void |
| Description | Allows getting a ref to the component instance.
Once the component unmounts, React will set @see {@link https://react.dev/learn/referencing-values-with-refs#refs-and-the-dom React Docs} |
|---|---|
| Type | string | Ref<HTMLButtonElement> |
| Description | Display a keyboard shortcut in the tooltip. Keys will be displayed as individual keyboard key segments after the tooltip content. |
|---|---|
| Type | string[] |
| Description | A unique string that appears as data attribute |
|---|---|
| Type | string |
Help
The trigger button for the help menu.
| Description | The component to render as the badge.
You are recommended to use the Badge component from |
|---|---|
| Type | ComponentClass<{}, any> | FunctionComponent<{}> |
| Description | An optional name used to identify events for React UFO (Unified Frontend Observability) press interactions. For more information, see React UFO integration into Design System components. |
|---|---|
| Type | string |
| Description | Can be used to disable the default This is intended for when the item is a popup trigger,
and requires you to render your own @example |
|---|---|
| Default | true |
| Type | boolean |
| Description | Indicates that the button is selected. |
|---|---|
| Type | boolean |
| Description | Provide an accessible label, often used by screen readers. |
|---|---|
| Type | string | number | boolean | ReactElement<any, string | JSXElementConstructor<any>> | Iterable<ReactNode> | ReactPortal |
| Description | Handler called on click. You can use the second argument to fire Atlaskit analytics events on custom channels. They could then be routed to GASv3 analytics. See the pressable or anchor primitive code examples for information on firing Atlaskit analytics events or routing these to GASv3 analytics. |
|---|---|
| Type | (e: MouseEvent<HTMLElement, globalThis.MouseEvent>, analyticsEvent: UIAnalyticsEvent) => void |
| Description | Called when the mouse enters the element container. Allows preloading popup components |
|---|---|
| Type | (event: MouseEvent<HTMLButtonElement, globalThis.MouseEvent>) => void |
| Description | Allows getting a ref to the component instance.
Once the component unmounts, React will set @see {@link https://react.dev/learn/referencing-values-with-refs#refs-and-the-dom React Docs} |
|---|---|
| Type | string | Ref<HTMLButtonElement> |
| Description | Display a keyboard shortcut in the tooltip. Keys will be displayed as individual keyboard key segments after the tooltip content. |
|---|---|
| Type | string[] |
| Description | A unique string that appears as data attribute |
|---|---|
| Type | string |
Settings
The trigger button for the settings menu.
| Description | Identifies the popup element that the trigger controls.
Should match the |
|---|---|
| Type | string |
| Description | Announces to assistive technology whether the popup is currently open or closed. |
|---|---|
| Type | boolean |
| Description | Informs assistive technology that this element triggers a popup.
With |
|---|---|
| Type | boolean | "dialog" | "menu" | "listbox" | "tree" | "grid" |
| Description | An optional name used to identify events for React UFO (Unified Frontend Observability) press interactions. For more information, see React UFO integration into Design System components. |
|---|---|
| Type | string |
| Description | Can be used to disable the default This is intended for when the item is a popup trigger,
and requires you to render your own @example |
|---|---|
| Default | true |
| Type | boolean |
| Description | Indicates that the button is selected. |
|---|---|
| Type | boolean |
| Description | Provide an accessible label, often used by screen readers. |
|---|---|
| Type | string | number | boolean | ReactElement<any, string | JSXElementConstructor<any>> | Iterable<ReactNode> | ReactPortal |
| Description | Handler called on click. You can use the second argument to fire Atlaskit analytics events on custom channels. They could then be routed to GASv3 analytics. See the pressable or anchor primitive code examples for information on firing Atlaskit analytics events or routing these to GASv3 analytics. |
|---|---|
| Type | (e: MouseEvent<HTMLElement, globalThis.MouseEvent>, analyticsEvent: UIAnalyticsEvent) => void |
| Description | Called when the mouse enters the element container. Allows preloading popup components |
|---|---|
| Type | (event: MouseEvent<HTMLButtonElement, globalThis.MouseEvent>) => void |
| Description | Allows getting a ref to the component instance.
Once the component unmounts, React will set @see {@link https://react.dev/learn/referencing-values-with-refs#refs-and-the-dom React Docs} |
|---|---|
| Type | string | Ref<HTMLButtonElement> |
| Description | Display a keyboard shortcut in the tooltip. Keys will be displayed as individual keyboard key segments after the tooltip content. |
|---|---|
| Type | string[] |
| Description | A unique string that appears as data attribute |
|---|---|
| Type | string |
Profile
The trigger button for the profile menu.
Note: Instead of using this button directly, you may want to use @atlassian/account/nav4 instead.
| Description | Identifies the popup element that the trigger controls.
Should match the |
|---|---|
| Type | string |
| Description | Announces to assistive technology whether the popup is currently open or closed. |
|---|---|
| Type | boolean |
| Description | Informs assistive technology that this element triggers a popup.
With |
|---|---|
| Type | boolean | "dialog" | "menu" | "listbox" | "tree" | "grid" |
| Description | An optional name used to identify events for React UFO (Unified Frontend Observability) press interactions. For more information, see React UFO integration into Design System components. |
|---|---|
| Type | string |
| Description | Can be used to disable the default This is intended for when the item is a popup trigger,
and requires you to render your own @example |
|---|---|
| Default | true |
| Type | boolean |
| Description | Indicates that the button is selected. |
|---|---|
| Type | boolean |
| Description | Provide an accessible label, often used by screen readers. |
|---|---|
| Type | string | number | boolean | ReactElement<any, string | JSXElementConstructor<any>> | Iterable<ReactNode> | ReactPortal |
| Description | Handler called on click. You can use the second argument to fire Atlaskit analytics events on custom channels. They could then be routed to GASv3 analytics. See the pressable or anchor primitive code examples for information on firing Atlaskit analytics events or routing these to GASv3 analytics. |
|---|---|
| Type | (e: MouseEvent<HTMLElement, globalThis.MouseEvent>, analyticsEvent: UIAnalyticsEvent) => void |
| Description | Called when the mouse enters the element container. Allows preloading popup components |
|---|---|
| Type | (event: MouseEvent<HTMLButtonElement, globalThis.MouseEvent>) => void |
| Description | Allows getting a ref to the component instance.
Once the component unmounts, React will set @see {@link https://react.dev/learn/referencing-values-with-refs#refs-and-the-dom React Docs} |
|---|---|
| Type | string | Ref<HTMLButtonElement> |
| Description | Display a keyboard shortcut in the tooltip. Keys will be displayed as individual keyboard key segments after the tooltip content. |
|---|---|
| Type | string[] |
| Description | The URL of the image to display in the avatar. |
|---|---|
| Type | string |
| Description | A unique string that appears as data attribute |
|---|---|
| Type | string |
LogIn
Note: Instead of using this button directly, you may want to use @atlassian/account/nav4 instead.
| Description | Standard links can be provided as a string, which should be mapped to the underlying router link component. Alternatively, you can provide an object for advanced link configurations by supplying the expected object type to the generic. @example |
|---|---|
| Type | string |
| Description | An optional name used to identify events for React UFO (Unified Frontend Observability) press interactions. For more information, see React UFO integration into Design System components. |
|---|---|
| Type | string |
| Description | Provide an accessible label, often used by screen readers. |
|---|---|
| Type | string | number | boolean | ReactElement<any, string | JSXElementConstructor<any>> | Iterable<ReactNode> | ReactPortal |
| Description | Handler called on click. You can use the second argument to fire Atlaskit analytics events on custom channels. They could then be routed to GASv3 analytics. See the pressable or anchor primitive code examples for information on firing Atlaskit analytics events or routing these to GASv3 analytics. |
|---|---|
| Type | (e: MouseEvent<HTMLAnchorElement, globalThis.MouseEvent>, analyticsEvent: UIAnalyticsEvent) => void |
| Description | Called when the mouse enters the element container. Allows preloading popup components |
|---|---|
| Type | (event: MouseEvent<HTMLAnchorElement, globalThis.MouseEvent>) => void |
| Description | Allows getting a ref to the component instance.
Once the component unmounts, React will set @see {@link https://react.dev/learn/referencing-values-with-refs#refs-and-the-dom React Docs} |
|---|---|
| Type | string | Ref<HTMLAnchorElement> |
| Description | A unique string that appears as data attribute |
|---|---|
| Type | string |
EndItem
If none of the provided top nav items components are suitable, you can create your own using
EndItem.
| Description | Identifies the popup element that the trigger controls.
Should match the |
|---|---|
| Type | string |
| Description | Announces to assistive technology whether the popup is currently open or closed. |
|---|---|
| Type | boolean |
| Description | Informs assistive technology that this element triggers a popup.
With |
|---|---|
| Type | boolean | "dialog" | "menu" | "listbox" | "tree" | "grid" |
| Description | Places an icon within the button. |
|---|---|
| Type | ComponentClass<(Omit<IconProps, "size"> | Omit<NewIconProps, "size" | "spacing">) & { motionOvershoot?: string; }, any> | FunctionComponent<...> |
| Description | An optional name used to identify events for React UFO (Unified Frontend Observability) press interactions. For more information, see React UFO integration into Design System components. |
|---|---|
| Type | string |
| Description | Can be used to disable the default This is intended for when the item is a popup trigger,
and requires you to render your own @example |
|---|---|
| Default | true |
| Type | boolean |
| Description | Indicates that the button is selected. |
|---|---|
| Type | boolean |
| Description | Provide an accessible label, often used by screen readers. |
|---|---|
| Type | string | number | boolean | ReactElement<any, string | JSXElementConstructor<any>> | Iterable<ReactNode> | ReactPortal |
| Description | Handler called on click. You can use the second argument to fire Atlaskit analytics events on custom channels. They could then be routed to GASv3 analytics. See the pressable or anchor primitive code examples for information on firing Atlaskit analytics events or routing these to GASv3 analytics. |
|---|---|
| Type | (e: MouseEvent<HTMLElement, globalThis.MouseEvent>, analyticsEvent: UIAnalyticsEvent) => void |
| Description | Called when the mouse enters the element container. Allows preloading popup components |
|---|---|
| Type | (event: MouseEvent<HTMLButtonElement, globalThis.MouseEvent>) => void |
| Description | Allows getting a ref to the component instance.
Once the component unmounts, React will set @see {@link https://react.dev/learn/referencing-values-with-refs#refs-and-the-dom React Docs} |
|---|---|
| Type | string | Ref<HTMLButtonElement> |
| Description | Display a keyboard shortcut in the tooltip. Keys will be displayed as individual keyboard key segments after the tooltip content. |
|---|---|
| Type | string[] |
| Description | A unique string that appears as data attribute |
|---|---|
| Type | string |