Our installation instructions are slightly different depending on the version of BuddyPress and WordPress you are running. Please select:

  1. BuddyPress 2.2+ with WordPress version 3.8 and higher
  2. BuddyPress 2.2+ with WordPress version lower than 3.8

BuddyPress 2.2+ with WordPress version 3.8 and higher

Installing CometChat as a WordPress plugin

Step 1
Log in to WordPress administration panel and navigate to Plugins >Add New and click on “Upload Plugin”.

installing-cometchat_ready-integration_BuddyPress 1

Step 2
Click “Choose File” and select buddypress.zip from your download package.

installing-cometchat_ready-integration_BuddyPress 2

Step 3
You will receive “Plugin installed successfully” message. Now click on Activate plugin and navigate to CometChat menu.

installing-cometchat_ready-integration_BuddyPress 3

Step 4
Click “Choose File” and choose cometchat.zip and click Install Now.

installing-cometchat_ready-integration_BuddyPress 4

Note: If you face problem while uploading ‘cometchat.zip’ file, please unzip the ‘cometchat.zip’ that has been provided in the package. Place the ‘cometchat’ folder in the wordpress root directory and execute ‘cometchat/install.php’ from “http://<path_to_wordpress>/cometchat/install.php”. Also, CHMOD the following folder to 777 (recursively):

Step 5
Once you receive “CometChat has been successfully installed!” message, click Access Cometchat Admin Panel button.

installing-cometchat_ready-integration_BuddyPress 5

Step 6
Now click Additional Settings.

installing-cometchat_ready-integration_BuddyPress 6

Step 7
Select the user groups from whom CometChat bar should be hidden.

installing-cometchat_ready-integration_BuddyPress 7

Step 8
Select whether you want to sync messages between BuddyPress Messages and CometChat.

installing-cometchat_ready-integration_BuddyPress 7

Step 9
Finally click save settings. Done!

Upgrading CometChat

To upgrade CometChat to its latest version on your site, download CometChat package from ‘https://my.cometchat.com/’. Unzip the cometchat_UNZIP_FIRST.zip and upload the new ‘cometchat.zip’ and click Install Now.


BuddyPress 2.2+ with WordPress version lower than 3.8


This guide will help you through the installation process and get CometChat running on your site.

Installation is very straight forward, only taking about 5 minutes from uploading the files to viewing the CometChat bar on your site.

Before you begin, you will need an FTP client, if you do not have one, some popular solutions include FileZilla(free) or CuteFTP (trial).

You do not need programming knowledge to install CometChat, but a working knowledge of FTP functions is a plus.

This guide assumes that you have successfully downloaded the latest release of CometChat and have the zip file “unzipped” and ready to go. If not, you can download the package from your client area.

The instructions will term the zip file you downloaded as cometchat.zip.


At this point, you should have the zip archive cometchat.zip and find a single folder- “cometchat”.

If you don’t know already, find out the folder in which BuddyPress is installed.

If you access your BuddyPress site via ‘http://www.domain.com’, then look for the webroot directory.

The “webroot” directory is usually ‘public_html’ or ‘www’, but this varies from server to server so if you’re unsure, contact your hosting provider.

Using your FTP client, copy the cometchat folder inside your BuddyPress folder. e.g. http://www.domain.com/cometchat


Step 1

You should now run the installer file through your web browser by entering the URL to it into your browser address bar (if you have followed our example, type in http://www.domain.com/cometchat/install.php, naturally substituting ‘domain.com’ for your web address).

If the installation was completed successfully, then two code snippets will be displayed on your screen. The first code is for docked themes like Glass, Hangout, Facebook etc. and the second is for embedded theme i.e. Synergy. Please copy the appropriate lines of code depending on whether you wish to use docked themes or embedded theme.

Step 2

To use docked theme:

Now edit your template header. Login to WordPress Administration and go to Appearances -> Editor. Click on Header (header.php) from the right side panel to edit the header.

Immediately after the opening head tag add the copied code:

<link type="text/css" href="/cometchat/cometchatcss.php" rel="stylesheet" charset="utf-8">
<script type="text/javascript" src="/cometchat/cometchatjs.php" charset="utf-8"></script>

To embed CometChat in your site:

Add the code copied for embedded theme from step 1 in your site’s HTML code to embed the chat.

Now delete install.php file from the cometchat folder.

That’s all! Now log-in to your site and you will be able to see the CometChat bar. For customizing the text, icons, plugins, theme and modules, please refer to the documentation for Administration Panel.

Not finding what you need?

The CometChat team is here to help!