The Messenger settings are divided into the following sections. We’ll go through what each of them contains and how to manage them below.
Widget (standard Widget Messenger)
Content
Appearance
Spotlight (designed for Fin for Sales)
Mobile SDKs
Content
Appearance
Conversations
With teammates
With Fin
General
Install
Security
Note: You must have the "Can access Messenger settings" permission to manage Messenger settings.
Widget
This is where you manage the standard Messenger widget for your website.
Content
In Settings > Messenger > Widget > Content, you can configure your customer's initial experience with the Widget Messenger, from the Messenger Launcher to the Messenger Home.
Terminology:
Messenger Launcher - the chat bubble/circle (as you see at the bottom right of your screen now 😉).
Messenger Home - the Home space which opens when customers click the Messenger Launcher for the first time.
Note: Certain branding capabilities are restricted depending on your subscription plan.
Spaces
This is where you control which spaces your visitors and users see in the Widget Messenger by adding or removing them.
Home - A space to make your own and decide exactly what you want to display to your visitors and users.
Messages - A space for conversation management. Both inbound and outbound conversations will live here.
Tickets - A space for all Tickets to live, separate from conversations.
Help - A space for customers to access a full, in-context Help Center from anywhere in your product.
News - A space for your News feed, suitable for a variety of announcement types and curated for each customer. (Opt-in available.)
Tasks - A space where customers can complete your custom Checklists when onboarding or using your product to its full potential. (Opt-in available.)
Messages is a permanent space in the Widget Messenger and can’t be turned off.
Reorder how the spaces appear by using drag and drop. The Home Space will always remain at the top, but it can be turned off if you’d like to remove it from your Widget Messenger.
Launch directly into Conversation
You can configure your Widget Messenger to bypass the Home space and launch directly into the Conversation space.
Note: This feature is supported on Mobile SDK versions 18.6.3 for iOS and 15.15.0 for Android. It is not yet supported for Cordova or React Native.
This gives customers faster access to support, removing additional steps to starting a new chat with your team. Enabling this will maintain easy access to your other Widget Messenger spaces such as help articles, previous conversations, and tickets (if enabled).
The "Launch directly into a Conversation" setting can be configured separately for visitors, users, and mobile users.
Note: The Widget Messenger won't launch directly into the Conversation space if:
"Let visitors/users start a conversation" is disabled, OR
"Require visitors/users search before starting a conversation" is enabled.
In these cases, the Messenger will always open in the default space (Home/Messages), even if “Launch directly into a Conversation” is turned on.
Set your welcome message
Choose how you’d like to greet people and introduce yourself when they open the Widget Messenger.
Tip: This can be configured to support up to 45 languages from Settings > Messenger > General > Choose supported languages.
Customize Home with apps
Customize the Widget Messenger Home by adding and removing apps. Choose whether customers can start a conversation with you, search for articles in your Help Center, see featured News announcements, or view any other custom apps.
Note: The Widget Messenger Home needs at least one app.
Show the Messenger Launcher
The Widget Messenger allows you to show or hide the Messenger Launcher from visitors and/or users based on audience rules.
Appearance
In Settings > Messenger > Widget > Appearance, you’ll find all the ways you can customize and style the Widget Messenger to match your preferences for multiple brands.
First select the brand you want to add a new style for using the dropdown at the top.
Before creating new Messenger styles, make sure you've set up your brands and connected them to the correct Help Center to ensure the right support content is surfaced in your Messenger per brand.
Import your style
If you joined Fin since December 2023, you'll find the option to import your brand logo and colors automatically. Simply enter your chosen domain and click Import.
You can use the dropdowns to select a different action or background color that was found on your domain.
You can also choose to use the logo that was found on your domain. This can be changed manually at any time. This logo will only appear in the Widget Messenger, not in your brand settings.
When you click Confirm the Messenger preview on the right will automatically be updated with your imported style. Read the section below if you'd like to customize your Messenger style manually. 👇
Messenger theme & branding
Set the theme mode for your Widget Messenger in Messenger > Widget > Appearance > Messenger theme & branding. You can control which version of the Messenger your customers see:
Light: Always shows your light mode theme.
Dark: Always shows your dark mode theme.
Match System: Automatically matches your customers’ system theme.
Note: Your Widget Messenger color palette and logo is set separately for each theme. If you enable the dark/light theme, you'll need to select the logo and color palette you want this theme to use. This helps you ensure contrast, legibility, and a consistent brand experience—regardless of how your customer browses.
Tip: If you’d prefer to control when the Widget Messenger switches between light and dark mode yourself—rather than relying on system settings—you can do so using our client-side APIs. This is especially useful if your app changes themes based on user preferences, a toggle, or time of day.
Logo & colors
You can also customize the logo and colors in the Widget Messenger from Messenger > Widget > Appearance > Messenger theme & branding. This allows you to align the chat interface with your visual identity.
Stylize the Messenger Home with your logo and decide whether to display your teammates’ avatars for a more personal touch.
Note: You can upload a different logo for light and dark theme.
Use the guidelines below when uploading a logo. 👇
Don't recommend: A lot of space around your logo.
Recommended: A tight crop will look best.
The space available for a logo will change if you've chosen to show your team avatars.
Select the Home Screen Background which is used in the Messenger Home header, and Action color (Primary color) which is used in buttons, links and more to highlight and emphasize.
Customize the Widget Messenger header further with optional color gradients, background image, background fade, or text color.
Note:
The ability to customize both the Messenger Launcher and Messenger Home is only available on the Advanced or Expert plan.
You can select different color palettes for light and dark theme.
Logo images will almost always appear smaller within the circular frame due to internal padding. Increasing the image size will not affect how much of the circle is filled. This is expected behavior for consistency across devices.
If you select Image as your header background, we recommend using an image size of 800 x 600 pixels.
The red notification badge color is fixed and cannot be changed through Messenger settings or installation code.
Teammate avatars
Choose to hide or enable teammate avatars on the Widget Messenger Home to add personal touch.
Note: Avatar display changes when Fin AI Agent is enabled. If Fin is configured without a human handover path, only Fin's avatar will appear and teammate avatars won't be shown even if this setting is enabled. Learn more about customizing Fin in the Widget Messenger.
Launcher Position
Adjust your launcher's positioning on computers and tablets from the right to the left, and adjust the side and bottom spacing.
Note:
Check our plans and pricing if this feature is included on your subscription.
To find Messenger Launcher settings, Show the Messenger Launcher must first be turned on for visitors/users.
The Messenger Launcher uses the Action color (Primary color) you selected in brand colors.
You can only set the Messenger Launcher to one position on your site (it can’t appear in multiple positions across the same site).
You can position your launcher on either the left or right side of the screen, adjust its padding, and upload a custom image. However, it’s currently not possible to enlarge the launcher symbol or move it dynamically based on page content.
Spotlight
Optionally, you can use the Spotlight Messenger on web. This Messenger experience has been specifically designed for Fin for Sales but can be used as your standard web Messenger. Spotlight is optimized for driving engagement, helping move web visitors from early interest to deeper intent and higher-quality sales conversations.
Configure Spotlight from Settings > Messenger > Spotlight.
Here, you can choose who sees the Spotlight Messenger. For that audience, it replaces the Widget Messenger. By default, it becomes visible to all visitors and leads once Fin for Sales is deployed.
Mobile SDKs
The Messenger works beautifully in your mobile app too. You can configure the experience for mobile app users from Settings > Messenger > Mobile SDKs.
The settings here are the same as for web, other than where a feature is web-only. Learn how the Messenger works on mobile apps.
Web includes both desktop web + mobile web. Mobile SDKs refers to your mobile app (if you have one).
Note: To use dark mode on mobile, customers will need to be on the following minimum versions of the Intercom SDK:
Android: 17.0.0
iOS: 19.0.0
Conversations
Choose how customers start conversations with you in the Widget Messenger, introduce your team, and add special notices from Settings > Messenger > Conversations.
Start conversation button text
The "Start conversation button text" or call-to-action (CTA) can be configured for teammates and Fin AI Agent separately.
For example, when a conversation is going to be handled by a teammate you might want the CTA button to say "Contact Support" so that customers know they're getting in touch with your human support team. Whereas, if a conversation is going to be handled by Fin, you might prefer the CTA button to say "Ask a question" instead.
With teammates
For conversations started with teammates, choose the "Start conversation button text" or CTA. You can select between 6 options and set a different CTA for visitors and users.
In the Messages space this is how the CTA looks:
Customers will see this CTA on the Home, Messages, and Help spaces in the Widget Messenger when a conversation is going to be handled by a teammate (not Fin AI Agent).
The human identity display instantly lets customers know that they are speaking with a person from your team. The teammates name is shown directly below each message they send in the Messenger.
With Fin
For conversations started with Fin AI Agent, you can choose to set bot expectations which allows you to change the "Start conversation button text" or CTA when a conversation will be handled by Fin. Or simply match teammate expectations you set above.
Fin AI Agent identity is seamlessly integrated into the Widget Messenger's user interface. This AI Agent label setting can be enabled or disabled in the Fin AI Agent > Identity settings. For every message the AI Agent sends, the label "Fin AI Agent" is displayed directly below the message bubble. This consistent and clear placement allows customers to easily follow the flow of the conversation and understand that you are the source of the replies.

Reply expectations
Show reply times during office hours and indicate when your team will be back online outside office hours in the Widget Messenger. You an also enable "Show office hours after team assignment" to only show your office hours after a conversation is assigned to a team. We recommend this option if you have set office hours at the team level.
Team introduction
Edit the Team introduction to introduce your team to customers and set expectations before they start a conversation in the Widget Messenger.
Tip: This can be configured to support up to 45 languages from Settings > Messenger > General > Choose supported languages.
Special notice
Write a Special notice to all your visitors and users in the Widget Messenger. For example, if your response times are slower than usual. Special notices can be customized in multiple languages supported by your workspace, and you can enhance them with links and text styling for improved clarity and engagement.
General
In Settings > Messenger > General you’ll find inbound volume controls, office hours and reply times, supported languages, security settings, privacy policy notice, and other Messenger preferences.
Control inbound volume
Control inbound volume by deciding who can start a conversation in the Widget Messenger. You can make this more targeted by adding display conditions based on user attributes.
Choose supported languages
Choose which default language should be displayed in the Widget Messenger interface for all customers, or add different languages to display the Messenger in these languages when they match your customer’s browser or device settings.
Keep your Messenger secure
List your trusted domains and subdomains, separated by commas (your Messenger will only show on these domains). To mark all your subdomains as trusted, use an asterisk as a placeholder like this: *example.com. If you leave this field blank, your Messenger can be added to any domain.
You can also configure:
Session duration: Control how long your users' Messenger sessions remain active
Secure cookies: Only transmit Messenger cookies over HTTPS connections.
We strongly recommend that you set up identity verification to keep third parties from impersonating your logged-in users and seeing their conversations.
Note:
If you leave the "trusted domains" field blank, your Messenger can be added to any domain.
You can list multiple domains, separated by commas.
To list all subdomains just use an asterisk, like
*.intercom.com.We don't support adding localhost, but you can add '0.0.0.0' and/or '127.0.0.1' and the Messenger will work on these domains.
Configure privacy settings
HIPAA compliant mobile notifications
Hide message content in mobile push notifications to protect customers' sensitive information.
Privacy policy
Link your privacy policy within the Widget Messenger and remind customers of your data processing and protection policies. The notice will appear at the start of each new conversation until the customer either sends a message or dismisses it.
The privacy policy notice supports multiple languages, text styling and hyperlinks.
Other preferences
Configure your other Messenger preferences such as whether customers hear a sound for incoming messages you send. With audio turned on your users will hear an audio notification when they receive a new message from you, and audio feedback when they send a message.
Or stop sending error reports to us. When on, your Messenger stops sending error reports to Fin across Web, iOS, and Android. We use these reports to debug issues that affect your customers.
Security
We strongly recommend securing your Messenger with JSON web tokens (JWTs) so you can be sure that the person your are talking to is really who they claim to be. It prevents bad actors from impersonating your logged-in users and seeing their historical conversations.
Additionally you can set a short expiry for the user's token and also secure any data sent about them in the payload.
You can access your Messenger security settings on Settings > Channels > Messenger > Security
Save and set live
When you’re happy with your Messenger preview, click Save and set live. ✨
To use the Messenger on web, you must first install the Messenger:
Need more help? Get support from our Community Forum
Find answers and get help from Intercom Support and Community Experts




































