---
title: Table
description: A structured layout for rows and columns of data.
---

## Preview

<ComponentPreview name="p-table-1" />

## Installation

<CodeTabs>

<TabsList>
  <TabsTab value="cli">CLI</TabsTab>
  <TabsTab value="manual">Manual</TabsTab>
</TabsList>
<TabsPanel value="cli">

```bash
npx @olyx/cli@latest add table
```

</TabsPanel>

<TabsPanel value="manual">

<Steps>

<Step>Copy and paste the following code into your project.</Step>

<ComponentSource name="table" title="components/ui/table.tsx" />

<Step>Update the import paths to match your project setup.</Step>

</Steps>

</TabsPanel>

</CodeTabs>

## Usage

```tsx
import {
  Table,
  TableBody,
  TableCaption,
  TableCell,
  TableFooter,
  TableHead,
  TableHeader,
  TableRow,
} from "@/components/ui/table"
```

```tsx
<Table>
  <TableCaption>Caption</TableCaption>
  <TableHeader>
    <TableRow>
      <TableHead>Header</TableHead>
      <TableHead>Header</TableHead>
    </TableRow>
  </TableHeader>
  <TableBody>
    <TableRow>
      <TableCell>Cell</TableCell>
      <TableCell>Cell</TableCell>
    </TableRow>
  </TableBody>
</Table>
```

## API Reference

### Table

The main table container, wrapped in a `ScrollArea` for horizontal overflow.

### TableHeader

Header section of the table containing column headers.

### TableBody

Body section of the table containing data rows.

### TableFooter

Footer section of the table.

### TableRow

A row in the table.

### TableHead

A header cell in the table.

### TableCell

A data cell in the table.

### TableCaption

A caption for the table, rendered at the bottom.

## Examples

### Responsive Table

<ComponentPreview name="p-table-2" />