> ## 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 на вид, в порядке закрепления.
* Если у вида нет закреплённых определений, Foliant загружает первые 10 найденных для него метаполей.

Поэтому, чтобы метаполе точно выводилось, создайте для него определение и закрепите его в разделе **Настройки › Пользовательские данные**. Изменения определений могут появиться в документах в течение часа.

## Вывод метаполя

Замените `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, дата, цвет… | Значение в виде текста |
| Целое число, десятичное число | Число, которое можно сравнивать или использовать в вычислениях |
| Истина или ложь | `true` или `false` для `{% if %}` |
| Форматированный текст | Текст без форматирования |
| Вес, размер, объём | `.value` и `.unit`, например `{{ … .weight.value }} {{ … .weight.unit }}` |
| Деньги | `.value` (например, `23.00`) и `.unit` (код валюты). Не в центах. |
| Рейтинг | `.value`, `.scale_min` и `.scale_max` |
| JSON, списки | Список или объект, по которому можно пройти циклом |

## Полезно знать

* Пустое или отсутствующее метаполе ничего не выводит. Используйте `!= blank`, чтобы скрыть его подпись.
* В визуальных шаблонах выводите метаполя с помощью блока **Свой Liquid**.
* Листы сборки могут показывать метаполя товаров или вариантов в виде столбцов: это задаётся в настройках **Лист сборки** шаблона.

## Связанные статьи

* [Позиции в шаблонах](https://foliant-help.iforiti.com/ru/template-editor/liquid-line-items.md)
* [Атрибуты заказа и свойства позиций](https://foliant-help.iforiti.com/ru/template-editor/liquid-custom-fields.md)
* [Объект заказа и основные переменные](https://foliant-help.iforiti.com/ru/template-editor/liquid-order-variables.md)
* [Редактирование кода шаблона](https://foliant-help.iforiti.com/ru/template-editor/code-editor.md)


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