Skip to main content

branding

Feature summary

The branding feature allows you to customize the appearance of the Flex interface to better fit your brand. The "Twilio Flex" logo can be changed to your own graphic, and the colors for the header and side navigation can be modified.

Example screenshot

Branding feature

Configuration

The branding feature has several settings:

  • enabled - Set to true to enable the feature
  • custom_logo_url - If you would like to replace the Twilio Flex logo with your own, set this to the URL of your logo. It will be scaled to a maximum size of 240x36.
    • Tip: You may upload your logo as a serverless asset by placing it in the serverless-functions/src/assets directory. In this setting, place {{serverless.url}} within the URL to reference the serverless domain. For example, if my serverless asset is at serverless-functions/src/assets/logo.png, set this setting to {{serverless.url}}/logo.png.
  • use_custom_colors - Set to true to use the colors set in the custom_colors section below.
  • custom_colors - Colors to use when use_custom_colors is true. Each color must be a valid CSS color, such as hex or rgb format.
    • main_header_background - The background for the header across the top of the page.
      • Tip: Set this as a darker color to improve contrast.
    • side_nav_background - The background for the left-side navigation menu.
    • side_nav_border - The color of the border between the navigation menu and content.
    • side_nav_icon - The color of icons in the navigation menu.
    • side_nav_selected_icon - The color of the selected icon in the navigation menu.
    • side_nav_hover_background - The background when hovering a navigation item.
  • component_theme_overrides - Here you may configure any valid customizations via component theme overrides. This allows you to customize the CSS of any component exposed via Flex's theming interface.

How does it work?

For setting the logo, the MainHeader component exposes a logoUrl prop which can be set by this feature.

For setting the colors, the component theme overrides for the MainHeader and SideNav components are set.