Follow the steps below for your logo to display correctly at participating mailbox providers. For details on all BIMI technical specifications, please visit:
Pre-work
- Make sure BIMI is supported.
- Contact your email administrator, email service provider, or domain hosting company and ask what steps are required to implement BIMI.
- If BIMI implementation is not covered under a service agreement, ask what steps you need to take to set it up yourself using the information below.
- Implement DMARC authentication on all marketing email.
- Passing DMARC is required for BIMI to work.
- Check email headers at Gmail, Microsoft, or Verizon Media (AOL and Yahoo!) in Return Path Platform to see if DMARC is passing.
- DMARC policy (p=) must be "quarantine" or "reject" for Verizon Media (AOL and Yahoo!), otherwise your logo will not display.
- Determine which logo your subscribers should see for your brand.
- BIMI requires the SVG (.svg) image format. Other image formats may be supported in the future.
- The image must be a square, centered, and only be your logo without text.
- Participating mailbox providers should size the image appropriately.
- Store your logo using HTTPS and note the URL string (e.g. https://subdomain.brand.com/image/logo.svg).
- Your logo will not display using HTTP.
- Be sure to update the image if you rebrand.
- If you change the location of your logo, your DNS TXT record will also need to be updated with the new URL.
- (Optional/Future) Obtain a Verified Mark Certificate.
- A Verified Mark Certificate is currently optional and issued by invitation only. It may be required in the future.
- If you do not have a Verified Mark Certificate, skip this step.
- Store your certificate using HTTPS and note the URL string (e.g. https://subdomain.brand.com/vmc/logo.pem).
- The URL is entered into the assertion record within the a= tag.
- A Verified Mark Certificate is currently optional and issued by invitation only. It may be required in the future.
- Determine how to measure success once BIMI is deployed.
- It is a good idea to have your "before BIMI" metrics so you can compare them to metrics after BIMI is implemented.
- Typical engagement metrics such as reads and click-throughs are good to track, but also look at revenue and average order value.
BIMI Implementation
Create the DNS TXT (text) record for your domain
- Choose your domain and selector.
- Note the "From:" domain (RFC5322) used in your marketing emails. This is the domain where you create the DNS TXT record.
- Choose a selector name. The selector name is what a mailbox provider uses to look up your BIMI record.
- Use the "default" selector name if:
- You have a single brand or testing one brand prior to implementing your other brands.
- There are technical constraints to adding the BIMI-selector header into your emails.
- Most senders use "default" to start because it is is faster to implement than choosing a selector name and inserting the BIMI-Selector header.
- Choosing "default" means that you aren't required to insert the BIMI-Selector header into your emails.
- Choose your selector name if:
- You plan on rolling out BIMI to multiple brands and you need more control over how the logos are displayed.
- A selector name is whatever you want it to be, but keep it short. Examples are: a date (July2019) or a brand name (brandabc).
- The selector name you choose should have meaning and purpose that makes sense for your business.
- You plan on rolling out BIMI to multiple brands and you need more control over how the logos are displayed.
- Use the "default" selector name if:
- Create a DNS TXT (text) record for the domain you noted above.
- Use the instructions provided by your email service provider or domain hosting company if you are creating the TXT record yourself.
- Be sure you use the correct syntax.
- Be sure you include all required tags in the assertion record.
Your DNS BIMI record should resemble one of the examples below (using your selector, domain, logo URL, and Verified Mark Certificate URL):
- No Verified Mark Certificate:
- brandx._bimi.brand.com IN TXT "v=BIMI1; l=https://subdomain.brand.com/image/logo.svg; a=;"
- With a Verified Mark Certificate:
- brandx._bimi.brand.com IN TXT "v=BIMI1; l=https://subdomain.brand.com/image/logo.svg; a=https://subdomain.brand.com/vmc/logo.pem;"
If you use the "default" selector name, it should resemble this:
- default._bimi.brand.com IN TXT "v=BIMI1; l=https://subdomain.brand.com/image/logo.svg; a=;"
Insert (sign) the BIMI-Selector header into your emails
If you are using the "default" selector name, it is not necessary to insert the BIMI-Selector header into your emails. Participating mailbox providers automatically look up your BIMI record using "default". Just make sure your DNS TXT record is accurate as demonstrated by the example above.
If you are using a selector name other than the "default" selector name:
- Consult your technical team or email service provider to determine the best way to insert it into your emails.
- Be sure the BIMI-Selector header has the correct syntax.
- Be sure the s= value in the BIMI-Selector header matches the selector name in the DNS exactly, or your logo will not display.