HTML-письмо: как сверстать и отправить, чтобы оно не сломалось в Яндексе, Mail.ru и Gmail

HTML-письмо: как сверстать и отправить, чтобы оно не сломалось в Яндексе, Mail.ru и Gmail

HTML-письмо, которое одинаково выглядит в Яндекс Почте, Mail.ru и Gmail, верстают как веб-страницу двадцатилетней давности: таблицами, со стилями в атрибутах style, шириной около 600 пикселей, с картинками по абсолютным HTTPS-ссылкам и обязательной текстовой версией. Размер HTML держат меньше 102 КБ, иначе Gmail обрежет письмо. Ниже — рабочий шаблон, который можно взять за основу, и разбор каждого решения в нём.

Отдельно разберём, как отправить HTML-письмо из кода по SMTP и через API, как вставить HTML в письмо из веб-интерфейса почты и что делать с тёмной темой.

Чем HTML-письмо отличается от веб-страницы

Браузер у читателя письма не один. Веб-интерфейсы Gmail, Яндекс Почты и Mail.ru встраивают ваш HTML в свою страницу и перед этим чистят его: выбрасывают скрипты, формы, внешние таблицы стилей и часть CSS-свойств. Мобильные приложения рендерят письмо своим движком. Outlook для Windows показывает HTML через движок Microsoft Word, который не знает ни flexbox, ни grid, ни половины свойств блочной модели.

Отсюда правила, на которых держится вся вёрстка писем:

  • никакого JavaScript: он не выполнится нигде;
  • раскладка таблицами, а не div с float или flex;
  • стили в атрибуте style у каждого элемента, блок <style> только как дополнение;
  • картинки по абсолютным ссылкам, без локальных путей;
  • ширина фиксированная, с адаптацией под мобильные через медиазапрос.

Минимальный рабочий шаблон

Шаблон ниже корректно отображается в основных почтовых клиентах: одна колонка, логотип, заголовок, абзац, кнопка и подвал.

<!DOCTYPE html>
<html lang="ru">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <meta name="color-scheme" content="light dark">
  <meta name="supported-color-schemes" content="light dark">
  <title>Заказ №4417 принят</title>
  <style>
    @media (max-width: 620px) {
      .container { width: 100% !important; }
      .px { padding-left: 16px !important; padding-right: 16px !important; }
    }
    @media (prefers-color-scheme: dark) {
      .bg { background-color: #161b22 !important; }
      .card { background-color: #22272e !important; }
      .text { color: #e6edf3 !important; }
    }
  </style>
</head>
<body style="margin:0; padding:0; background-color:#f4f5f7;">
  <table role="presentation" width="100%" cellpadding="0" cellspacing="0" border="0"
         class="bg" style="background-color:#f4f5f7;">
    <tr>
      <td align="center" style="padding:24px 0;">
        <table role="presentation" width="600" cellpadding="0" cellspacing="0" border="0"
               class="container card" style="width:600px; max-width:600px; background-color:#ffffff;">
          <tr>
            <td class="px" style="padding:24px 32px;">
              <img src="https://example.ru/email/logo.png" width="120" height="32"
                   alt="Магазин" style="display:block; border:0;">
            </td>
          </tr>
          <tr>
            <td class="px text" style="padding:0 32px 24px; font-family:Arial, Helvetica, sans-serif;
                font-size:16px; line-height:24px; color:#1f2328;">
              <h1 style="margin:0 0 16px; font-size:22px; line-height:28px;">Заказ №4417 принят</h1>
              <p style="margin:0 0 16px;">Доставим завтра до 18:00. Статус заказа виден в личном кабинете.</p>
              <table role="presentation" cellpadding="0" cellspacing="0" border="0">
                <tr>
                  <td style="border-radius:6px; background-color:#3b5bdb;">
                    <a href="https://example.ru/orders/4417"
                       style="display:inline-block; padding:12px 24px; font-family:Arial, Helvetica, sans-serif;
                              font-size:16px; color:#ffffff; text-decoration:none;">Открыть заказ</a>
                  </td>
                </tr>
              </table>
            </td>
          </tr>
          <tr>
            <td class="px" style="padding:16px 32px 24px; font-family:Arial, Helvetica, sans-serif;
                font-size:12px; line-height:18px; color:#6a737d;">
              ООО «Магазин», Москва. Письмо отправлено, потому что вы оформили заказ на example.ru.
            </td>
          </tr>
        </table>
      </td>
    </tr>
  </table>
</body>
</html>

Дальше по порядку разберём, почему он устроен именно так.

Вёрстка таблицами

Внешняя таблица шириной 100% задаёт фон всего письма, внутренняя шириной 600 пикселей — карточку с содержимым. Атрибуты cellpadding="0" cellspacing="0" border="0" убирают отступы, которые некоторые клиенты добавляют по умолчанию, а role="presentation" говорит экранным читалкам, что таблица служит раскладкой и данных в ней нет.

Несколько колонок делают вложенными таблицами или ячейками одной строки. Отступы задают через padding у td: margin у блочных элементов Outlook для Windows понимает плохо. Кнопка тоже собрана из таблицы: фон и скругление на ячейке, ссылка внутри. Кнопка из одной ссылки со стилями padding и background в Outlook теряет отступы.

CSS: инлайн плюс блок в head

Gmail поддерживает блок <style> в <head>, селекторы по классу, элементу и id и медиазапросы по ширине экрана. Но приложения Gmail не применяют <style>, когда показывают письмо из ящика другого провайдера, подключённого через IMAP, а часть клиентов вырезает блок целиком. Поэтому цвета, шрифты, размеры и отступы, без которых письмо нечитаемо, пишут прямо в style. Блок в <head> отвечает только за улучшения: адаптацию под узкий экран и тёмную тему.

Вручную расставлять стили по сотне элементов незачем. Верстайте с классами, а перед отправкой прогоняйте HTML через инлайнер: Premailer, Juice или инлайнер, встроенный во фреймворк для писем вроде MJML.

Шрифты — системные: Arial, Helvetica, Georgia, Verdana. Веб-шрифты через @import или <link> большинство клиентов не загрузит, и письмо отобразится шрифтом по умолчанию. Если фирменный шрифт обязателен, указывайте его первым в font-family, а системный — следом.

Ширина и мобильные

600 пикселей — ширина, которая помещается в панель чтения веб-почты рядом со списком писем. На телефоне медиазапрос max-width: 620px растягивает карточку на всю ширину и уменьшает боковые отступы. Если клиент медиазапрос не поддержит, письмо всё равно останется читаемым: max-width:600px в инлайн-стиле не даст карточке вылезти за экран в большинстве клиентов.

Мета-тег viewport нужен клиентам, которые показывают письмо как отдельную страницу. Размер основного текста держите не меньше 14–16 пикселей, кнопки — не ниже 44 пикселей по высоте, чтобы в них попадал палец.

Картинки: хостинг, размеры и alt

Картинку в письме загружает почтовый клиент читателя, поэтому она должна лежать на вашем сервере или CDN и подключаться по абсолютной ссылке https://. Gmail и другие сервисы забирают картинки через свои прокси, так что сервер должен отвечать быстро и без авторизации.

  • Указывайте width и height атрибутами. Без них Outlook покажет картинку в исходном размере, а письмо с выключенной загрузкой картинок «прыгнет» при включении.
  • Пишите alt. Часть читателей видит письмо с отключёнными картинками, и вместо логотипа они прочитают «Магазин», а вместо баннера — его смысл.
  • Добавляйте display:block у картинок в ячейках, иначе под ними появится щель в несколько пикселей.
  • Не встраивайте картинки в base64. Такая картинка лежит внутри HTML, раздувает его размер и не показывается в части клиентов.
  • Не делайте письмо из одной картинки. Текст в картинке не прочитать с отключённой загрузкой, не найти поиском, а фильтры спама относятся к таким письмам с подозрением.

Тёмная тема

Почтовые клиенты обращаются с тёмной темой по-разному, и полностью управлять ею нельзя. Mail.ru в веб-версии и приложениях для iOS и Android поддерживает медиазапрос prefers-color-scheme: стили внутри него не перекрашиваются автоматически и применяются только в тёмной теме. Apple Mail тоже его понимает. Gmail в мобильных приложениях медиазапрос игнорирует и инвертирует цвета сам. Яндекс Почта в мобильном приложении затемняет светлые письма и оставляет тёмные как есть.

Что из этого следует на практике:

  • объявите поддержку мета-тегами color-scheme и supported-color-schemes, как в шаблоне выше;
  • задайте свои тёмные цвета в @media (prefers-color-scheme: dark) с !important для клиентов, которые его читают;
  • делайте логотип в PNG с прозрачным фоном и светлой обводкой, чтобы он читался на любом фоне;
  • не передавайте смысл только цветом: красная надпись «Оплата не прошла» после инверсии может стать розовой и потерять акцент.

Текстовая версия письма

Правильное HTML-письмо уходит как multipart/alternative: внутри HTML-часть и text/plain с тем же смыслом. Текстовую часть показывают клиенты без HTML, часы, читалки, и по ней же фильтры спама сверяют содержание: письмо, у которого две части говорят о разном, выглядит подозрительно.

В FMailer письмо всегда уходит с обеими частями. Если передать в API поле text, оно уйдёт как есть; если не передать, сервис соберёт текстовую версию из HTML сам: уберёт теги, раскодирует сущности и вынесет адреса ссылок после их текста. Автоматическая версия не знает, что в вёрстке было украшением, поэтому для важных писем текст лучше написать самому.

Размер письма и обрезка в Gmail

Gmail обрезает письма, у которых HTML больше примерно 102 КБ: внизу появляется «[Message clipped]» и ссылка «View entire message». Сам Google эту цифру не публикует: она известна из документации Mailchimp, Litmus и других сервисов рассылок, которые предупреждают именно о ней. Считается размер HTML-кода, а не картинок по ссылкам.

Обрезка бьёт по двум вещам. Читатель не видит подвал, где обычно ссылка отписки и реквизиты. И пропадает пиксель открытий, который почти всегда стоит в конце письма: открытие не будет засчитано. Держите HTML в пределах 60–80 КБ: убирайте лишние комментарии и пробелы, повторяющиеся инлайн-стили и длинные UTM-метки.

Вложения считаются отдельно. В API FMailer до 20 файлов по 10 МБ и 10 МБ суммарно на письмо, а всё тело запроса вместе с base64 — до 16 МБ. Тяжёлый PDF лучше отдавать ссылкой.

Как вставить HTML в письмо из почты

У веб-интерфейсов Gmail, Яндекс Почты и Mail.ru нет режима редактирования исходного кода письма. Если нужно отправить свёрстанное письмо руками, есть три способа:

  1. Открыть HTML в браузере и скопировать. Выделите страницу, скопируйте и вставьте в окно нового письма. Перенесётся отрисованная вёрстка, а не код, поэтому медиазапросы и стили из <head> потеряются.
  2. Отредактировать поле письма через инструменты разработчика. В окне нового письма откройте DevTools, найдите элемент с текстом письма, выберите «Edit as HTML» и вставьте код. Способ работает, но после вставки нельзя ничего править в визуальном редакторе: он перепишет разметку.
  3. Почтовый клиент. В Thunderbird в окне нового письма есть пункт «Вставка → HTML», куда код вставляется как есть.

Для регулярной отправки, тем более по списку, руками это делать не нужно: отправляйте из кода.

Как отправить HTML-письмо из кода

По SMTP

В Python письмо с двумя частями собирается стандартной библиотекой:

import smtplib
from email.message import EmailMessage

html = open("order.html", encoding="utf-8").read()

msg = EmailMessage()
msg["From"] = "Магазин <noreply@mail.example.ru>"
msg["To"] = "client@example.ru"
msg["Subject"] = "Заказ №4417 принят"
msg.set_content("Заказ №4417 принят. Доставим завтра до 18:00.\nЗаказ: https://example.ru/orders/4417")
msg.add_alternative(html, subtype="html")

with smtplib.SMTP("smtp.fmailer.ru", 587) as smtp:
    smtp.starttls()
    smtp.login("<логин токена>", "<пароль токена>")
    smtp.send_message(msg)

set_content задаёт текстовую часть, add_alternative добавляет HTML и превращает письмо в multipart/alternative. Настройки для других языков и фреймворков — в документации по SMTP.

Через REST API

В API HTML передаётся в поле body, текстовая версия — в text:

import requests

html = open("order.html", encoding="utf-8").read()

requests.post(
    "https://api.fmailer.ru/external/send_email_simple/",
    json={
        "recipient": "client@example.ru",
        "sender": "Магазин <noreply@mail.example.ru>",
        "subject": "Заказ №4417 принят",
        "body": html,
        "text": "Заказ №4417 принят. Доставим завтра до 18:00.\nЗаказ: https://example.ru/orders/4417",
        "idempotency_key": "order-4417",
        "auth": {"username": "<логин токена>", "password": "<пароль токена>"},
    },
    timeout=10,
)

Две особенности FMailer, которые касаются вёрстки. Пиксель открытий вставляется перед закрывающим </body>, поэтому отправляйте полный документ: у фрагмента без </body> открытия не посчитаются. И отслеживание кликов, если включить его для домена, переписывает ссылки только в письмах, отправленных через API: по SMTP приходит готовый MIME, и править его небезопасно. Все поля описаны в документации по API.

Шаблоны: вёрстка на стороне сервиса

Если HTML-письма меняет маркетинг, а не разработчик, держать вёрстку в коде неудобно: каждая правка текста становится релизом. В FMailer шаблон хранится в панели, а приложение передаёт только slug, язык и параметры:

{
    "recipient": "client@example.ru",
    "tpl": "order-confirmed",
    "lang": "ru",
    "sender": "Магазин <noreply@mail.example.ru>",
    "params": {"name": "Алексей", "order": "4417", "delivery": "завтра до 18:00"},
    "auth": {"username": "<логин токена>", "password": "<пароль токена>"}
}

Синтаксис переменных похож на Jinja2: {{ order }} вставляет значение, {% if promo %}…{% endif %} показывает блок по условию, доступны и циклы. У шаблона может быть отдельная версия для каждого языка, а если нужной нет, берётся язык по умолчанию. Общие элементы (логотип, фирменный цвет, подвал) задаются в настройках оформления домена и оборачивают содержимое каждого шаблонного письма, так что в шаблоне вы пишете только смысловую часть. В панели есть предпросмотр с тестовыми значениями: на нём видно незакрытый тег или опечатку в имени переменной до отправки. Подробнее — на странице о шаблонах.

Письмо, отправленное через send_email_simple с готовым body, оформлением домена не оборачивается и уходит в том виде, в каком вы его передали.

Как тестировать HTML-письмо

  1. Отправьте себе на ящики основных провайдеров вашей аудитории: Gmail, Яндекс, Mail.ru, плюс Outlook, если у вас корпоративные клиенты. Смотрите веб-версию и мобильное приложение каждого.
  2. Проверьте с отключёнными картинками. Письмо должно читаться по тексту и alt.
  3. Включите тёмную тему в приложениях Gmail, Яндекс Почты и Mail.ru.
  4. Проверьте размер: сохраните HTML в файл и посмотрите, сколько он весит.
  5. Откройте исходник полученного письма и вставьте заголовки в анализатор заголовков: он покажет, прошли ли SPF, DKIM и DMARC и через какие серверы шло письмо.

Учтите: Gmail склеивает тестовые письма с одинаковой темой в цепочку, а длинная цепочка сама по себе может обрезаться. Меняйте тему между тестами.

Частые ошибки

Вёрстка на div и flexbox. В браузере всё выглядит идеально, в Outlook колонки съезжают друг под друга, а в части клиентов пропадают отступы.

Стили только в <head>. Клиент, который вырежет блок <style>, покажет письмо без оформления.

Скрытый текст. Прехедеры и служебные блоки с display:none, нулевым размером шрифта или белым текстом на белом фоне фильтры спама считают попыткой спрятать содержимое. Проверка содержимого в FMailer тоже считает такой текст сильным признаком спама. Текст для превью в списке писем лучше сделать видимой первой строкой.

Картинка вместо письма. Баннер на весь экран без текста не читается с отключёнными картинками и похож на рекламу.

Нет текстовой версии или она пустая. Письмо без text/plain хуже оценивают фильтры, а автоматическая версия из вёрстки может читаться как набор обрывков.

HTML больше 102 КБ. Gmail обрежет подвал со ссылкой отписки и пиксель открытий.

Ссылки с несовпадающим текстом. Ссылка, у которой видимый текст — один домен, а адрес перехода — другой, выглядит как фишинг и для получателей, и для фильтров.

Частые вопросы

Можно ли отправить HTML-письмо из Gmail или Яндекс Почты без программирования?

Можно, но неудобно. Веб-интерфейсы не дают редактировать исходный код, поэтому HTML копируют из браузера, вставляют через инструменты разработчика или отправляют из Thunderbird через «Вставка → HTML». Для регулярных писем и рассылок проще отправлять из кода по SMTP или через API.

Какую ширину выбрать для HTML-письма?

Около 600 пикселей для основной колонки и медиазапрос, который растягивает её на всю ширину на телефоне. Эта ширина давно стала стандартом: она помещается в панель чтения веб-почты и в окно почтовой программы на ноутбуке.

Почему письмо выглядит по-разному в Mail.ru и Gmail?

Каждый сервис по-своему чистит HTML и поддерживает разный набор CSS. Mail.ru, например, понимает медиазапрос тёмной темы, а приложения Gmail его игнорируют и перекрашивают письмо сами. Инлайн-стили и табличная вёрстка уменьшают разницу, но проверять письмо всё равно нужно в каждом клиенте.

Нужно ли писать текстовую версию, если есть HTML?

Да. Письмо из двух частей правильнее с точки зрения стандарта, лучше оценивается фильтрами и читается там, где HTML не показывают. FMailer соберёт текст из HTML, если вы его не передадите, но написанная руками версия точнее.

Где взять шаблон HTML-письма?

Базовый шаблон есть в этой статье: одна колонка, логотип, заголовок, текст, кнопка и подвал. Для сложных писем удобны фреймворки вроде MJML, которые компилируют компактную разметку в табличный HTML с инлайн-стилями. Если вёрстку должны менять без релизов, храните её в шаблонах на стороне сервиса отправки.

Итог

HTML-письмо, которое не ломается в Яндексе, Mail.ru и Gmail, собирают по старым правилам: таблицы, инлайн-стили, ширина около 600 пикселей, картинки по HTTPS с размерами и alt, видимый текст вместо скрытого и текстовая версия рядом с HTML. Тёмную тему полностью контролировать нельзя, поэтому выбирайте цвета и логотип, которые переживут инверсию. Держите HTML меньше 102 КБ и проверяйте каждое письмо на реальных ящиках перед отправкой.

Попробовать FMailer

Подключите домен на fmailer.ru и отправляйте HTML-письма по SMTP или через API: с подписью DKIM вашего домена, текстовой версией, собранной автоматически, если вы её не передали, и журналом с ответом сервера получателя. Вёрстку, которую правит не разработчик, можно перенести в шаблоны с языковыми версиями и предпросмотром.

Подключить домен на fmailer.ru →