Skip to main content

Using Borders on Buttons in Dark Mode

Learn how to improve button visibility in dark mode email clients by adding borders to your buttons.

This information mostly applies to email clients that do not support Dark Mode editing. Email clients that support Dark Mode editing give you more control over how your email appears in Dark Mode. Learn more in the Dark Mode Editing article.

Why Button Borders Matter in Dark Mode

Some email clients automatically change email backgrounds when dark mode is enabled. Your button colors may stay the same. This can cause dark buttons to blend into dark backgrounds.

This issue is common in:

  • Outlook for Mac

  • Outlook for Windows

  • Outlook.com webmail

  • Outlook mobile apps

Adding a border to your button can improve contrast. This makes your button easier to see in dark mode.

For more control over dark mode styling, see Dark Mode Editing.


How Button Borders Work

Use a border color that matches your email body background.

In light mode:

  • The border blends into the background.

  • The button looks unchanged.

In dark mode:

  • The background may become darker.

  • The border color may remain unchanged.

  • The button stands out more clearly.

Light Mode Example

Both buttons appear the same in light mode.

Buttons with and without borders may not appear in Knak light mode

Dark Mode Example

The bordered button remains visible against the dark background.

Buttons with border remains visbile in Dark Mode Email tests

Add Borders to Buttons in Knak

  1. Open your asset in Knak.

  2. Drag and drop a Button element into your layout.

  3. Select the button.

  4. Expand the Border settings.

  5. Adjust the border settings as needed.

Button attributes with border settings expanded.

Recommended: Match the border color to the email background color used in your light mode editing view.


Review Border Recommendations in the Optimize Tab

Knak can identify buttons that may have visibility issues in dark mode.

  1. Open the Optimize tab.

  2. Review warnings for buttons without borders.

  3. Click Highlight to locate the button.

  4. Click Edit to update the button manually.

  5. Click Apply Border to add a recommended border automatically.

Button border warnings appear under the optimize tab, it is best to match the button border to the light mode background color

Need more help? Contact support via live chat within Knak using the chat bubble in the bottom right corner or email support@knak.com.

Did this answer your question?