Skip to content

Commit 5d5b28f

Browse files
Merge pull request #160 from nocodb/docs/0718-cleanup-2
2 parents 338d34f + 14119ca commit 5d5b28f

22 files changed

+134
-123
lines changed

content/docs/bases/actions-on-base.mdx

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -74,6 +74,17 @@ To delete a base:
7474

7575
![base delete](/img/v2/base/base-delete.png)
7676

77+
## Find base ID
78+
79+
Each base in NocoDB has a unique ID (prefixed with `p`, short for *project*) that identifies it within a workspace.
80+
You can find the base ID in the URL when viewing a base.
81+
82+
Example:
83+
```
84+
https://app.nocodb.com/#/wqd7e84kkpg8169/pqh6trao813gar7
85+
```
86+
In this example, the base ID is: `pqh6trao813gar7`
87+
7788
## Developer features
7889

7990
### Base settings

content/docs/tables/actions-on-table.mdx

Lines changed: 39 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -7,51 +7,46 @@ keywords: ['NocoDB table', 'rename table', 'duplicate table', 'delete table']
77

88
## Rename table
99

10-
1. Access the contextual menu for the table by clicking on the ellipsis symbol (`...`) located in the left sidebar.
11-
2. Click on the `Rename` option from the context menu.
12-
3. Enter the desired new table name into the provided field.
13-
4. To finalize the renaming process, click on the `Rename` button.
10+
1. Click the `...` (ellipsis) next to the table name in the left sidebar and select `Rename table` from the context menu.
11+
- Alternatively, double-click on the table name in the left sidebar to make it editable.
12+
2. Enter the new name for the table in the input field that appears. Use the `Enter` key to confirm the new name or click outside the input field to save changes.
1413

1514
![image](/img/v2/table/table-context-menu.png)
1615

1716
![image](/img/v2/table/table-rename.png)
1817

1918
## Change table icon
2019

21-
1. Click on the existing table icon to the left of the table name in the left sidebar.
22-
2. Select the desired icon from the list of available options.
20+
1. Click the current table icon next to the table name in the left sidebar.
21+
2. Choose a new icon from the available options.
2322

2423
![image](/img/v2/table/table-change-icon.png)
2524

2625
## Duplicate table
2726

28-
1. Access the contextual menu for the table by clicking on the ellipsis symbol (`...`) located in the left sidebar.
29-
2. Click on the `Duplicate` option from the context menu.
30-
3. For additional customization (Optional)
31-
a) Under `Include data`, you have the flexibility to choose whether to replicate the table with or without its data.
32-
b) Regarding `Include views` you can select whether to duplicate the table with or without its associated views.
33-
4. Proceed by clicking the `Duplicate Table` button found in the confirmation dialog.
27+
1. Click the `...` (ellipsis) next to the table name in the left sidebar and select `Duplicate table`.
28+
2. (Optional) In the dialog:
29+
- Use **Include data** to copy the table with or without its records.
30+
- Use **Include views** to copy it with or without its saved views.
31+
3. Click **Duplicate Table**.
3432

35-
A new table will be generated, mirroring the original table's schema and content, in accordance with the configurations specified in step 3.
33+
A new table will be created based on your selected options.
3634

3735
![image](/img/v2/table/table-context-menu.png)
3836

3937
![image](/img/v2/table/table-duplicate.png)
4038

41-
:::info
39+
**Additional notes**
4240
- Duplicate table will be created in the same base as the original table
4341
- Duplicate table will carry suffix ` Copy` in its name.
4442
- Duplicate table option is not available for `External DB` bases
45-
:::
4643

4744
## Delete table
4845

4946
<Callout type="info">**This action cannot be undone**</Callout>
5047

51-
1. Access the contextual menu for the table by clicking on the ellipsis symbol (`...`) located in the left sidebar.
52-
2. Click on the `Delete` option from the context menu.
53-
3. To finalize the deletion process, click on the `Delete` button in the confirmation dialog.
54-
48+
1. Click the `...` (ellipsis) next to the table name in the left sidebar and select `Delete table`.
49+
2. In the confirmation dialog, click `Delete Table` to confirm.
5550
![image](/img/v2/table/table-context-menu.png)
5651

5752
![image](/img/v2/table/table-delete.png)
@@ -62,13 +57,31 @@ Table description can be added by clicking on the `Add Description` button on th
6257

6358
![image](/img/v2/table/table-description-2.png)
6459

65-
## Related articles
66-
- [Create a new table](/docs/product-docs/tables/create-table)
67-
- [Create a table using a CSV, Excel or a JSON](/docs/product-docs/tables/create-table-via-import)
68-
- [Import data from Csv/Xlsx into existing table](/docs/product-docs/tables/import-data-into-existing-table)
69-
- [Rename a table](/docs/product-docs/tables/actions-on-table#rename-table)
70-
- [Duplicate a table](/docs/product-docs/tables/actions-on-table#duplicate-table)
71-
- [Delete a table](/docs/product-docs/tables/actions-on-table#delete-table)
60+
## Table permissions
61+
62+
<Callout type="info">Table permissions are available in NocoDB cloud- Team plan onwards and Self hosted Enterprise plans</Callout>
63+
64+
Table permissions in NocoDB let you control who can create or delete records in each table. Find more details [here](/docs/product-docs/roles-and-permissions/table-permissions)
65+
66+
67+
## Find table ID
68+
69+
Each table in NocoDB has a unique ID (prefixed with `m`, short for *model*) that identifies it within a base.
7270

71+
You can find the table ID in the URL when viewing a table.
72+
73+
Example:
74+
75+
```
76+
https://app.nocodb.com/#/wqd7e84kkpg8169/pqh6trao813gar7/mxo5v3uj1l1xjpz
77+
```
78+
79+
In this example, the table ID is: `mxo5v3uj1l1xjpz`
80+
81+
You can also copy the table ID by clicking the `...` (ellipsis) next to the table name and selecting **Copy Table ID**.
82+
83+
![image](/img/v2/table/table-context-menu.png)
7384

85+
**Usage**: Table IDs are commonly used in API calls, scripting, and integrations where you need to reference a specific table.
7486

87+
---

content/docs/tables/create-table-via-import.mdx

Lines changed: 20 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -11,48 +11,43 @@ keywords: ['NocoDB table', 'create table', 'import table', 'import csv', 'import
1111
There are two ways to access import modal:
1212

1313
#### 1. From the base dashboard
14+
1415
![import data](/img/v2/base/base-import-from-dashboard-1.png)
1516

1617
![import from dashboard](/img/v2/table/table-import-from-dashboard.png)
1718

1819

19-
2020
#### 2. From the base context menu
2121

2222
![import from sidebar](/img/v2/table/table-import-from-sidebar.png)
2323

2424
### Importing file
2525
To import a file, follow the steps below:
2626
1. There are two ways to upload source file:
27-
(a). Upload from local directory: Click 'browse file' or drag and drop file.
28-
(b). Upload from URL: Specify the URL of the file.
29-
2. (_optional_) [Advance Settings](#advanced-settings)
30-
3. Click on `Import` button.
31-
4. (_optional_) Specify the table name. By default, the file name will be used as the table name.
32-
5. (_optional_) Select the columns from the CSV to be included in the table. By default, all fields are included.
33-
6. (_optional_) Modify the field name. By default, the field name is the same as the column name in the CSV.
34-
7. Click on `Import` button to start importing the file.
35-
36-
![import data](/img/v2/table/import-stage-1.png)
27+
- **Upload** : Upload from local directory. Either click 'browse file' or drag and drop file.
28+
- **Add from URL** : Specify the URL of the file.
29+
2. (_optional_) Select character encoding. By default, it is set to `UTF-8`.
30+
3. (_optional_) Configure [Advance Settings](#advanced-settings)
31+
4. Click on `Import` button.
32+
5. (_optional_) Specify the table name. By default, the file name will be used as the table name.
33+
6. (_optional_) Select the columns from the CSV to be included in the table. By default, all fields are included.
34+
7. (_optional_) Modify the field name. By default, the field name is the same as the column name in the CSV.
35+
8. Click on `Import` button to start importing the file.
36+
3737
![import data](/img/v2/table/import-stage-2.png)
38+
![import data](/img/v2/table/import-stage-3.png)
39+
40+
Additional notes
41+
- Multiple files can be imported at once.
42+
- Supported file formats: CSV, Excel, JSON
43+
- Maximum file size: 5 MB
44+
- All fields are imported by default as `Single line text`. Field type as required can be changed after file is imported.
45+
- By default, the first field will be chosen as Display Value.
3846

39-
<Callout type="info">
40-
- Multiple files can be imported at once.
41-
- Supported file formats: CSV, Excel, JSON
42-
- Maximum file size: 5 MB
43-
- All fields are imported by default as `Single line text`. Field type as required can be changed after file is imported.
44-
By default, the first field will be chosen as Display Value.
45-
</Callout>
4647

4748

4849
### Advanced Settings
4950
- **Use first record as header**: Enabled by default. If selected, the first record in the spreadsheet will be treated as the header record and its contents will be used as field names.
5051
- **Import data**: Enabled by default. If selected, all data will be imported; otherwise, only the table will be created.
5152

52-
53-
## Related articles
54-
- [Create a new table](/docs/product-docs/tables/create-table)
55-
- [Import data from Csv/Xlsx into existing table](/docs/product-docs/tables/import-data-into-existing-table)
56-
- [Rename a table](/docs/product-docs/tables/actions-on-table#rename-table)
57-
- [Duplicate a table](/docs/product-docs/tables/actions-on-table#duplicate-table)
58-
- [Delete a table](/docs/product-docs/tables/actions-on-table#delete-table)
53+
---

content/docs/tables/create-table.mdx

Lines changed: 18 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,27 +1,33 @@
11
---
2-
title: 'Create empty table'
2+
title: 'Create table'
33
description: 'Learn how to create a table in NocoDB.'
44
tags: ['Tables', 'Create']
55
keywords: ['NocoDB table', 'create table']
66
---
77

8-
## Create new table
9-
1. Click on `+` on the left sidebar next to `base name` OR click on `Create New Table` button on the Base dashboard.
10-
2. Fill table name in the pop-up modal (Optional).
11-
3. Click on `Add Description` to add a description to the table (Optional).
12-
4. Click on `Create Table` button.
8+
## Create a new table
9+
10+
To create a table from scratch:
11+
12+
1. Click **+ Create New** in the left sidebar.
13+
2. From the dropdown, select **Table**.
14+
3. (Optional) Provide a name for the table in the modal that appears.
15+
4. (Optional) Use **Add Description** to include additional context or details.
16+
5. Click **Create Table** to complete the setup.
1317

1418
![image](/img/v2/table/table-create-1.png)
1519
![image](/img/v2/table/table-create-2.png)
1620

1721

18-
### Related articles
19-
- [Create a table using a CSV, Excel or a JSON](/docs/product-docs/tables/create-table-via-import)
20-
- [Import data from Csv/Xlsx into existing table](/docs/product-docs/tables/import-data-into-existing-table)
21-
- [Rename a table](/docs/product-docs/tables/actions-on-table#rename-table)
22-
- [Duplicate a table](/docs/product-docs/tables/actions-on-table#duplicate-table)
23-
- [Delete a table](/docs/product-docs/tables/actions-on-table#delete-table)
22+
## Creating table Using AI
23+
24+
<Callout type="info">This feature is available only on NocoDB Cloud. It is not supported in self-hosted or on-premise deployments.</Callout>
2425

26+
NocoAI can provide a set of suggested tables based on your current schema and context. The tables thus created will include relevant fields and will be linked to existing tables where applicable. This allows you to quickly expand your database structure without manually defining each table and its relationships.
2527

28+
![image](/img/v2/table/create-table-ai.png)
2629

30+
For more details on how to use this feature, refer to the [NocoAI documentation](/docs/product-docs/noco-ai/create-table).
2731

32+
33+
---
Lines changed: 26 additions & 43 deletions
Original file line numberDiff line numberDiff line change
@@ -1,63 +1,46 @@
11
---
2-
title: 'Import data into a table'
3-
description: 'Learn how to import data into an existing table in NocoDB.'
2+
title: 'Upload data into a table'
3+
description: 'Learn how to upload data into an existing table in NocoDB.'
44
tags: ['Tables', 'Upload', 'CSV', 'Excel', 'JSON']
5-
keywords: ['NocoDB table', 'import data into table', 'import data from csv', 'import data from excel', 'import data from xlsx']
5+
keywords: ['NocoDB table', 'Upload data into table', 'Upload data from csv', 'Upload data from excel', 'Upload data from xlsx']
66
---
77

8-
98
## Import data from CSV / Excel
109

1110
### Accessing import modal
12-
1. Click on `...` context menu from the toolbar.
13-
2. Click on `Upload` button.
14-
3. Select `Upload CSV` / `Upload Excel` option.
11+
1. Click on `` context menu from the toolbar.
12+
2. Select `Upload` from the dropdown menu.
13+
3. Select `CSV` / `Excel` option.
1514

1615
![image](/img/v2/table/upload-csv-1.png)
1716

1817
### Importing file data
19-
There are two ways to upload source file:
20-
21-
#### 1. Upload from local directory
22-
1. Select `Upload` tab from the Quick import modal.
23-
2. Click on `file upload` button or drag and drop file to the modal.
24-
3. [Advance Settings](#advance-settings) (optional)
25-
4. Click on `Import` button.
26-
27-
![image](/img/v2/table/upload-csv-2.png)
2818

29-
#### 2. Upload from URL
30-
1. Select `URL` tab from the Quick import modal.
31-
2. Paste the URL of the file.
32-
3. [Advance Settings](#advance-settings) (optional)
33-
4. Click on `Import` button.
19+
1. Select file to upload
3420

35-
![image](/img/v2/table/upload-csv-url.png)
36-
37-
### Field mapping
38-
1. **Table Name** (Optional)
39-
- Defaults to the name of the file; double-click to edit.
40-
41-
2. **Mapping Fields** (Optional)
42-
- Existing field names are listed under `Source field`, while new fields identified from the import file are listed under `Destination field`.
43-
- NocoDB automatically maps destination field names based on the source field names.
21+
There are two ways to upload source file:
22+
- **Upload** : Upload from local directory. Either click 'browse file' or drag and drop file.
23+
- **Add from URL** : Specify the URL of the file.
24+
2. (_optional_) Select character encoding. By default, it is set to `UTF-8`.
25+
3. Advanced Settings : **Use first record as header**
26+
- Enabled by default. If selected, the first record in the spreadsheet will be treated as the header record and its contents will be used as field names.
27+
4. Click on `Upload files` button.
28+
5. **Mapping Fields** (Optional)
4429
- You can reconfigure the mapping by utilizing the dropdown menu that appears when you click on the destination field.
30+
- Existing field names are listed under **NocoDB field** (column to the right), while new fields identified from the import file are listed under **Field** (column to the left).
31+
- NocoDB automatically maps field names in the import file based on the NocoDB field names.
32+
6. **Exclude fields** (Optional)
33+
- Uncheck checkbox to exclude a field from being imported.
34+
7. **Allow create missing select field options** (Optional)
35+
- If enabled, NocoDB will create new options for select fields that are not already present in the table.
36+
8. **Initiate Import**
37+
- Click on the `Upload` button to commence the file import process.
4538

46-
3. **Exclude fields** (Optional)
47-
- A checkbox is provided to exclude a field from being imported.
4839

49-
4. **Initiate Import**
50-
- Click on the `Import` button to commence the file import process.
40+
![image](/img/v2/table/upload-csv-2.png)
5141

5242
![image](/img/v2/table/upload-csv-3.png)
5343

54-
### Advance settings
55-
- `# of records to parse to infer datatype` - defaults to 500 records.
56-
- `Utilize First Record as Headers`**`: Enabled by default. If selected, the first record in the spreadsheet will be treated as the header record and its contents will be used as field names.
44+
On completion, the imported data will be appended to the existing table.
5745

58-
## Related articles
59-
- [Create a new table](/docs/product-docs/tables/create-table)
60-
- [Create a table using a CSV, Excel or a JSON](/docs/product-docs/tables/create-table-via-import)
61-
- [Rename a table](/docs/product-docs/tables/actions-on-table#rename-table)
62-
- [Duplicate a table](/docs/product-docs/tables/actions-on-table#duplicate-table)
63-
- [Delete a table](/docs/product-docs/tables/actions-on-table#delete-table)
46+
---

content/docs/tables/index.mdx

Lines changed: 10 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -6,21 +6,18 @@ icon: "table"
66
keywords: ['NocoDB table', 'table overview']
77
---
88

9+
Tables are where your data lives in NocoDB — made up of **records** (rows) and **fields** (columns). Each base can have multiple tables, and you can link them to create relationships between datasets.
910

10-
A base is housed in tables, where data is logically arranged into records and fields. A table in NocoDB serves as a robust center for managing your data effectively. You have the flexibility to create multiple tables, each catering to distinct sets of data. Moreover, you can link tables to one another to establish relationships between them.
11+
NocoDB tables function like spreadsheets, with added flexibility:
12+
- View data as a grid, kanban board, gallery, or calendar.
13+
- Perform operations like sorting, filtering, and aggregation.
1114

12-
Much like traditional spreadsheets, NocoDB tables empower you to carry out tasks such as sorting, filtering, and aggregating your data. What sets NocoDB apart from standard spreadsheets is its ability to present table data in various formats. You can view your data as a conventional grid with records and fields, a gallery of cards, or even as interactive kanban boards, and then make use of a friendly form to input data.
13-
14-
You can start by learning how to [create a new table](/docs/product-docs/tables/create-table), and if you have existing data in CSV, Excel, or JSON format, you can easily [create a table via import](/docs/product-docs/tables/create-table-via-import). If you need to add more data to an existing table, we offer a simple way to [import data from CSV or XLSX files](/docs/product-docs/tables/import-data-into-existing-table). In case you want to make changes, you can [rename a table](/docs/product-docs/tables/actions-on-table#rename-table), or if you need a copy of it, simply [duplicate the table](/docs/product-docs/tables/actions-on-table#duplicate-table). And if you ever need to remove a table, we provide a straightforward option to [delete it](/docs/product-docs/tables/actions-on-table#delete-table).
15-
16-
As you delve into this section, you'll gain a deeper understanding of how to leverage NocoDB's tables effectively, equipping you to proficiently organize your own dataset.
17-
18-
## Related articles
15+
You can:
1916
- [Create a new table](/docs/product-docs/tables/create-table)
20-
- [Create a table using a CSV, Excel or a JSON](/docs/product-docs/tables/create-table-via-import)
21-
- [Import data from Csv/Xlsx into existing table](/docs/product-docs/tables/import-data-into-existing-table)
22-
- [Rename a table](/docs/product-docs/tables/actions-on-table#rename-table)
23-
- [Duplicate a table](/docs/product-docs/tables/actions-on-table#duplicate-table)
24-
- [Delete a table](/docs/product-docs/tables/actions-on-table#delete-table)
17+
- [Import a table from CSV, Excel, or JSON](/docs/product-docs/tables/create-table-via-import)
18+
- [Import data into an existing table](/docs/product-docs/tables/import-data-into-existing-table)
19+
- [Rename](/docs/product-docs/tables/actions-on-table#rename-table), [duplicate](/docs/product-docs/tables/actions-on-table#duplicate-table), or [delete a table](/docs/product-docs/tables/actions-on-table#delete-table)
2520

21+
Use tables to organize your data your way — flexible, powerful, and easy to manage.
2622

23+
---

content/docs/workspaces/actions-on-workspace.mdx

Lines changed: 10 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -30,8 +30,14 @@ To delete a workspace:
3030
![image](/img/v2/workspace/workspace-delete.png)
3131
![image](/img/v2/workspace/workspace-delete-confirmation.png)
3232

33-
## Related articles
3433

35-
* [Workspace overview](/docs/product-docs/workspaces)
36-
* [Create workspace](/docs/product-docs/workspaces/create-workspace)
37-
* [Invite team members](/docs/product-docs/workspaces/workspace-collaboration)
34+
## Find workspace ID
35+
Each workspace in NocoDB has a unique ID (prefixed with `w`, short for *workspace*) that identifies it within the system. You can find the workspace ID in the URL when you are in the workspace.
36+
37+
Example
38+
```
39+
https://app.nocodb.com/#/w1234567890/pqh6trao813gar7
40+
```
41+
In this example, the workspace ID is: `w1234567890`
42+
43+
---
533 KB
Loading
125 KB
Loading
77.5 KB
Loading

0 commit comments

Comments
 (0)