Garden 9 is now available.
The website has been updated to the latest major version. View previous versions
Skip to main content
Design
Components
Patterns
    • Introduction
      • Overview
    • Foundations
      • Bedrock CSS
      • Design tokens
      • Containers
      • Theming
      • Versions
    • Components
      • Accordion
      • Anchor
      • Avatar
      • Breadcrumbs
      • Buttons
      • Chrome
      • Code block
      • Color picker
      • Color swatch
      • Date picker
      • Draggable
      • Drawer
      • Forms
      • Grid
      • Loaders
      • Menu
      • Modal
      • Notification
      • Pagination
      • Pane
      • Sheet
      • Status indicator
      • Stepper
      • Table
      • Tabs
      • Tags
      • Tiles
      • Timeline
      • Tooltip
      • Tooltip dialog
      • Typography
      • Well
    Table of Contents
    • How to use it
      • Default
      • Disabled
      • Orientation
    • Configuration
    • API
      • Tabs
      • Tabs.Tab

    Tabs

    Use Tabs to organize related content in a single view. This helps users navigate related content without having to switch contexts.


    Table of Contents
    • How to use it
      • Default
      • Disabled
      • Orientation
    • Configuration
    • API
      • Tabs
      • Tabs.Tab

    Used for this
    • To filter information into easily parsable views
    • To organize related content and controls within a single page
    Not for this
    • To guide users through a task list, use a Stepper instead
    • As a secondary navigation bar that spans multiple pages. Use Anchors instead.

    How to use it

    Default

    The typical usage of a Tab component.

    Toggle dark mode
    Set primary hue
    Toggle RTL
    Open in CodeSandbox
    Copy code
    View code

    Disabled

    Individual tabs can be disabled to prevent users from interacting with them.

    Toggle dark mode
    Set primary hue
    Toggle RTL
    Open in CodeSandbox
    Copy code
    View code

    Orientation

    Tab layout is horizontal by default and can also stack vertically.

    Toggle dark mode
    Set primary hue
    Toggle RTL
    Open in CodeSandbox
    Copy code
    View code

    Configuration

    • Name9.5.3•View source•View on npm
    • Installnpm install @zendeskgarden/react-tabs
    • Depsnpm install react react-dom styled-components @zendeskgarden/react-theming
    • Importimport { Tabs } from '@zendeskgarden/react-tabs'

    API

    Tabs

    Prop nameTypeDefaultDescription
    isVertical
    boolean
    false

    Arranges the tabs vertically

    onChange
    ((selectedItem: any) => void)

    Handles tab selection

    Parameters
    selectedItem

    The selected tab's item value

    selectedItem
    any

    Specifies the currently selected tab

    Tabs.Tab

    Extends HTMLAttributes<HTMLDivElement>

    Prop nameTypeDefaultDescription
    disabled
    boolean

    Indicates that the element is not interactive

    item
    any

    Defines a unique value to identify the tab. Provided to the onChange event in the Tabs component.

    Tabs.TabList

    Extends HTMLAttributes<HTMLDivElement>

    Tabs.TabPanel

    Extends HTMLAttributes<HTMLDivElement>

    Prop nameTypeDefaultDescription
    item
    any

    Defines a value used to match a tab panel with its associated tab

    Garden is the design system by Zendesk.
    BlogGitHubVersions
    © Zendesk 2025