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

# Property Lists

> Display record details in a clean, structured format.

The Property List block is used to display a curated selection of fields and properties for a single record. It is the primary way to present detailed information about an object (like a Customer, Project, or Support Ticket) in a readable and organized manner.

## Key Features

* **Structured Layout**: Groups related properties together for better clarity.
* **Rich Data Support**: Handles all Custral property types, including text, dates, selects, and links.
* **Conditional Visibility**: Show or hide properties based on specific conditions (e.g., only show "Churn Reason" if the status is "Closed").
* **Direct Editing**: (Optional) Allow users to update properties directly from the list.

## Configuration

| Setting        | What it does                                                          |
| -------------- | --------------------------------------------------------------------- |
| Record         | The record to display. Usually inherited automatically from the page. |
| Object         | The type of object the record belongs to.                             |
| Properties     | Which fields to display in the list.                                  |
| Groups         | Organize properties into labelled sections.                           |
| Columns        | Show properties in one or two columns.                                |
| Label position | Place labels above or beside each value.                              |
| Collapsible    | Let users expand and collapse groups.                                 |

## Best Practices

* **Group Related Data**: Use headers to separate contact information, deal details, and internal metadata.
* **Prioritize Importance**: Place the most important properties at the top of the list.
* **Use Icons**: Add icons to property labels to help users scan the list more quickly.
* **Use empty states**: Define what shows when a property is empty (e.g., "Not Provided" or simply hiding the row).

***

## Example Usage

A **Customer Overview** property list might include:

* **Group: Basic Info**
  * Company Name
  * Website
  * Primary Contact
* **Group: Subscription Details**
  * Plan Type
  * Renewal Date
  * ARR
* **Group: Health Score**
  * Current Score
  * Last Activity Date


## Related topics

- [Field List](/blocks/embedded/object/field-list.md)
- [Blocks](/blocks/overview.md)
- [Embedded Components](/blocks/embedded/overview.md)
- [History](/blocks/embedded/object/history.md)
- [Calendar & Meetings](/blocks/embedded/object/calendar.md)