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

# List preferences

> List effective preferences and defaults for the current owner.

<ParamField query="scope" type="string">
  `workspace` (default), `member`, or `user`. Personal scopes require a signed-in
  person. Workspace reads require `preferences:read` and an admin or viewer role.
</ParamField>

<ParamField query="count" type="boolean">
  Set to `true` to return only `{ "total": ... }` instead of the entries.
</ParamField>

### Returns

An object with a `data` array of [Preference objects](/reference/preferences/object).
The list includes defaults for unset keys in the selected scope. A scope with no
registered keys returns an empty array. This list is not paginated.