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

# 템플릿의 메타필드

> 템플릿에 주문, 임시 주문, 고객, 제품 및 이형 상품 메타필드를 출력하고, Foliant가 필요한 메타필드를 불러오는지 확인합니다.

메타필드는 직접 또는 앱이 Shopify에 저장하는 사용자 지정 데이터입니다. 주문의 선물 메시지, 제품의 관리 라벨, 고객의 계정 번호 등이 있습니다. 템플릿에서 Liquid로 메타필드를 출력할 수 있습니다. 코드 편집기의 **메타필드** 탭에서 종류별 구문을 확인할 수 있습니다.

## 시작하기 전에: Foliant가 불러오는 메타필드 확인하기

Foliant는 주문과 함께 메타필드를 불러오지만, 모든 메타필드를 불러올 수는 없습니다. 방식은 다음과 같습니다.

* 스토어에 **메타필드 정의**가 하나 이상 있어야 합니다(Shopify 관리자의 **설정 › 사용자 지정 데이터**). 정의가 하나도 없으면 메타필드를 불러오지 않습니다.
* 각 종류(주문, 임시 주문, 고객, 제품, 이형 상품)마다 Foliant는 **고정**한 정의를 종류당 최대 10개까지, 고정한 순서대로 불러옵니다.
* 고정한 정의가 없는 종류는 처음 찾은 메타필드 10개를 불러옵니다.

메타필드가 확실히 출력되도록 하려면 **설정 › 사용자 지정 데이터**에서 정의를 만들고 고정하세요. 정의 변경 사항이 문서에 반영되기까지 최대 1시간이 걸릴 수 있습니다.

## 메타필드 출력하기

`namespace`와 `key`를 메타필드의 네임스페이스와 키로 바꾸세요(예: `custom.gift_message`).

| 메타필드 대상 | Liquid |
| - | - |
| 주문 또는 임시 주문 | `{{ order.metafields.namespace.key }}` |
| 고객 | `{{ customer.metafields.namespace.key }}` |
| 제품 | `{{ line_item.product.metafields.namespace.key }}` |
| 이형 상품 | `{{ line_item.variant.metafields.namespace.key }}` |

제품 및 이형 상품 메타필드는 품목별로 다르므로 품목 반복문 안에서 사용하세요.

```liquid theme={null}
{% for line_item in line_items %}
  {{ line_item.title }}
  {% if line_item.product.metafields.custom.care_instructions != blank %}
    <br>{{ line_item.product.metafields.custom.care_instructions }}
  {% endif %}
{% endfor %}
```

## 메타필드 유형별 출력 방식

| 유형 | 출력 결과 |
| - | - |
| 텍스트, URL, 날짜, 색상 등 | 값이 텍스트로 출력됩니다 |
| 정수, 소수 | 비교하거나 계산할 수 있는 숫자입니다 |
| 참 또는 거짓 | `{% if %}`에 사용할 수 있는 `true` 또는 `false`입니다 |
| 서식 있는 텍스트 | 서식이 없는 텍스트입니다 |
| 무게, 치수, 부피 | `.value`와 `.unit`입니다. 예: `{{ … .weight.value }} {{ … .weight.unit }}` |
| 금액 | `.value`(예: `23.00`)와 `.unit`(통화 코드)입니다. 센트 단위가 아닙니다. |
| 평점 | `.value`, `.scale_min`, `.scale_max`입니다 |
| JSON, 목록 | 반복할 수 있는 목록 또는 객체입니다 |

## 참고 사항

* 비어 있거나 없는 메타필드는 아무것도 출력하지 않습니다. 라벨을 생략하려면 `!= blank`를 사용하세요.
* 시각적 템플릿에서는 **사용자 지정 Liquid** 블록으로 메타필드를 출력하세요.
* 피킹 목록에서는 템플릿의 **피킹 목록** 설정에서 제품 또는 이형 상품 메타필드를 열로 표시할 수 있습니다.

## 관련 문서

* [템플릿의 품목](https://foliant-help.iforiti.com/ko/template-editor/liquid-line-items.md)
* [주문 속성 및 품목 속성](https://foliant-help.iforiti.com/ko/template-editor/liquid-custom-fields.md)
* [주문 객체 및 일반 변수](https://foliant-help.iforiti.com/ko/template-editor/liquid-order-variables.md)
* [템플릿 코드 편집하기](https://foliant-help.iforiti.com/ko/template-editor/code-editor.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.