It’s easy to install Intercom on your WordPress site and start chatting with your leads and users.
Note:
You must have WordPress v4.2.0 or higher.
It's not possible to use WordPress with an EU hosted workspace.
Before starting the installation with the WordPress integration you must first go to Installation > Web settings and ensure that you've toggled on "Enable user traffic for Messenger".
When this is disabled, all requests to Intercom will fail.
Installation steps
Log in to your WordPress website and click Add New on your plugins page.
Next, search for and install the official Intercom plugin.
Use of any non-official plugins (e.g. "WordPress for Intercom") is not supported.
Once installed, (if it isn't automatically activated) click on the Activate button to connect the integration to your account.
Then, go to Intercom’s plugin settings page in WordPress and click Connect with Intercom.
Complete the verification prompt to confirm you're connecting the correct address.
The integration will then show the "App ID" of the Intercom Workspace that has been connected.
If the "App ID" has not been automatically populated in step 6 or there are issues with the installation process, login to your Workspace in a background tab so your browser cookies are up-to-date, then complete the installation/connection process again.
Once you've confirmed your WordPress site address and connected your Intercom account, you’ll be able to chat to your Leads and Users on your WordPress site:
With the WordPress plugin Intercom looks for standard logout links, and will call the Intercom('shutdown') method when clicked. This method clears your users’ conversations from the Messenger anytime they logout of your application.
Changing connected Intercom account
If you’d like to change the Intercom account you've connected to your website, just go to Intercom’s plugin settings in WordPress, and click the link at the bottom of the page to reconnect with a different account:
Important requirements:
If you’re using the Intercom plugin to chat to logged-out visitors only, you'll need to log out of WordPress before visiting your site to complete the installation.
You must have WordPress 4.2.0 and PHP 5.6 or higher for the plugin to work correctly (See requirements here).
If you need to customize your Intercom installation, you can manually install Intercom on your website using JavaScript.
The WordPress Theme used on the site/page needs to call
wp_footer()in order for the snippet to be inserted (See code here). If a Theme is used that does not contain a footer, you’ll need to install Intercom directly on your WordPress pages using the JavaScript snippet.Messenger will not appear on sites with URLs that contain "/WP" or other similar non-user facing paths. If this type of path has been used you'll need to change the URL in the Settings page of your WordPress dashboard, then go into Settings > Intercom and click on "click here to reconnect with Intercom" at the very bottom and complete the above setup process from step 3 onwards as directed.
FAQs
What data is synced with the Intercom WordPress plugin?
email and name
How do I customise the WordPress plugin/messenger?
The plugin prints Javascript code on the website in a similar way to the regular Javascript installation code. As such you can use the below methods to do this:
Official customization method:
Use a WordPress filter to add extra parameters to the Javascript snippet
https://github.com/intercom/intercom-wordpress#pass-extra-parameters-to-the-intercom-messengerThis essentially lets you add attributes to the
intercomSettingsobjectYou can even call
$settings = null;to set the intercomSettings to be null and thus prevents Intercom from loading at all on the page.Manually edit the plugin (highly discouraged as it can get wiped out on upgrading the plugin)
Non official ways of Customization
Modify the current behavior in the
functions.phpfileDoing this directly in current theme code sample for plugin customizations
💡Tip
Need more help? Get support from our Community Forum
Find answers and get help from Intercom Support and Community Experts