---
title: li-reference-list
description: "Removed in: [`release-2023-11`](/operations/releases/release-2023-11/). Use li-document-references instead."
---
Deprecated in: [`release-2023-09`](/operations/releases/release-2023-09/)

Removed in: [`release-2023-11`](/operations/releases/release-2023-11/)

## Supported Features

| Feature | Supported |
| ------- | :-------: |
| Document | ✔ |
| Media | ✔ |
| Include | ✔ |
| Document Creation Flow | ✗ |
| Push Message | ✗ |
| Usage Log | ✗ |
| Table Dashboard | ✗ |
| Display Filter | ✗ |
| Search Indexing | ✔ |
| System Metadata | ✗ |
| Planning System | ✗ |
| Webhook Conditions | ✗ |

## Description

With [`release-2022-11`](/operations/releases/release-2022-11/) this is superseeded by [`li-document-references`](/reference/document/metadata/plugins/li-document-references/llms.txt).

A list of references to other documents. A Document Selection Dialog is shown, based on shorthand queries and `useDashboard` to select documents.


## Default UI

Document selection dialog.

## Storage Format

```js
{
  $ref: 'documents',
  references: [
    {
      id: <String>
    }
  ]
}

```

## Content Type Config

```js
{
  handle: 'myContentType',
  // ...
  metadata: [
    {
      handle: 'myHandle'
      type: 'li-reference-list',
      config: {
        // common
        hideFromForm: false,                     // optional, default: false
        required: true,                          // optional, default: false
        requiredErrorMessage: 'Provide a value', // optional
        index: true,                             // optional, default: false. Added in release-2023-07
        // specific
        referenceType: 'documents',              // required, must be 'documents'
        documentType: 'article',                 // optional, one of article, page, data-record
        contentType: 'my-content-type',          // optional, content type handle (or array)
        min: 3,                                  // optional, minimum number of references
        max: 6                                   // optional, maximum number of references
      }
    }
    // ...
  ]
}
```