---
title: "Дія custom_modules_list"
description: "Повертає список унікальних значень поля кастомного модуля для списків і випадаючих меню."
---

# Дія `custom_modules_list`

> **System ID:** `action_custom_modules_list`

## Опис

Отримує унікальні значення обраного поля з кастомного модуля (разом з ID записів) і формує обʼєкт списку для UI: випадаючі списки, автодоповнення тощо. Можна фільтрувати записи та обмежувати кількість елементів.

## Події (гілки сценарію)

Події-гілки немає. Дія повертає **обʼєкт списку** (не імʼя гілки):

```json
{
  "total": 0,
  "value": null,
  "list": []
}
```

Кожен елемент `list` зазвичай містить `id`, `text`, `value`. Якщо модуль або поле не задані / сталася помилка — повертається порожній обʼєкт зі `total: 0`.

## Параметри

| Параметр | Тип | Обовʼязковий | Типово | Опис |
|----------|-----|--------------|--------|------|
| `module_name` | string | Так | — | Alias (назва) кастомного модуля. Також приймається `model` |
| `field` | string | Так | — | Поле, з якого брати унікальні значення |
| `bot_id` | number | Ні | поточний бот | ID бота для модуля |
| `filters` | object | Ні | `null` | Фільтри записів (обʼєднуються з полями з констант користувача) |
| `limit` | number | Ні | `50` | Максимум елементів. `0` — без обмеження |

## Приклад конфігурації

```json
{
  "module_name": "product",
  "field": "category",
  "filters": {
    "status": "active"
  },
  "limit": 50
}
```

## Повʼязані документи

- [Довідник actions](/uk/actionjail/reference/actions-reference.md)