-
Notifications
You must be signed in to change notification settings - Fork 5
Docs/0731 cleanup #192
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Merged
Merged
Docs/0731 cleanup #192
Changes from all commits
Commits
Show all changes
3 commits
Select commit
Hold shift + click to select a range
File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,44 +1,52 @@ | ||
| --- | ||
| title: "Display value" | ||
| description: 'This article explains how to set display value for a table & its use.' | ||
|
|
||
| title: "Display Value" | ||
| description: "This article explains how to set the display value for a table and its significance." | ||
| tags: ['Fields', 'Display Value'] | ||
| keywords : ['display value', 'display value in nocoDB', 'display value in nocoDB'] | ||
| keywords: ['display value', 'display value in NocoDB'] | ||
| --- | ||
|
|
||
| # Display Value | ||
| The **Display Value** serves as the primary visual identifier for a record within a table. It helps users quickly recognize and associate records across views and linked tables. While it is often recommended to set a display value based on a field with unique identifiers (like a primary key), uniqueness is not enforced at the database level. | ||
|
|
||
| The `Display Value`, as its name suggests, serves as the primary or main value within a record of a table, and it is typically the attribute by which we identify or associate that specific record. While it is advisable for the display value to be linked to a field with unique identifiers, such as a primary key, it's important to note that this uniqueness is not always enforced at the database level. | ||
| <div style={{ textAlign: 'center' }}> | ||
| <iframe width="560" height="315" src="https://www.youtube.com/embed/GAPAec6zXQ8?start=13" frameBorder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen></iframe> | ||
| </div> | ||
|
|
||
| <center> | ||
| <iframe width="560" height="315" src="https://www.youtube.com/embed/GAPAec6zXQ8?si=G_61hrI3gV_xYTrt?&start=13" frameBorder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen ></iframe> | ||
| </center> | ||
| --- | ||
|
|
||
| ## Use of Display Value | ||
| - Within a spreadsheet, `Display Value` are always highlighted so that it is easier to recognise what record we are working with. | ||
| - And when `Links` are created between two tables - it is the Display Value that appears in `Linked records` modal. | ||
|
|
||
| Example: | ||
| Display Value highlighted in Actor table | ||
| * In the spreadsheet view, the display value is visually emphasized to make it easier to identify the record you’re working with. | ||
| * When creating **Links** between tables, the display value is shown in the **Linked Records** modal, making cross-table relationships more readable and intuitive. | ||
|
|
||
| **Example: Display Value highlighted in the Actor table** | ||
|  | ||
|
|
||
| Display Value associated when Links field | ||
| The value shown in `Link Records` modal when adding a new link is associated records `Display value` | ||
|
|
||
| **Example: Display Value shown in a Links field.** | ||
| The value shown in the **Link Records** modal is pulled from the related table's display value. | ||
|  | ||
|
|
||
| --- | ||
|
|
||
| ## Set Display Value | ||
| Click dropdown icon (🔽) in the target field. Click `Set as Display Value`. | ||
|
|
||
|  | ||
|
|
||
| <Callout type="info"> | ||
| How is Display Value identified for existing database tables ? | ||
| - It is usually the first field after the primary key which is not a number. | ||
| - If there is no field which is not a number then the field adjacent to primary key is chosen. | ||
| To set a field as the display value: | ||
|
|
||
| 1. Click the dropdown icon (🔽) next to the desired field. | ||
| 2. Select **Set as display value** from the menu. | ||
|
|
||
| <div style={{ textAlign: 'center' }}> | ||
| <img src="/img/v2/fields/set-as-display-value.png" alt="Set as display value" style={{ width: '80%', maxWidth: '480px' }} /> | ||
| </div> | ||
|
|
||
| Can I change the Display Value to another field within tables ? | ||
| - Yes, you can use the same way mentioned above to set Display Value. | ||
| </Callout> | ||
| --- | ||
|
|
||
| ## FAQ | ||
|
|
||
| **How is the Display Value determined for existing database tables?** | ||
| For tables connected from external databases, NocoDB automatically selects the display value based on the table structure. By default, it picks the first non-numeric field after the primary key. If no non-numeric field is found, it selects the next field after the primary key. | ||
|
|
||
| **Can I change the Display Value later?** | ||
| Yes. You can change the display value at any time by using the context menu on the target field. [Learn more →](/docs/product-docs/fields/display-value#set-display-value) | ||
|
|
||
| --- |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This can be made into two paragraphs?
Long text is hard to read