Technical Reference · 2026 Edition

Troubleshooting BIMI: Mengapa Logo Anda Tidak Muncul (Panduan Lengkap)

Diagnosis dan perbaiki 7 penyebab paling umum mengapa logo BIMI Anda tidak tampil di klien email. Mencakup kebijakan DMARC, validasi SVG, MIME type, sertifikat VMC/CMC, propagasi DNS, dan dukungan klien.

Last updated min read

Troubleshooting BIMI: Mengapa Logo Anda Tidak Muncul (Panduan Lengkap)

Brand Indicators for Message Identification (BIMI) memungkinkan penyedia layanan email menampilkan logo Anda di samping email yang terautentikasi. Ketika logo gagal muncul, penyebabnya hampir selalu salah satu dari tujuh masalah yang sudah terdefinisi dengan jelas. Panduan ini membahas setiap masalah secara berurutan berdasarkan frekuensi kemunculannya, memberikan langkah-langkah diagnostik yang tepat, dan menjelaskan cara memperbaikinya.


Sebelum Memulai: Cara Kerja Tampilan Logo BIMI

Ketika server email penerima memproses pesan masuk, server tersebut akan:

  1. Memeriksa apakah domain pengirim lolos DMARC dengan kebijakan yang ditegakkan.
  2. Mencari BIMI DNS TXT record di default._bimi.<domainanda>.
  3. Mengambil logo SVG dari URL yang tercantum di tag l=.
  4. (Untuk penyedia yang mensyaratkannya) Memvalidasi Verified Mark Certificate (VMC) atau Common Mark Certificate (CMC) dari URL yang tercantum di tag a=.
  5. Menampilkan logo di antarmuka inbox.

Kegagalan di tahap mana pun akan menyebabkan logo tidak ditampilkan secara diam-diam. Tidak ada pesan error yang ditunjukkan kepada pengirim maupun penerima.


Penyebab 1: Kebijakan DMARC Belum Berada di p=quarantine atau p=reject

Ini adalah penyebab paling umum mengapa logo BIMI tidak ditampilkan.

Setiap penyedia email yang mendukung BIMI — termasuk Google, Yahoo, Apple, Fastmail, dan lainnya — mensyaratkan kebijakan DMARC berupa p=quarantine atau p=reject sebelum mereka menampilkan logo. Kebijakan p=none dianggap sebagai tidak ada penegakan dan BIMI diabaikan sepenuhnya.

Cara Mendiagnosis

Lakukan DNS lookup pada DMARC record Anda:

text
dig TXT _dmarc.domainanda.com

Periksa nilai p= pada respons. Periksa juga:

  • sp= — kebijakan subdomain. Jika email Anda dikirim dari subdomain, sp=none akan memblokir BIMI pada subdomain tersebut meskipun domain utama sudah berada di p=reject.
  • pct= — tag persentase. Beberapa penyedia mensyaratkan pct=100. Nilai di bawah 100 dapat menyebabkan tampilan logo yang tidak konsisten.

Cara Memperbaiki

  1. Pastikan autentikasi email Anda (SPF dan DKIM) lolos secara konsisten sebelum menaikkan kebijakan.
  2. Naikkan DMARC dari p=none ke p=quarantine, pantau selama dua hingga empat minggu.
  3. Naikkan ke p=reject setelah Anda yakin tidak ada email sah yang gagal.
  4. Tetapkan pct=100 secara eksplisit.
  5. Jika mengirim dari subdomain, tambahkan sp=quarantine atau sp=reject.

Contoh DMARC record yang benar:

text
v=DMARC1; p=reject; sp=reject; pct=100; rua=mailto:[email protected];

Catatan: Menaikkan kebijakan DMARC Anda mempengaruhi pengiriman email. Jangan lewatkan fase pemantauan.


Penyebab 2: File SVG Tidak Dapat Diakses Melalui HTTPS

Server penyedia email mengambil logo Anda pada saat rendering. Jika file mengembalikan respons selain 200 OK yang valid melalui HTTPS, logo tidak akan ditampilkan.

Sub-penyebab Umum

Gejala Kemungkinan Penyebab
404 Not Found URL salah di tag l=, file dipindahkan atau dihapus
403 Forbidden CDN atau WAF memblokir user agent non-browser
301/302 Redirect Beberapa penyedia tidak mengikuti redirect
SSL certificate error Sertifikat TLS pada domain hosting kedaluwarsa atau self-signed
HTTP URL HTTP biasa tidak diterima; HTTPS wajib

Cara Mendiagnosis

  1. Salin URL persis dari tag l= Anda.
  2. Uji dengan curl untuk mensimulasikan pengambilan non-browser:
bash
curl -I "https://domainanda.com/bimi/logo.svg"
  1. Periksa kode status HTTP, header Content-Type, dan apakah terjadi redirect.
  2. Uji dari beberapa lokasi geografis atau gunakan pemeriksa header HTTP online untuk menyingkirkan kemungkinan geo-blocking.

Cara Memperbaiki

  1. Pastikan URL di BIMI DNS record Anda sama persis dengan path file yang di-hosting — termasuk sensitivitas huruf besar/kecil.
  2. Jika menggunakan CDN, whitelist user agent yang digunakan oleh penyedia email utama, atau konfigurasikan CDN untuk menyajikan file secara publik tanpa proteksi bot.
  3. Pastikan domain hosting memiliki sertifikat TLS yang valid dan tepercaya (bukan self-signed).
  4. Jika redirect tidak dapat dihindari, perbarui tag l= untuk mengarah langsung ke URL akhir.
  5. Verifikasi bahwa file dapat diakses dari luar jaringan Anda sendiri.

Penyebab 3: Server Mengembalikan MIME Type yang Salah

Meskipun file SVG dapat diakses, penyedia email memvalidasi header Content-Type yang dikembalikan oleh server Anda. MIME type yang benar adalah image/svg+xml. Nilai lain apa pun — termasuk text/plain, application/octet-stream, atau text/html — akan menyebabkan logo ditolak.

Cara Mendiagnosis

bash
curl -I "https://domainanda.com/bimi/logo.svg"

Cari baris Content-Type di header respons:

text
Content-Type: image/svg+xml

Jika Anda melihat nilai lain, berarti MIME type salah konfigurasi.

Cara Memperbaiki

Cara perbaikan bergantung pada web server atau platform hosting Anda.

Apache — tambahkan ke .htaccess atau konfigurasi server:

apache
AddType image/svg+xml .svg .svgz

Nginx — tambahkan ke mime.types atau blok server:

nginx
types {
    image/svg+xml svg svgz;
}

Amazon S3 / CloudFront — atur metadata Content-Type pada objek menjadi image/svg+xml saat mengunggah. S3 tidak menentukan MIME type secara otomatis.

Cloudflare Pages / Netlify — tambahkan file _headers:

text
/bimi/logo.svg
  Content-Type: image/svg+xml

Setelah melakukan perubahan, jalankan kembali pengecekan curl -I untuk memastikan header sudah benar.


Penyebab 4: File SVG Gagal Validasi W3C Tiny P/S

BIMI tidak menerima file SVG standar. Spesifikasi mensyaratkan SVG Tiny 1.2 Portable/Secure (SVG Tiny P/S), sebuah profil terbatas yang dirancang agar aman untuk di-render dalam konteks yang tidak tepercaya. Sebagian besar file SVG yang diekspor dari tools desain seperti Adobe Illustrator, Figma, atau Inkscape tidak sesuai dengan profil ini tanpa modifikasi.

Kegagalan Validasi Umum

Masalah Mengapa Gagal
baseProfile tidak ada atau salah Harus berupa baseProfile="tiny" di elemen <svg>
Atribut version="1.2" tidak ada Disyaratkan oleh spesifikasi
Gambar raster tertanam (<image>) Tidak diizinkan di Tiny P/S
JavaScript atau event handler Dilarang keras
Referensi eksternal atau <use> dengan href eksternal Tidak diizinkan
CSS @import atau stylesheet eksternal Tidak diizinkan
Filter, mask, atau gradient (di beberapa implementasi) Dukungan terbatas
File tidak dibungkus dengan <svg> sebagai elemen root Persyaratan struktural

Cara Mendiagnosis

  1. Buka SVG Anda di text editor dan periksa tag <svg> pembuka. Tag tersebut harus menyertakan:
xml
<svg xmlns="http://www.w3.