Migration guide for apps from V2 to V3

Migration requires changes from CometChat Dashboard and your application.

Upgrading from v2 to v3 is simple since there aren't many code-level changes. However, you should be aware that v3 apps are incompatible with v2 SDKs and vice versa.

If you are planning to use the v3 SDKs, you will need to migrate or upgrade your app from v2 to v3. This can be done via the CometChat dashboard.

  1. Open CometChat Dashboard
  2. Select the existing V2 app, you wish to migrate
  1. In Settings, select Migrate App to V3 tab

    Click on Request app migration to V3 as shown below.
    Once a request is sent, our team will get in touch with you and set the app to Migrating status

  1. Once the app status is set as Migrating status. There will be migration changes required in your application

a. Upgrade to V3 by following the installation steps required for your platform

For Chat widgets,


For UI Kits and SDKs,

// Use this package to upgrade SDK version to V3

npm install @cometchat-pro/[email protected] --save
//Add the following lines to the Podfile.

//For Xcode 12 and above:

platform :ios, '11.0'

target 'YourApp' do
     pod 'CometChatPro', '3.0.1'

//Install the CometChatPro framework through CocoaPods
pod install

//If you're facing any issues while installing pods then use the below command
pod install --repo-update
//Open the app level build.gradle file and follow below
//Add the below line in the dependencies section.

dependencies {
  implementation 'com.cometchat:pro-android-chat-sdk:3.0.1'
// Use this package to upgrade SDK version to V3

npm install @cometchat-pro/[email protected] --save
// Use this package to upgrade SDK version to V3

npm install @cometchat-pro/[email protected] --save

b. Updating few methods in Code/Application

In version 3.0, there are only a few important changes required in the code. Please refer to these links below for changes required in different platforms

React Native
Cordova Ionic

  1. Once all the changes are done in your application. Go to the dashboard and switch on the toggle for your app migration to V3 as complete
  1. Once all the steps are done. You will be able to see your app is migrated to v3

Did this page help you?