# Actions on Base

> Part of the NocoDB documentation (Product docs > Bases). Index of all pages: https://nocodb.com/llms.txt. Any docs page is available as Markdown by adding `.md` to its URL.

URL: https://nocodb.com/docs/product/bases/actions-on-base
Last updated: 2026-09-28

Understand the structure, actions, and developer tools available in a base.

<AskNocoAI>
  <Prompt>
    Rename this base to [new name]
  </Prompt>

  <Prompt>
    Give me an overview of the tables in this base and how they are linked
  </Prompt>

  <Prompt>
    Suggest improvements to the structure of this base
  </Prompt>
</AskNocoAI>

## Base card

Each base on the workspace **Bases** page is listed as a card. The card shows:

* A coloured tile with the base icon on the left. Click it to [change the icon or colour](#change-base-icon-and-colour).
* The base name, with a subtitle naming what opens when you click the card — **Interface** when the base has a published [interface](/docs/interfaces), or **Base** otherwise.
* A **⋮** menu on hover, which opens the [base context menu](#base-context-menu).

When a card opens an interface, hovering over it also reveals a **Go to data** button that takes you to the base's tables instead.

Use the filter dropdown above the list to narrow the cards down to **All Bases**, **Starred**, **Private**, or **Owned by me**. To find a base by name, type into the search box in the top bar.

## Base context menu

The base context menu can be accessed in two ways:

* **From the workspace Bases page** — click the **⋮** icon on a base card.
* **From within a base** — click the base name dropdown in the top-left of the sidebar. This menu includes additional options like **MCP Server**, **Rest APIs** (API v2 / API v3), and **Import data**.

<img alt="base context menu" src={__img0} placeholder="blur" />
<img alt="base context menu" src={__img1} placeholder="blur" />

## Rename base

1. Open the [base context menu](#base-context-menu).
2. Select **Rename base**.
3. Edit the name and press **Enter** to save.

## Change base icon and colour

1. On the workspace **Bases** page, click the coloured icon tile on the left of the base card.
2. Under **Icon**, pick an icon from the grid, or use **Search all icons** to find one by name.
3. Under **Colour**, pick one of the preset swatches. The tile tint follows the colour you choose and adapts to light and dark mode. Click **+** at the end of the row for **More Colors** to set a custom colour.

<img alt="Base icon picker" src={__img2} placeholder="blur" />

Changes are saved as you select them. The picker stays open so you can set both the icon and the colour in one pass.

<Callout type="info">
  Changing a base icon or colour requires permission to rename the base.
</Callout>

<Callout type="info">
  Icon selection is available on 

  **NocoDB Cloud**

   and licensed self-hosted deployments. On Community Edition, the picker offers colours only.
</Callout>

## Star base

1. Open the [base context menu](#base-context-menu).
2. Select **Add to starred**.

Starred bases are grouped under a **Starred** heading at the top of the **Bases** page, above **Owned By Me**, so your most-used bases stay within reach. You can also isolate them with the **Starred** option in the base filter dropdown.

<img alt="Starred bases on the workspace Bases page" src={__img3} placeholder="blur" />

### Remove a base from starred list

1. Open the [base context menu](#base-context-menu).
2. Select **Remove from starred**.

## Duplicate base

1. Open the [base context menu](#base-context-menu).
2. Select **Duplicate base**.
3. Configure what to include:
   * **Include records** — disable to duplicate schema only, without data.
   * **Include comments** — disable to skip comments.
   * **Include scripts** — disable to skip scripts.
   * **Include dashboards** — disable to skip dashboards.
   * **Include workflows** — disable to skip workflows.
   * **Include documents** — disable to skip NocoDocs documents.
4. Select a **Workspace** to duplicate into (defaults to current workspace).
5. Click **Duplicate Base**.

<img alt="image" src={__img4} placeholder="blur" />

<Callout type="info">
  Cross-base links, audit logs, and integrations will not be duplicated. You will become the owner of the duplicated base. Existing members are not transferred. 

  `User`

   field values are carried over even when the person is not a member of the destination workspace; a value is dropped only when no NocoDB account exists for that user.
</Callout>

## Delete base

Deleting a base permanently removes all its tables, data, and associated content.

<Callout type="warning">
  Only 

  **base owners**

   can delete a base. 

  **This action cannot be undone.**
</Callout>

1. Open the [base context menu](#base-context-menu).
2. Select **Delete base**.
3. Click **Delete Base** to confirm.

<img alt="base delete" src={__img5} placeholder="blur" />

## Find base ID

Each base has a unique ID (prefixed with `p`) visible in the base context menu and in the URL.

Example:

```
https://app.nocodb.com/wa5dveq3/pptsua3fuosby2j
```

In this example, the base ID is `pptsua3fuosby2j`.

## Relations

NocoDB provides a visual diagram of relationships between tables within a base.

1. Open any table in the base and click **Tools** in the view toolbar.
2. Select **Relations**.
3. Click **Base relations**.

<img alt="base relations" src={__img6} placeholder="blur" />

## REST APIs

NocoDB provides a Swagger UI for each base to interact with its REST API endpoints. Both **API v2** and **API v3** are available.

1. Open the [base context menu](#base-context-menu) from within a base.
2. Hover over **Rest APIs** and select **API v2** or **API v3**.

See [Accessing APIs](/docs/apis-and-mcp/rest-apis/accessing-apis) for more details.

## Data display

**Data Display** controls how a base shows empty values and junction tables. Open it from the [base context menu](#base-context-menu) → **Settings**, then **Admin** → **Data Display**. Its settings are split into two groups by who they affect.

**Just for you** — changes only what you see, in every base:

* **Show M2M Tables** — Show or hide many-to-many junction tables in the sidebar.
* **Show NULL in Cells** — Display NULL values in cells to differentiate from empty strings.

**For everyone** — changes what everyone in this base sees:

* **Show NULL and EMPTY in Filter** — Enable additional filter options to distinguish NULL from empty string values.

<Callout type="info">
  **Show NULL and EMPTY in Filter**

   cannot be turned off while any view in the base still filters on NULL or EMPTY. Remove those filter conditions first.
</Callout>

---

## Related pages

- [Create Base](https://nocodb.com/docs/product/bases/create-base.md): Learn how to create a base in NocoDB.
- [Folders](https://nocodb.com/docs/product/bases/folders.md): Organize tables, documents, and dashboards into collapsible folders in the base sidebar.
- [Import Airtable to NocoDB](https://nocodb.com/docs/product/bases/import-base-from-airtable.md): A complete import of your Airtable base to NocoDB within minutes
- [Base Collaboration](https://nocodb.com/docs/product/bases/base-collaboration.md): This article explains how to invite members or teams to your base, manage their roles, and remove them when needed.
- [Share Base](https://nocodb.com/docs/product/bases/share-base.md): Procedures to share a base & generating embedded iframe
- [Base Snapshots](https://nocodb.com/docs/product/bases/snapshots.md): Procedures to create and manage snapshots
- [Base Trash ☁](https://nocodb.com/docs/product/bases/base-trash.md): View, restore, and permanently delete trashed items — records, tables, views, fields, dashboards, widgets, workflows, scripts, and extensions — from a single base-level Trash.
- [Trash Settings ☁](https://nocodb.com/docs/product/bases/trash-settings.md): Configure per-table trash retention and disable trash on a per-table basis.
