Skip to main content
Data import and migration enables you to transfer existing chat data from your own servers or another chat provider to CometChat. This ensures continuity of service and preserves your users’ conversation history during the transition.

​
What Can Be Migrated?

CometChat’s migration capabilities cover:
  • Users: User profiles, metadata, and account information
  • Messages: Complete message history including text, media, and metadata
  • Groups: Group configurations and membership information
  • Conversations: Conversation threads and their associated data

​
Migration Approaches

CometChat offers two approaches to data migration, depending on your needs:

​
Historical Data Import

Import all your existing data at rest—stored messages, users, and groups—into CometChat before going live. This approach is ideal when:
  • You’re doing a complete platform switch
  • You want all historical data available from day one
  • Your migration can happen during a maintenance window
The Data Import APIs handle bulk ingestion of historical chat data, allowing you to transfer large volumes of users, messages, and group information efficiently.

​
Live Data Migration

Maintain communication between users on your old system and users who have already migrated to CometChat. This approach is ideal when:
  • You need zero downtime during migration
  • Users will upgrade to the new app version gradually
  • Seamless communication must continue throughout the transition period
Live migration bridges both systems during the upgrade cycle, ensuring no messages are lost regardless of which system a user is currently on.

​
Migrate with Agent Skills

Moving from another chat provider? With CometChat Agent Skills installed, your AI coding agent can do the migration for you. It creates a data-import script for your users, groups and messages, shows you a dry run, then runs the import.
  • Migrate your app and your data. Open your project in your coding agent and say “Migrate my app to CometChat.” The agent replaces the provider in your code, checks the build, then asks for your API keys and imports your data.
  • Migrate only your data. Say “Migrate only my data to CometChat. Don’t change my app code.”, naming the chat provider you’re moving from. The agent writes and runs the same data-import script without touching your app.
Before you start, create your CometChat app and a full-access REST API key. The import brings over the last 6 months of messages. For setup steps, what the migration changes and how to go live, see Migrate from Another Chat Provider with Agent Skills.

​
Getting Started

For Historical Data Import: Use the Data Import REST APIs to programmatically import your users, messages, and groups. For Live Data Migration: Contact our Sales team to discuss your migration requirements and set up the live migration process.