> For the complete documentation index, see [llms.txt](https://help.smallbuilder.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.smallbuilder.com/ko/smallbuilder-lists/undefined-1-1/child-setup-optional/add-child.md).

# 하위 리스트 추가

리스트 구성기의 대상 개체와 **마스터-디테일** 또는 **조회** 관계로 연결된 하위 개체가 있는 경우, 해당 하위 개체를 기반으로 생성된 리스트 구성기를 하위 리스트로 연결할 수 있습니다. 이를 통해 리스트의 레코드와 그에 연결된 하위 레코드들을 한 화면에서 직관적으로 확인할 수 있습니다.

***

### :small\_orange\_diamond: 설정 방법

1\. 하위 리스트 추가(Add Child) 버튼을 클릭하여 하위 리스트 편집 화면으로 이동합니다.

<figure><img src="/files/d0cLBbHakyk9H9MF9Pzl" alt="" width="300"><figcaption></figcaption></figure>

2\. **하위 개체**, **상위 참조 필드**, **하위 리스트 구성기**를 차례로 선택하여 연결할 하위 리스트 설정을 완료합니다.

<figure><img src="/files/NlI4MGOaq4IhyXUzdcQt" alt="" width="300"><figcaption></figcaption></figure>

<table><thead><tr><th width="65" data-type="number">번호</th><th width="173">선택 항목</th><th>설명</th></tr></thead><tbody><tr><td>1</td><td>하위 개체</td><td>리스트의 대상 개체와 마스터-디테일 또는 조회 관계로 연결된 하위 개체가 검색됩니다.</td></tr><tr><td>2</td><td>상위 참조 필드</td><td>선택된 하위 개체의 필드 중 리스트의 대상 개체와 연결된 참조 필드가 표시됩니다.</td></tr><tr><td>3</td><td>하위 리스트 구성기</td><td>선택한 하위 개체를 기반으로 생성된 활성화 상태의 리스트 구성기가 검색됩니다.</td></tr></tbody></table>

3\. 저장(Save) 버튼을 클릭하여 하위 리스트를 추가합니다.

<figure><img src="/files/n57TtdzErhtse1rmpuqN" alt="" width="300"><figcaption></figcaption></figure>
