Once you have installed Intercom on your site, you should see the Messenger in the bottom right of your screen. You have some control over how the Messenger appears on your site.
By default the Messenger will appear on the bottom right corner of your site, but you can change its position using alignment, horizontal_padding, and vertical_padding.
Add the following to your installation script:
window.intercomSettings = {
app_id: 'abc123',
alignment: 'left', // Left or right position on the page
horizontal_padding: 20, // Horizontal padding
vertical_padding: 20 // Vertical padding
};You can choose the z-index of the Intercom Messenger by providing the following attribute in your intercomSettings.
window.IntercomSettings = {
app_id: 'abc123',
z_index: -15
}The z-index can also be updated programmatically via an API call.
Intercom('update', {"z_index": -15});
- Product tours will always remain on a high z-index. Product tour steps are part of your website, not part of the Messenger. As a result, the Messenger's z-index does not influence them.
- The Messenger on mobile web will always remain on a high z-index. Due to the size of most mobile devices, the Messenger needs to be displayed on the top of everything.
- Confetti animation will always remain on a high z-index (however if it's rendered inside the Messenger, a lower z-index of the parent widget will take precedence).
If you have multiple brand or style configurations set up in your Intercom workspace, you can specify which style the Messenger should load at boot time using messenger_style_id.
window.intercomSettings = {
app_id: 'abc123',
messenger_style_id: '123456'
};You can also switch styles dynamically without a full page reload:
Intercom('update', { messenger_style_id: '789012' });Style IDs are available in your Intercom workspace under Settings → Messenger → Appearance → Manage Style.
You can show a short text label next to the default launcher icon using launcher_text. The launcher changes from a circle to a rounded button that holds the icon and the text.
window.intercomSettings = {
app_id: 'abc123',
launcher_text: 'Need help?'
};You can also change or remove the text without a page reload. Set it to an empty string to go back to the standard round launcher:
Intercom('update', { launcher_text: 'Chat with us' });
Intercom('update', { launcher_text: '' });Keep the text to a few words. Longer text is cut off with an ellipsis.
The text is shown exactly as you provide it and is not translated. On sites in several languages, set the right text for each page.
The launcher is hidden while the Messenger is open.
It only changes the default launcher. It doesn't add text to your own launcher element (
custom_launcher_selector), and has no effect whenhide_default_launcheristrue.
To see how the Messenger customizations work, check out this Codepen.
You can test the different configuration options and can copy the code out of the editor if you decide you want to use it in your own app.
The example here provides a test App ID, but replace it with your own if you plan to use the code snippet in your own app.