--- schema_version: "1" id: e9091ea444ad53e2ca07e832a51efa24bb681bb0e29833a2b4d29bbd908371cb title: Detailed Branding Tokens collection: developer version: current locale: en-us portal_url: https://docs.salesforce.com/developer/current/en-us/service-cloud/messaging-in-app/guides/android-colors-detailed-branding-tokens.md canonical_url: https://developer.salesforce.com/docs/service/messaging-in-app/guide/android-colors-detailed-branding-tokens.html source_site: developer.salesforce.com content_type: documentation content_hash: 0df02ecf1af41e798275934e8f2ddf0467d371e1aac8fa52a75ce3449b2843af products: - Enhanced In-App Chat - Service Cloud Developer Content --- # Detailed Branding Tokens Use these tokens if you want to configure specific elements of the app. When you change any of these detailed branding token values, it overrides the generic token used by that element. ## Header/General Colors | Detailed Token | Generic Token | Description | | --------------------------- | ------------------------- | ----------------------------- | | smi_banner_background | ​​smi_color_on_background | Banner background color | | smi_banner_text | ​​smi_color_background | Banner text color | | smi_chat_background | ​​smi_color_background | Chat window background color | | smi_cta_buttons | ​​smi_color_secondary | Call-to-action button color | | smi_cta_buttons_text | secondary | Call-to-action text color | | smi_image_viewer_background | smi_color_tertiary | Image viewer background color | | smi_navigation_background | ​​smi_color_primary | Navigation background color | | smi_navigation_icon | smi_color_on_primary | Navigation icon color | | smi_navigation_text | ​​smi_color_on_primary | Navigation text color | | smi_url_text | smi_color_secondary | Hyperlink text color | ## Bubble/Chat Colors | Detailed Token | Generic Token | Description | | --------------------------------------- | ---------------------------------------- | ------------------------------------------------- | | smi_avatar_background | ​​smi_color_secondary | Avatar background color | | smi_avatar_foreground | ​​smi_color_on_secondary | Avatar foreground color | | smi_chat_separator | smi_color_on_background_semi_transparent | Chat separator color | | smi_icon_error | smi_color_on_secondary | Error icon color that's used in the unknown entry | | smi_received_bubble_text | ​​smi_color_on_surface | Text color for incoming message bubble | | smi_received_bubble_background | ​​smi_color_surface | Background color for incoming chat bubble | | smi_received_bubble_border | ​​smi_color_surface_variant | Border color for incoming chat bubble | | smi_sent_bubble_background | ​​smi_color_secondary | Background color for outgoing chat bubble | | smi_sent_bubble_text | ​​smi_color_on_secondary | Text color for outgoing message bubble | | smi_timestamp | ​​smi_color_on_background | Timestamp text color | | smi_typing_indicator_text | ​​smi_color_on_background | Typing indicator color | | smi_unknown_entry_error_icon_background | smi_color_error | Error entry icon background color | ## Button Colors | Detailed Token | Generic Token | Description | | --------------------------------------- | ------------------------------ | --------------------------------------- | | smi_button_background | ​​smi_color_surface | Button background color | | smi_button_border | ​​smi_color_surface_variant | Button border color | | smi_button_disabled_background | ​​smi_color_surface | Disabled text background color | | smi_button_disabled_selected_background | smi_color_on_background | Disabled selected text background color | | smi_button_disabled_selected_text | smi_color_background | Disabled selected text color | | smi_button_disabled_text | ​​smi_color_on_background | Disabled text color | | smi_button_focus_background | ​​smi_color_on_surface_variant | Focus text background color | | smi_button_focus_text | ​​smi_color_surface | Focus text color | | smi_button_text | ​​smi_color_on_surface_variant | Button text color | | smi_list_picker_title_background | smi_color_surface | List picker title background color | | smi_list_picker_title_text | ​​smi_color_on_surface | List picker title text color | | smi_cancel_button_active | ​​smi_color_on_secondary | Cancel button active color | | smi_cancel_button_bg_active | ​​smi_color_on_background | Cancel button active background color | | smi_cancel_button_bg_pressed | ​​smi_color_secondary_active | Cancel button pressed background color | | smi_cancel_button_pressed | ​​smi_color_on_secondary | Cancel button pressed color | ## Camera Colors | Detailed Token | Generic Token | Description | | ---------------------------- | ----------------------------------------- | -------------------------------------- | | smi_camera_button_active | ​​smi_color_on_secondary | Camera button active color | | smi_camera_button_bg_active | ​​smi_color_on_secondary_transparent | Camera button active background color | | smi_camera_button_bg_focused | ​​smi_color_on_secondary_semi_transparent | Camera button focused background color | | smi_camera_button_bg_pressed | ​​smi_color_on_secondary | Camera button pressed background color | | smi_camera_button_focused | ​​smi_color_secondary | Camera button focused color | | smi_camera_button_pressed | ​​smi_color_on_secondary | Camera button pressed color | ## Card Colors | Detailed Token | Generic Token | Description | | ----------------------- | --------------------------- | --------------------------- | | smi_card_background | ​​smi_color_primary | Background color for a card | | smi_card_border | ​​smi_color_primary_variant | Border color for a card | | smi_card_headline_text | ​​smi_color_on_primary | Headline text for a card | | smi_card_subheader_text | ​​smi_color_primary_variant | Subheader text for a card | ## Carousels Colors | Detailed Token | Generic Token | Description | | ---------------------------------------- | ----------------------- | ------------------------------------------ | | smi_carousel_background | smi_color_surface | Carousel background color | | smi_carousel_button_background | smi_color_surface | Carousel button background color | | smi_carousel_button_text | smi_color_secondary | Carousel button text color | | smi_carousel_button_text_disabled | smi_color_on_background | Carousel button text disabled color | | smi_carousel_image_background | smi_color_primary | Carousel image background color | | smi_carousel_progress_indicator_active | smi_color_secondary | Carousel progress indicator active color | | smi_carousel_progress_indicator_inactive | smi_color_on_background | Carousel progress indicator inactive color | | smi_carousel_selected_highlight | smi_color_secondary | Carousel selected highlight color | | smi_carousel_selected_icon_foreground | smi_color_on_secondary | Carousel selected icon foreground color | | smi_carousel_selected_icon_background | smi_color_secondary | Carousel selected icon background color | | smi_carousel_sub_title_text | smi_color_on_primary | Carousel text subtitle color | | smi_carousel_title_text | smi_color_on_primary | Carousel text title color | ## Citation Colors | Detailed Token | Generic Token | Description | | -------------------------------------- | ----------------------------------- | --------------------------------------- | | smi_citations_source_button_background | smi_color_surface_secondary_variant | Citation source button background color | | smi_citations_source_button_text | smi_color_on_surface | Citation source button text color | ## End Chat Session Colors | Detailed Token | Generic Token | Description | | -------------------------------------------------- | ----------------------------------- | ------------------------------------------------ | | smi_end_chat_confirmation_background | smi_color_background | End chat confirmation screen background color | | smi_end_chat_confirmation_button_background | smi_color_secondary | End chat confirmation button color | | smi_end_chat_confirmation_button_border | smi_color_secondary | End chat confirmation button border color | | smi_end_chat_confirmation_button_cancel_background | smi_color_surface | End chat confirmation cancel button color | | smi_end_chat_confirmation_button_cancel_border | smi_color_on_surface_variant | End chat confirmation cancel button border color | | smi_end_chat_confirmation_button_cancel_text | smi_color_on_surface | End chat confirmation cancel button text color | | smi_end_chat_confirmation_button_text | smi_color_on_secondary | End chat confirmation button text color | | smi_end_chat_confirmation_text | smi_color_on_surface | End chat confirmation screen text color | | smi_end_chat_confirmation_progress_indicator | smi_color_secondary | End session progress indicator color | ## Fallback Message Screen Colors | Detailed Token | Generic Token | Description | | --------------------------------------------- | ----------------------------- | ----------------------------------------------------- | | smi_fallback_message_background | smi_color_background | Fallback message confirmation screen background color | | smi_fallback_message_confirmation_button | smi_color_secondary | Fallback message confirmation button color | | smi_fallback_message_confirmation_button_text | smi_color_on_secondary | Fallback message confirmation button text color | | smi_fallback_message_confirmation_text | smi_color_on_surface | Fallback message confirmation screen text color | ## File Type Placeholders | Detailed Token | Default Light Color | Default Dark Color | Description | | ------------------------- | ------------------- | ------------------ | ------------------------------------------ | | smi_color_file_icon_csv | #FF2E844A | #FF2E844A | Placeholder color for .csv files | | smi_color_file_icon_excel | #FF2E844A | #FF2E844A | Placeholder color for .xls and .xlsx files | | smi_color_file_icon_txt | #FFE4A201 | #FFE4A201 | Placeholder color for .txt files | | smi_color_file_icon_word | #FF107CAD | #FF107CAD | Placeholder color for .doc and .docx files | | smi_color_file_icon_xml | #FFF38303 | #FFF38303 | Placeholder color for .xml files | ## Icon Colors | Detailed Token | Generic Token | Description | | ----------------------------- | ------------------------- | ------------------------------- | | smi_icon_background | ​​smi_color_secondary | Icon background color | | smi_icon_background_secondary | smi_color_on_background | Icon secondary background color | | smi_icon_disabled | ​​smi_color_on_background | Icon disabled color | | smi_icon_foreground | ​​smi_color_on_secondary | Icon foreground color | ## Input Colors | Detailed Token | Generic Token | Description | | --------------------- | --------------------------- | ----------------------------------------------- | | smi_input_background | ​​smi_color_surface | Background color for text input field | | smi_input_border | ​​smi_color_surface_variant | Border color for text input field | | smi_input_text | ​​smi_color_on_surface | Text font color when typing a message | | smi_input_placeholder | ​​smi_color_on_background | Placeholder text color for the input text field | ## Loading Screen Colors | Detailed Token | Generic Token | Description | | --------------------------------------------- | --------------------------- | ----------------------------------------------- | | smi_loading_screen_avatar | smi_color_on_background | Loading screen avatar color | | smi_loading_screen_background | smi_color_background | Loading screen background color | | smi_loading_screen_input_text_placeholder | smi_color_surface_secondary | Loading screen input text placeholder color | | smi_loading_screen_received_bubble_background | smi_color_on_background | Loading screen received bubble background color | | smi_loading_screen_sent_bubble_background | smi_color_surface_secondary | Loading screen sent bubble background color | | smi_loading_screen_text_placeholder | smi_color_surface_secondary | Loading screen placeholder text color | ## Markdown Text Colors | Detailed Token | Generic Token | Description | | ------------------------------------- | --------------------------- | ----------------------------------------- | | smi_received_markdown_code_background | smi_color_background | Markdown code background color | | smi_received_markdown_code_text | smi_color_on_surface | Markdown code text color | | smi_received_markdown_horizontal_rule | smi_color_on_surface | Markdown horizontal rule background color | | smi_received_markdown_link_text | smi_color_secondary | Markdown link text color | ## Message Search Colors | Detailed Token | Generic Token | Description | | --------------------------------------------- | ---------------------------------------- | ------------------------------------- | | smi_message_search_input_bar | smi_color_on_background_semi_transparent | Search input bar color | | smi_message_search_highlight_background_agent | smi_color_surface_highlight | Highlighted background color for rep | | smi_message_search_highlight_background_user | smi_color_secondary_highlight | Highlighted background color for user | | smi_message_search_highlight_border_agent | smi_color_highlight | Highlighted border color for rep | | smi_message_search_highlight_border_user | smi_color_highlight | Highlighted border color for user | | smi_message_search_highlight_text_agent | smi_color_primary | Highlighted text color for rep | | smi_message_search_highlight_text_user | smi_color_primary | Highlighted text color for user | ## Participant Client Menu Colors | Detailed Token | Generic Token | Description | | ------------------------------------------------- | ---------------------------- | --------------------------------------- | | smi_participant_client_menu_background | smi_color_background | Client menu background color | | smi_participant_client_menu_item_background | smi_color_surface | Client menu item background color | | smi_participant_client_menu_item_focus_background | smi_color_on_surface_variant | Client menu item focus background color | | smi_participant_client_menu_item_icon | smi_color_secondary | Client menu item icon color | | smi_participant_client_menu_item_text | smi_color_on_surface | Client menu text item color | | smi_participant_client_menu_search_icon | smi_color_secondary | Client menu search icon color | | smi_participant_client_menu_button | smi_color_surface | Client menu button color | | smi_participant_client_menu_button_text | smi_color_on_surface | Client menu button text color | | smi_participant_client_menu_button_border | smi_color_surface_variant | Client menu button border color | | smi_participant_client_menu_button_selected | smi_color_on_surface_variant | Client menu button selected color | ## Pre-Chat Colors | Detailed Token | Generic Token | Description | | ---------------------------- | ---------------------------- | --------------------------------------------- | | smi_prechat_background | ​​smi_color_background | Pre-chat window background color | | smi_prechat_border | ​​smi_color_on_primary | Border color for text input field in pre-chat | | smi_prechat_button | ​​smi_color_secondary | Pre-chat button color | | smi_prechat_button_active | ​​smi_color_secondary_active | Pre-chat active button color | | smi_prechat_button_text | ​​smi_color_on_secondary | Pre-chat button text color | | smi_prechat_disabled | smi_color_surface_secondary | Disabled pre-chat field | | smi_prechat_error | ​​smi_color_error | Pre-chat error feedback color | | smi_prechat_input_background | ​​smi_color_surface | Pre-chat window background color | | smi_prechat_text | ​​smi_color_on_primary | Text color on pre-chat form | | smi_prechat_text_active | ​​smi_color_secondary | Color for the active pre-chat cell | ## Progress Indicator Colors | Detailed Token | Generic Token | Description | | ----------------------------------------- | -------------------------------- | ---------------------------------------------------- | | smi_notification_badge_background | smi_color_surface | Notification badge background color | | smi_notification_badge_counter_background | smi_color_error | Notification badge unread message counter background | | smi_notification_badge_counter_text | smi_color_surface | Notification badge unread message counter text color | | smi_notification_badge_icon | smi_color_on_surface | Notification badge icon color | | smi_notification_badge_outline | smi_color_surface_variant | Notification badge outline color | | smi_progress_indicator_icon_inner | smi_color_on_surface | Progress indicator animation icon inner arch color | | smi_progress_indicator_icon_outer | smi_color_on_surface | Progress indicator animation icon outer arch color | | smi_progress_indicator_text | smi_color_on_surface | Progress indicator label text color | ## Request Transcript Colors | Detail Token | Generic Token | Description | | -------------------------------------------- | ---------------------------- | ------------------------------------------------------ | | smi_transcript_background | smi_color_background | Request transcript screen background color | | smi_transcript_text | smi_color_on_surface | Request transcript screen text color | | smi_transcript_button_leave | smi_color_secondary | Request transcript leave button color | | smi_transcript_button_leave_border | smi_color_secondary | Request transcript leave button border color | | smi_transcript_button_leave_text | smi_color_on_secondary | Request transcript leave button text color | | smi_transcript_button_cancel | smi_color_surface | Request transcript cancel button color | | smi_transcript_button_cancel_border | smi_color_on_surface_variant | Request transcript cancel button border color | | smi_transcript_button_cancel_text | smi_color_on_surface | Request transcript cancel button text color | | smi_transcript_progress_indicator | smi_color_secondary | Request transcript progress indicator color | | smi_transcript_progress_indicator_background | smi_color_on_secondary | Request transcript progress indicator background color | ## Secure Forms Colors | Detailed Token | Generic Token | Description | | ------------------------------------------ | --------------------------- | ------------------------------------------------------------- | | smi_form_back_button | smi_color_on_secondary | Secure form back button background color | | smi_form_back_button_text | smi_color_secondary | Secure form back button text color | | smi_form_background | smi_color_background | Secure form background color | | smi_form_cell_icon_background_disabled | smi_color_surface_highlight | Secure form cell icon disabled background color | | smi_form_cell_icon_disabled | smi_color_primary | Secure form cell icon disabled color | | smi_form_confirmation_button_cancel | smi_color_surface | Secure form confirmation cancel button background color | | smi_form_confirmation_button_cancel_border | smi_color_on_surface | Secure form confirmation cancel button border text color | | smi_form_confirmation_button_cancel_text | smi_color_on_surface | Secure form confirmation cancel button text color | | smi_form_confirmation_button_leave | smi_color_secondary | Secure form confirmation window leave button background color | | smi_form_confirmation_button_leave_text | smi_color_on_secondary | Secure form confirmation window leave button text color | | smi_form_date_picker_icon | smi_color_secondary | Secure form date picker icon color | | smi_form_input_background | smi_color_background | Secure form input background color | | smi_form_input_border | smi_color_on_primary | Secure form input border color | | smi_form_input_border_active | smi_color_secondary | Secure form input border active color | | smi_form_input_border_error | smi_color_error | Secure form input border error color | | smi_form_input_footer_label | smi_color_on_primary | Secure form input footer label | | smi_form_input_text | smi_color_on_primary | Secure form input text color | | smi_form_input_title_text | smi_color_on_primary | Secure form input title text color | | smi_form_next_button | smi_color_secondary | Secure form next button background color | | smi_form_next_button_text | smi_color_on_secondary | Secure form next button text color | | smi_form_option_button_background | smi_color_primary | Secure form selectable option button background color | | smi_form_option_button_border | smi_color_on_primary | Secure form selectable option button border color | | smi_form_option_button_border_required | smi_color_error | Secure form selectable option button border required color | | smi_form_option_button_border_selected | smi_color_secondary | Secure form selectable option button border selected color | | smi_form_option_button_icon | smi_color_secondary | Secure form option icon button color | | smi_form_option_button_text | smi_color_on_primary | Secure form selectable option button text color | | smi_form_option_text_error | smi_color_error | Secure form selectable option text error color | | smi_form_option_title | smi_color_on_primary | Secure form selectable option title color | | smi_form_proress_bar_foreground | smi_color_secondary | Secure form progress bar foreground color | | smi_form_sub_title_text | smi_color_on_primary | Secure form subtitle text color | | smi_form_submit_button | smi_color_secondary | Secure form submit button color | | smi_form_submit_button_text | smi_color_on_secondary | Secure form submit button color text | | smi_form_title_text | smi_color_on_primary | Secure form title text color |