Actions on Project

Ask NocoAI

Copy a prompt, paste it into NocoAI in any base, and replace the words in [brackets] with your own.

Rename this project to [new name]
Give me an overview of the tables in this project and how they are linked
Suggest improvements to the structure of this project

Project card

The workspace Projects page shows each project as a card. The card shows:

A colored tile with the project icon, on the left. To change the icon or color, click the tile.
The project name, with a subtitle. The subtitle tells what opens when you click the card: Interface if the project has a published interface, or else Project.
A ⋮ menu when you hover over the card. The menu opens the project context menu.

If a card opens an interface, a Go to data button also shows when you hover over the card. This button opens the tables of the project.

To show only some cards, use the filter dropdown above the list. The options are All Projects, Starred, Private, and Owned by me. To find a project by name, type in the search box in the top bar.

You can open the project context menu in two ways:

From	Do this
From the workspace Projects page	Click the ⋮ icon on a project card.
From within a project	In the top-left of the sidebar, click the project name dropdown. This menu has more options, such as MCP Server, Rest APIs (API v2 / API v3), and Import data.

Rename project

Open the project context menu.
Select Rename project.
Edit the name.
To save, press Enter.

Change project icon and colour

On the workspace Projects page, click the colored icon tile on the left of the project card.
Below Icon, select an icon from the grid. To find an icon by name, use Search all icons.
Below Colour, select one of the preset swatches. The tile tint changes to the color that you select, and it adapts to light and dark mode. To set a custom color, click + at the end of the row. This opens More Colors.

NocoDB saves each change when you select it. The picker stays open, so you can set the icon and the color at the same time.

Changing a project icon or colour requires permission to rename the project.

Icon selection is available on NocoDB Cloud and licensed self-hosted deployments. On Community Edition, the picker offers colours only.

Star project

Open the project context menu.
Select Add to starred.

The Projects page shows starred projects below a Starred heading at the top, above Owned By Me. Thus the projects that you use most are easy to find. To show only starred projects, select the Starred option in the project filter dropdown.

Starred projects on the workspace Projects page

Remove a project from starred list

Open the project context menu.
Select Remove from starred.

Duplicate project

Open the project context menu.
Select Duplicate project.

Select what to include. If you disable an option, NocoDB does not copy that content:

Option	When disabled
Include records	Copies the schema only, without data.
Include comments	Does not copy comments.
Include scripts	Does not copy scripts.
Include dashboards	Does not copy dashboards.
Include workflows	Does not copy workflows.
Include documents	Does not copy NocoDocs documents.

Select the Workspace for the copy. The default is the current workspace.
Click Duplicate Project.

The Duplicate Project dialog

Cross-project links, audit logs, and integrations will not be duplicated. You will become the owner of the duplicated project. 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.

Delete project

When you delete a project, NocoDB permanently removes all its tables, data, and related content.

Only project owners can delete a project. This action cannot be undone.

Open the project context menu.
Select Delete project.
To confirm, click Delete Project.

The Delete Project confirmation

Find the project ID

Each project has a unique ID that starts with p. The project context menu shows it as PROJECT ID, and it is also the second segment of the URL.

Example:

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

In this example, the project ID is pptsua3fuosby2j. The REST API calls the same value baseId. Refer to Base ID.

Relations

NocoDB shows a diagram of the relationships between the tables in a project.

Open a table in the project.
In the view toolbar, click Tools.
Select Relations.
Click Project relations.

The ERD view, with four linked tables

REST APIs

Each project has a Swagger UI, where you can use its REST API endpoints. API v2 and API v3 are both available.

In a project, open the project context menu.
Hover over Rest APIs.
Select API v2 or API v3.

For more details, see Accessing APIs.

Data display

Data Display controls how a project shows empty values and junction tables. To open it, go to the project context menu → Settings, then Admin → Data Display. The settings are in two groups. The group tells who the setting affects.

Group	Setting	What it does
Just for you: changes only what you see, in every project	Show M2M Tables	Shows or hides many-to-many junction tables in the sidebar.
	Show NULL in Cells	Shows NULL values in cells, so you can tell them apart from empty strings.
For everyone: changes what everyone in this project sees	Show NULL and EMPTY in Filter	Adds filter options that tell NULL apart from empty string values.
	Show app first in the sidebar	Shows the App tile of the project app above Data in the mini sidebar, instead of after Interfaces.

Show NULL and EMPTY in Filter cannot be turned off while any view in the project still filters on NULL or EMPTY. Remove those filter conditions first.