# List
Property Type: `list`
List types store an array of references. Lists are used to model One-to-Many Relationships.
### Property Options
| Name | Type | Default | Description |
| -------------------- | ---------------------------------------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| sourceObject | String | 0 | The name of the source object for the list. |
| grant | Access Level (Integer) See Access Levels | | This defines what level of access you have to the expanded list of object instances. |
| roles | ObjectID\[] | | This defines a set of roles to merge into the calling principal for access to the expanded object list. |
| skipAcl | Boolean | false | Select this if you'd like the matching to disregard all ACL rules. |
| where | String | | A stringified where clause consisting of local instance properties linking the list references. Example: "{"c\_doc\_ref": "{{input.\_id}}" }" |
| linkedProperty | String | | When set, connects the property to a top-level, indexed, readable, indexed, custom Reference in the sourceObject that points back to the current object.
When using a linked property, the where condition is augmented with {c\_parent: "{{input.\_id}}"}, which in many case makes the where clause obsolete.
When using write-through, newly created children will automatically set the liked property to the identifier of the list holder.
To further secure the relationship, the child reference can be marked as cascadeDelete:true and writable:false.
|
| readThrough | Boolean | false | Allows reading objects in a list using specific identifiers and overriding list rules (defaultAcl, grant, roles) |
| writeThrough | Boolean | false | Allows creating and updating objects in a list using specific identifiers and overriding list rules (createAcl/defaultAcl, grant, roles) |
| updateOnWriteThrough | Boolean | false | When true, write-through events bubble up to the current instance and modify the updated date, firing any triggers and updating the ETag where required. |
| inheritInstanceRoles | Boolean | false | When true, instance roles held by the caller on the current instance are applied to the list instances. |
| createAcl | Object\[] | \[] | An overriding set of acl rules to apply to creation of child object instances when write-through is enabled. |
| defaultAcl | Object\[] | \[] | An overriding set of acl rules to apply to reading of child object instances when read/write-through is enabled. |
**Base property options not available:**
* array
* indexed
* unique
* writable
* minItems
* maxItems
* canPull
* canPush
* maxShift
* writeOnCreate
##
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.medable.com/cortex-api/objects-definition/object-properties/list.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.