> ## Documentation Index
> Fetch the complete documentation index at: https://craft-support.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Collection을 위한 Gallery View

> Collection 항목을 이미지 미리보기가 있는 시각적 카드로 표시하세요. 포트폴리오, 미디어 라이브러리, 그리고 Craft에서의 시각적 프로젝트 추적에 이상적입니다.

Gallery View는 Collection 항목을 시각적 카드 그리드로 표시합니다. 각 카드에는 미리보기 이미지와 주요 속성이 한눈에 나타납니다.

<img src="https://mintcdn.com/craft-support/O98XYSKGXx3MbMYk/images/organize-and-find/collections/gallery-view/en/content/gallery-overview.png?fit=max&auto=format&n=O98XYSKGXx3MbMYk&q=85&s=8eba16ee100844a5b8d6c6eb257b8e49" alt="Gallery view showing a collection with image cards" width="1640" height="1003" data-path="images/organize-and-find/collections/gallery-view/en/content/gallery-overview.png" />

## Gallery 뷰 vs. 다른 뷰

모든 뷰는 동일한 데이터를 공유합니다. 뷰를 전환해도 항목이 삭제되거나 수정되지 않습니다.

| Gallery를 사용할 때...             | Table을 사용할 때...   | Kanban을 사용할 때...          |
| ----------------------------- | ----------------- | ------------------------- |
| 항목에 이미지나 시각적 콘텐츠가 있을 때        | 여러 필드를 나란히 비교할 때  | 단계별로 항목을 추적할 때 (할 일 → 완료) |
| 미리보기가 포함된 시각적 탐색 (포트폴리오, 미디어) | 스프레드시트 스타일로 편집할 때 | 시각적 워크플로 보드를 원할 때         |
| 미리보기가 포함된 간결한 개요              | 대량 데이터 입력 시       | 상태 변경이 자주 일어날 때           |

## Gallery View 만들기

<Steps>
  <Step>
    Collection 상단의 뷰 탭 옆에 있는 **+** 버튼을 클릭합니다
  </Step>

  <Step>
    **Add Gallery View**를 선택합니다

    <img src="https://mintcdn.com/craft-support/JSbjO49ZK2W8lx2w/images/organize-and-find/collections/gallery-view/en/content/add-view-menu.png?fit=max&auto=format&n=JSbjO49ZK2W8lx2w&q=85&s=a46a2d8ef257c02ef21c1f4dac89d581" alt="View menu showing Add Table View, Add Gallery View, and Add Kanban View options" width="1568" height="1026" data-path="images/organize-and-find/collections/gallery-view/en/content/add-view-menu.png" />
  </Step>

  <Step>
    새 Gallery View가 Collection 상단에 탭으로 나타납니다
  </Step>
</Steps>

## Table View로 전환하기

여러 뷰가 있는 경우 Collection 상단의 **Table** 뷰 탭을 클릭합니다. Gallery View만 있는 경우 구성 메뉴(⋯)에서 Table View를 추가하세요.

데이터는 항상 안전합니다. 뷰를 전환해도 항목이 변경되지 않습니다.

## 미리보기 유형

Gallery View는 **각 항목 페이지의 콘텐츠**에서 미리보기 이미지를 가져옵니다. 카드의 미리보기에 이미지를 추가하려면 항목을 열고 콘텐츠에 이미지 블록을 추가하세요.

<Tip title="카드 이미지는 어디에서 가져오나요?">
  Collection의 아무 항목이나 열고 페이지 콘텐츠에 이미지를 추가하세요. Gallery View가 해당 이미지를 카드 미리보기로 자동 사용합니다.
</Tip>

각 카드의 미리보기 영역 표시 방식을 제어할 수 있습니다:

* **Document** (기본값): 항목 페이지 콘텐츠의 미리보기를 표시
* **Fill**: 카드의 미리보기 영역을 항목 이미지로 채움
* **Immersive**: 이미지를 카드의 전체 배경으로 사용
* **미리보기 없음**: 미리보기 영역을 완전히 숨기고 속성만 표시

미리보기 유형은 **Gallery Options**에서 변경합니다(아래 참조).

## 카드 크기

Gallery View는 두 가지 카드 크기를 제공합니다:

* **Small**: 컴팩트한 그리드, 한 번에 더 많은 카드 표시
* **Large**: 더 큰 미리보기, 행당 더 적은 카드

<Frame>
  <video autoPlay muted loop playsInline>
    <source src="https://mintcdn.com/craft-support/O98XYSKGXx3MbMYk/images/organize-and-find/collections/gallery-view/en/content/card-sizes.mp4?fit=max&auto=format&n=O98XYSKGXx3MbMYk&q=85&s=c8d49129f6c66a3944fc52ec01af12ce" type="video/mp4" data-path="images/organize-and-find/collections/gallery-view/en/content/card-sizes.mp4" />
  </video>
</Frame>

## Gallery Options

구성 메뉴(⋯)에서 Gallery Options에 접근하여 뷰를 사용자 지정합니다:

* **Card Size**: Small 또는 Large
* **Preview**: Document, Fill, Immersive 또는 미리보기 없음
* **Limit visible fields**: 활성화 시(기본값), 카드에 제한된 수의 속성이 표시되고 나머지는 "+n" 표시기로 나타납니다. 모든 활성 필드를 각 카드에 표시하려면 이 옵션을 끄세요.
* **Fields**: 각 카드에 표시할 필드를 선택하고 표시 여부를 전환합니다

<Frame>
  <img src="https://mintcdn.com/craft-support/JSbjO49ZK2W8lx2w/images/organize-and-find/collections/gallery-view/en/content/gallery-options.png?fit=max&auto=format&n=JSbjO49ZK2W8lx2w&q=85&s=29c20f24f9dc7d44ee307c5e4b73cdeb" alt="Gallery Options panel" width="320" data-path="images/organize-and-find/collections/gallery-view/en/content/gallery-options.png" />
</Frame>

## Gallery 카드 작업하기

* **항목 열기**: 카드를 클릭하여 전체 페이지 열기
* **컨텍스트 메뉴**: 우클릭(Mac) 또는 길게 누르기(iOS)로 추가 옵션
* **카드 선택**: 클릭으로 선택, Shift+클릭으로 다중 선택

## 정렬, 필터링 및 그룹화

Gallery View는 정렬, 필터링 및 그룹화를 지원합니다. Table View에서 사용할 수 있는 것과 동일한 옵션입니다. 그룹화된 갤러리는 카드 그룹 사이에 섹션 헤더를 표시합니다.

<img src="https://mintcdn.com/craft-support/O98XYSKGXx3MbMYk/images/organize-and-find/collections/gallery-view/en/content/grouped-gallery.png?fit=max&auto=format&n=O98XYSKGXx3MbMYk&q=85&s=8b2ba86b81ff795834c9c6367f04d44b" alt="Grouped gallery view with section headers" width="1602" height="1009" data-path="images/organize-and-find/collections/gallery-view/en/content/grouped-gallery.png" />

정렬, 필터링 및 그룹화에 대한 자세한 설명은 [Collection Views](/ko/organize-and-find/collections/views)를 참조하세요.

## 문제 해결

<AccordionGroup>
  <Accordion title="카드에 이미지가 표시되지 않습니다">
    Gallery View는 **각 항목 페이지의 콘텐츠**에서 미리보기 이미지를 가져옵니다. 이미지를 추가하려면 카드를 클릭하여 항목을 열고, 페이지 콘텐츠에 이미지 블록을 추가하세요.

    또한 Gallery Options의 Preview 설정을 확인하세요. **Document** 또는 **Fill**로 설정합니다.
  </Accordion>

  <Accordion title="Gallery View 옵션을 찾을 수 없습니다">
    앱이 최신 버전인지 확인하세요. 앱 스토어에서 업데이트를 확인하거나 브라우저를 새로고침하세요.
  </Accordion>

  <Accordion title="항목이 많으면 Gallery가 느립니다">
    Gallery View는 스크롤할 때 이미지 미리보기를 로드합니다. 성능이 느리게 느껴지면 각 카드의 표시 속성 수를 줄여보세요.
  </Accordion>
</AccordionGroup>

## 관련 문서

<CardGroup cols={2}>
  <Card title="Collections" href="/ko/organize-and-find/collections">
    Craft Collections와 필드 유형에 대해 알아보기
  </Card>

  <Card title="Collection Views" href="/ko/organize-and-find/collections/views">
    정렬, 필터링 및 그룹화로 뷰 만들기
  </Card>

  <Card title="Kanban 뷰" href="/ko/organize-and-find/collections/kanban-view">
    상태 또는 선택 필드 기준으로 항목을 드래그 앤 드롭 열로 정리하기
  </Card>

  <Card title="필드 및 열 재정렬" href="/ko/organize-and-find/collections/reordering">
    Collections의 필드 및 열 순서 사용자 지정
  </Card>

  <Card title="iOS에서 Collections 사용하기" href="/ko/organize-and-find/collections/ios-guide">
    iPhone 및 iPad의 터치 최적화된 Collections
  </Card>
</CardGroup>