> ## Documentation Index
> Fetch the complete documentation index at: https://help.teable.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Create, manage, import and export bases. Move data between Teable Cloud spaces or migrate between Cloud and Self-Hosted instances using .tea files.

A base is a tool for storing and processing all information for a specific project. Each space can have multiple bases, and each base can work independently, providing a clear information structure for specific projects or table collections.

For users unfamiliar with bases, you can think of them as workbooks in Excel, where each workbook can contain multiple sheets.

## Create and Manage Bases

### Adding a Base

1. Enter a space
2. Click "Create Base" in the upper right corner

<img src="https://mintcdn.com/teablecn/jEnUUdkBJLjaocXx/images/docs/base/2026-05-22-base-create.png?fit=max&auto=format&n=jEnUUdkBJLjaocXx&q=85&s=2834555aafe0d8e3cc6f113f6efd6b4b" alt="Create a base" className="docs-screenshot" width="1600" height="313" data-path="images/docs/base/2026-05-22-base-create.png" />

### Renaming/Deleting a Base

1. Enter a space
2. Hover over a base
3. Click the "···" button to open the menu
4. Click "Rename" or "Delete"

<img src="https://mintcdn.com/teablecn/jEnUUdkBJLjaocXx/images/docs/base/2026-05-22-base-rename-delete.png?fit=max&auto=format&n=jEnUUdkBJLjaocXx&q=85&s=66bdb1c28928046ecae6288e9639dd2a" alt="Rename or delete a base" className="docs-screenshot" width="1600" height="526" data-path="images/docs/base/2026-05-22-base-rename-delete.png" />

### Organize Resources in a Base

After entering a base, the left sidebar shows the resources in the current base, such as tables, apps, and automations. You can use folders to organize these resources and make large bases easier to browse.

Common operations include:

* **Create folders**: Create folders in the left sidebar to group related resources.
* **Move resources**: Drag tables, apps, or automations into folders, or drag them to reorder.
* **Organize hierarchy**: Folders can contain child nodes. Keep the hierarchy shallow enough for easy navigation.

### Duplicate a Base to Another Space

Step 1: In the space, select the base you want to duplicate;

Step 2: Click the menu icon and select the Copy Base option;

Step 3: In the popup, choose the target space. You need Creator permissions in that space.

For larger bases, Teable shows progress in the duplicate dialog while it copies the base structure, records, and attachments. Keep the dialog open until the copy finishes. Revision history and collaborators are not copied.

If the base contains Link, Lookup, Rollup, Conditional Lookup, or Conditional Rollup fields that point to another Space, Teable shows the affected fields before duplication. If you continue, Teable converts those fields to **Single line text** in the duplicated base.

<img src="https://mintcdn.com/teablecn/jEnUUdkBJLjaocXx/images/docs/base/2026-05-22-base-duplicate.png?fit=max&auto=format&n=jEnUUdkBJLjaocXx&q=85&s=76c159d1282211e539ebfd6e32e59a25" alt="Duplicate a base to another space" className="docs-screenshot" width="1600" height="920" data-path="images/docs/base/2026-05-22-base-duplicate.png" />

### Move a Base Between Spaces

If you have the required Space permissions, you can move a base to another Space. If the move would leave relationship-based fields pointing across Spaces, Teable warns you and lists the affected fields. When you confirm, Teable converts those fields to **Single line text** as part of the move.

## Import and Export Bases

### Import Base (Data Migration)

The `.tea` file format allows you to import a complete base with all its tables, fields, data, and configurations. This is useful for:

* **Data Migration**: Move bases between different Teable instances (e.g., from Cloud to Self-Hosted)
* **Backup Restoration**: Restore a previously exported base
* **Template Sharing**: Share complete base structures with other teams

**Steps:**

1. Enter the space
2. Click the 「···」 button at the top right corner of the space to open the menu
3. Click 「Import」
4. Upload the `.tea` file to confirm the import

<img src="https://mintcdn.com/teablecn/jEnUUdkBJLjaocXx/images/docs/base/2026-05-22-base-import.png?fit=max&auto=format&n=jEnUUdkBJLjaocXx&q=85&s=8c9c6877b440537d2cd28e0bba14bd45" alt="Import a base from a .tea file" className="docs-screenshot" width="1600" height="367" data-path="images/docs/base/2026-05-22-base-import.png" />

### Export Base (Backup & Migration)

Export your base to a `.tea` file for backup or migration purposes. The exported file contains all tables, fields, data, views, and configurations.

**Steps:**

1. Enter the space
2. Hover your mouse over the base you want to export
3. Click the 「···」 button to open the menu
4. Click 「Export」
5. Keep **Include records** turned on to export record data. Turn it off to export only the structure and configuration.
6. Click **Start exporting** and wait for the export to finish.
7. Click **Download** in the export dialog to save the `.tea` file.

<img src="https://mintcdn.com/teablecn/jEnUUdkBJLjaocXx/images/docs/base/2026-05-22-base-export.png?fit=max&auto=format&n=jEnUUdkBJLjaocXx&q=85&s=a4d2dadf6e30419b64d5319cf00aab08" alt="Export a base to a .tea file" className="docs-screenshot" width="1600" height="738" data-path="images/docs/base/2026-05-22-base-export.png" />

<Note>
  * To migrate data between Teable instances, export your base from the source instance, then import the `.tea` file to the target instance. All data and configurations will be preserved.
  * Teable converts cross-base relation fields to **Single line text** fields in the exported file.
  * When you duplicate or move a base across Spaces, cross-Space relationship fields are converted to **Single line text**.
</Note>

## Share a Base

Bases can be shared through public links. The sharing scope can be the entire base or the currently selected item.

1. Enter the target base
2. Open the share menu for the base or selected item
3. Turn on **Share to web**
4. Copy the share link or QR code

<img src="https://mintcdn.com/teablecn/jEnUUdkBJLjaocXx/images/docs/base/2026-05-22-base-share-entry.png?fit=max&auto=format&n=jEnUUdkBJLjaocXx&q=85&s=f05d5b85fe1f5d01a3f1fd8b2fabaa85" alt="Open base sharing" className="docs-screenshot" width="1600" height="824" data-path="images/docs/base/2026-05-22-base-share-entry.png" />

Sharing scopes include:

| Scope                   | Description                                                                                          |
| ----------------------- | ---------------------------------------------------------------------------------------------------- |
| **Share entire base**   | Shares all items in the current base. New tables and folders added later are automatically included. |
| **Share selected item** | Shares the currently selected item. When a folder is shared, its child items are included.           |

In the share settings, you can configure link permissions, **Allow viewers to copy data**, password access, regenerate the link, delete the share link, or copy the embed config.

<img src="https://mintcdn.com/teablecn/jEnUUdkBJLjaocXx/images/docs/base/2026-05-22-base-share-settings.png?fit=max&auto=format&n=jEnUUdkBJLjaocXx&q=85&s=c6523d9d0f3c7dc616e0579548be0816" alt="Base sharing settings" className="docs-screenshot" width="1600" height="766" data-path="images/docs/base/2026-05-22-base-share-settings.png" />

If the sharing scope includes an app, the app must be published before it can be accessed through the public link.

## Features Within a Base

A base can contain multiple tables for recording and organizing work or business-related information.

For example: A customer management base might have separate tables for "Customer Companies," "Customer Contacts," and "Customer Follow-up Records," while a meeting room management base might have separate tables for recording "Meeting Room Management," "Meeting Room Equipment," and "Meeting Room Reservations."

Therefore, most features within a base are related to tables:

* **Creating Tables**: Bases allow users to create new tables based on project-specific needs, where users can define table structure, fields, and data types.
* **Editing Tables**: Users can edit existing tables within the base, including adding, deleting, and modifying records.
* **Exporting and Importing Data**: Bases support exporting data to CSV, and importing data in both CSV and XLSX formats.

Refer to the [Tables section](/en/basic/table) for more information about tables.
