Technical Reference · 2026 Edition

Rekord DNS BIMI: Wyjaśnienie tagów l= i a=

Kompletna dokumentacja techniczna składni rekordu TXT BIMI, obejmująca tag l= dla logo i tag a= dla certyfikatu, obsługiwane konfiguracje oraz najczęstsze błędy.

Last updated min read

Kompletny rekord DNS BIMI

Rekord DNS BIMI (Brand Indicators for Message Identification) to pojedynczy rekord TXT, który informuje współpracujące klienty poczty elektronicznej, gdzie znaleźć logo Twojej marki, a także — gdy jest to wymagane — certyfikat potwierdzający, że jesteś jego właścicielem. Poprawna składnia jest bezwzględnie wymagana: pojedynczy błędnie sformatowany tag powoduje cichą awarię bez zwrotki, bez wpisu w logu błędów i bez wyświetlenia logo.

Ten artykuł omawia każdy komponent rekordu TXT BIMI, zasady dotyczące poszczególnych tagów, trzy kanoniczne konfiguracje rekordów oraz błędy konfiguracji, które cicho uniemożliwiają wyświetlanie logo.

Wymagania wstępne

Przed opublikowaniem rekordu BIMI upewnij się, że spełnione są następujące warunki:

  1. Polityka DMARC jest ustawiona na p=quarantine lub p=reject z co najmniej pct=100 (lub równoważnym poziomem egzekwowania).
  2. Twój plik logo jest w formacie SVG Tiny P/S i hostowany pod publicznie dostępnym adresem URL HTTPS.
  3. Jeśli kierujesz się do Gmail lub Apple Mail, posiadasz ważny VMC (Verified Mark Certificate) lub CMC (Common Mark Certificate) w formacie PEM, również hostowany pod publicznie dostępnym adresem URL HTTPS.

Struktura rekordu BIMI

Rekord TXT BIMI ma następującą ogólną składnię:

text
v=BIMI1; l=<logo-url>; a=<certificate-url>

| Tag | Nazwa | Wymagany | Opis | |-----|-------|----------|------| | v= | Wersja | Tak | Zawsze BIMI1. | | l= | URL logo | Tak | Adres URL HTTPS wskazujący na plik logo w formacie SVG Tiny P/S. | | a= | Dowód autorytetu | Warunkowo | Adres URL HTTPS wskazujący na VMC lub CMC w formacie PEM. Wymagany dla Gmail i Apple Mail. |

Rekord jest publikowany jako rekord DNS TXT w następującej subdomenie:

text
default._bimi.<twojadomena.com>
Uwaga: Selektor default jest standardowym selektorem używanym przez wszystkich głównych klientów poczty. Niestandardowe selektory są obsługiwane przez specyfikację, ale nie są jeszcze szeroko implementowane przez odbiorców.

Do czego służy

Tag l= podaje adres URL, z którego odbierający klienci poczty pobierają logo Twojej marki. Gdy wiadomość przejdzie weryfikację zgodności DMARC, klient pobiera ten plik i wyświetla go obok nazwy nadawcy.

Wymagania

  • Protokół: Musi być https://. Adresy URL HTTP są odrzucane.
  • Dostępność: URL musi być publicznie dostępny — bez uwierzytelniania, bez przekierowań, bez blokowania geograficznego. Serwery pocztowe pobierają ten URL ze swojej własnej infrastruktury, nie z przeglądarki.
  • Format pliku: Plik musi być zgodny z SVG Tiny P/S (Portable/Secure), ograniczonym podzbiorem SVG 1.2 Tiny. Standardowe pliki SVG nie przejdą walidacji, nawet jeśli poprawnie wyświetlają się w przeglądarce.
  • Nagłówek Content-Type: Serwer musi zwracać image/svg+xml.
  • Rozmiar pliku: Plik powinien mieć mniej niż 32 KB. Niektórzy odbiorcy stosują bardziej restrykcyjne limity.

Kluczowe ograniczenia SVG Tiny P/S

SVG Tiny P/S zabrania następujących elementów i atrybutów powszechnie występujących w standardowych plikach SVG:

  • Zewnętrzne odniesienia (, xlink:href wskazujący poza plik)
  • Skrypty (