From cb924665f20aadff6b64a909bd252242013f500e Mon Sep 17 00:00:00 2001 From: Kiro Agent Date: Mon, 27 Apr 2026 18:20:02 +0530 Subject: [PATCH 01/14] 43254 --- ui-kit/react-native/conversations.mdx | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/ui-kit/react-native/conversations.mdx b/ui-kit/react-native/conversations.mdx index 839a0198d..61669c7b4 100644 --- a/ui-kit/react-native/conversations.mdx +++ b/ui-kit/react-native/conversations.mdx @@ -921,6 +921,10 @@ function StyledConversations() { | `itemStyle` | `object` | Style for list items (includes `avatarStyle`, `badgeStyle`, `titleStyle`, `subtitleStyle`) | | `searchStyle` | `object` | Style for the search bar | + +**Avatar style override in Conversations:** `CometChatConversations` generates its own internal avatar style that overrides the base theme's `avatarStyle`. To customize avatar appearance specifically within the conversation list, you must set `avatarStyle` through the `itemStyle` prop on `CometChatConversations` (i.e., `style.itemStyle.avatarStyle`). Setting `avatarStyle` at the theme level via `CometChatThemeProvider` will not take effect for the conversation list. + + --- ## Props From e3a689dc374822a8a6875ef25208ddc4fca41561 Mon Sep 17 00:00:00 2001 From: Kiro Agent Date: Mon, 27 Apr 2026 18:20:57 +0530 Subject: [PATCH 02/14] 43417 --- notifications/templates-and-sounds.mdx | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/notifications/templates-and-sounds.mdx b/notifications/templates-and-sounds.mdx index 3904ef8ff..769788354 100644 --- a/notifications/templates-and-sounds.mdx +++ b/notifications/templates-and-sounds.mdx @@ -384,6 +384,14 @@ Use this sparingly to avoid surprising users. Set only the preferences that chan - Use `sender@group` style for group titles to disambiguate conversations. - Avoid placeholders in fallback text to prevent unresolved values. +### Group call notifications + + +Group call notifications (e.g., "User started a group call") are sent as **custom messages** (`category: "custom"`), not as group action messages. This means they are governed by the [custom message templates](#5-custom-message-templates) above, and the `GROUP_ACTIONS_PREFERENCE` setting does **not** affect group call notifications. + +If you want to suppress or customize group call notifications independently, configure the custom message template or handle them in your client-side notification logic. + + ### Sounds Include sound files in your app bundle and set the `sound` field in the push payload to the filename (omit extension if your platform expects that). From 37b84c05d629b4bbeb55f33150bc0b84fe485361 Mon Sep 17 00:00:00 2001 From: Kiro Agent Date: Mon, 27 Apr 2026 18:24:51 +0530 Subject: [PATCH 03/14] 43738 --- notifications/push-overview.mdx | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/notifications/push-overview.mdx b/notifications/push-overview.mdx index 1330243c3..c4008aaf3 100644 --- a/notifications/push-overview.mdx +++ b/notifications/push-overview.mdx @@ -28,6 +28,10 @@ CometChat listens for chat and call events, assembles payloads from your templat - Group membership changes (join/leave/ban). - Call invites, missed calls, and ongoing call updates. + +**Call notifications and group calls:** Call-related push notifications (e.g., initiated calls, missed calls) are sent as **custom messages**, not as group action messages. The **production mode toggle** in the dashboard only affects APNs endpoint routing (sandbox vs production) — it does not change how the Notification Engine constructs the push payload. If you experience APNs errors (e.g., 400 status) for call pushes, check your APNs provider credentials and certificate configuration rather than the production mode toggle. + + ## Before you integrate 1. **Dashboard setup**: Enable Push Notifications, add providers (FCM for Android/iOS, APNs + optional APNs VoIP for iOS), and copy Provider IDs. From 9e8c9a20346cdadf7393a932bf9d703fd503b512 Mon Sep 17 00:00:00 2001 From: Kiro Agent Date: Mon, 27 Apr 2026 18:25:51 +0530 Subject: [PATCH 04/14] 43250 --- sdk/flutter/user-management.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/sdk/flutter/user-management.mdx b/sdk/flutter/user-management.mdx index 6d23237b5..95622f92c 100644 --- a/sdk/flutter/user-management.mdx +++ b/sdk/flutter/user-management.mdx @@ -74,7 +74,7 @@ CometChat.createUser(user, authKey, onSuccess: (User user) { | Parameter | Type | Description | |-----------|------|-------------| -| `user` | `User` | A `User` object containing the details of the user to be created. The `uid` and `name` fields are required. | +| `user` | `User` | A `User` object containing the details of the user to be created. The `uid` and `name` fields are **required**. | | `authKey` | `String` | Your CometChat Auth Key. Use only for development — never expose in production client code. | | `onSuccess` | `Function(User user)` | Callback triggered on successful user creation, returning the created `User` object. | | `onError` | `Function(CometChatException excep)` | Callback triggered on failure, returning a `CometChatException` with error details. | From fcb07aec3cb1b2342749718acd9b62c436dba7c2 Mon Sep 17 00:00:00 2001 From: Kiro Agent Date: Mon, 27 Apr 2026 18:36:10 +0530 Subject: [PATCH 05/14] 43893 --- notifications/flutter-push-notifications-ios.mdx | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/notifications/flutter-push-notifications-ios.mdx b/notifications/flutter-push-notifications-ios.mdx index 2e8b17987..6c9f78679 100644 --- a/notifications/flutter-push-notifications-ios.mdx +++ b/notifications/flutter-push-notifications-ios.mdx @@ -63,6 +63,10 @@ Keep the provider IDs—you’ll set them in `CometChatConfig`. 2. Enable Push Notifications plus Background Modes → *Remote notifications* and *Voice over IP* on the bundle ID. 3. Create a VoIP Services certificate/key if you want separate credentials. + +**`.p12` certificates are deprecated.** Apple recommends using `.p8` Auth Keys for push notifications. `.p8` keys never expire and work across all your apps. Migrate to `.p8` if you haven't already. + + ### 2.2 Firebase Console 1. Register the same bundle ID and download `GoogleService-Info.plist` into `ios/Runner`. @@ -204,6 +208,17 @@ This registers the device token against the APNs provider selected in `CometChat - `FlutterCallkitIncoming.onEvent` is already wired inside `APNSService` to accept or end calls initiated by CallKit. - When native CallKit UI accepts/ends a call, Swift invokes `onCallAcceptedFromNative` / `onCallEndedFromNative` on the MethodChannel; `APNSService` then calls `FlutterCallkitIncoming.setCallConnected` or `CometChat.endCall()` to keep both stacks synchronized. + +**Cold-start VoIP call handling:** When the app is killed (not running) and a VoIP push arrives, the standard CometChat call listeners (`onOutgoingCallAccepted`, `onIncomingCallReceived`, etc.) will **not** fire because the Flutter engine is not yet initialized. In this scenario, you need a **native-to-Flutter bridge** that: + +1. Handles the VoIP push entirely in native Swift code (`AppDelegate` / `PushKit` handler). +2. Presents the CallKit UI natively. +3. When the user accepts, initializes the CometChat SDK from the native side using `CometChat.generateToken()` and `CometChat.startSession()`. +4. Bridges the call state back to Flutter via a MethodChannel once the Flutter engine is ready. + +The standard `CometChatCallingExtension` call listeners only work when the app is already running (foreground or background with an active Flutter engine). See the [sample app's `AppDelegate.swift`](https://github.com/cometchat/cometchat-uikit-flutter/blob/v5/sample_app_push_notifications/ios/Runner/AppDelegate.swift) for a reference implementation of this native bridge pattern. + + ## 7. Badge count using `unreadMessageCount` CometChat's Enhanced Push Notification payload includes an `unreadMessageCount` field representing the total unread messages across all conversations for the logged-in user. On iOS the badge can be updated from both the client side and the server side. From df9efdd5dd5eafc8f118b3aaf30ad55f603b5dab Mon Sep 17 00:00:00 2001 From: Kiro Agent Date: Mon, 27 Apr 2026 18:38:48 +0530 Subject: [PATCH 06/14] 43344 --- notifications/ios-apns-push-notifications.mdx | 4 ++++ notifications/react-native-push-notifications-ios.mdx | 4 ++++ 2 files changed, 8 insertions(+) diff --git a/notifications/ios-apns-push-notifications.mdx b/notifications/ios-apns-push-notifications.mdx index e3a73871f..529d72ad2 100644 --- a/notifications/ios-apns-push-notifications.mdx +++ b/notifications/ios-apns-push-notifications.mdx @@ -43,6 +43,10 @@ description: "Implement APNs push notifications with CometChat UIKit for iOS, in - Add an **APNs Device** provider (alerts) using your `.p8` key, Team ID, Key ID, and Bundle ID; copy the Provider ID. - Add an **APNs VoIP** provider (calls) with the same `.p8` (recommended for CallKit reliability); copy the Provider ID. + +**`.p12` certificates are deprecated.** Apple recommends using `.p8` Auth Keys for push notifications. `.p8` keys are simpler to manage (one key works for all your apps), never expire, and are the only format actively supported going forward. If you are still using `.p12`, migrate to `.p8` at your earliest convenience. + + Add APNs credentials diff --git a/notifications/react-native-push-notifications-ios.mdx b/notifications/react-native-push-notifications-ios.mdx index 9409502a6..b6637ed42 100644 --- a/notifications/react-native-push-notifications-ios.mdx +++ b/notifications/react-native-push-notifications-ios.mdx @@ -109,6 +109,10 @@ For iOS we use Apple Push Notification service (APNs) for both standard and VoIP 2. Enter a key name, check **Apple Push Notification service (APNs)**, then **Continue** → **Register**. 3. Download the `.p8` file and note the **Key ID**, **Team ID**, and your **Bundle ID**—you’ll enter these in CometChat. 4. *(Optional)* If you still use `.p12`, export it from the downloaded key without an export password; keep it handy for upload. + + + **`.p12` certificates are deprecated.** Apple recommends using `.p8` Auth Keys for push notifications. `.p8` keys are simpler to manage (one key works for all your apps), never expire, and are the only format actively supported going forward. Migrate to `.p8` if you haven't already. + From 00e2926e3525e9daf39924ea12a3fcd158f42ee1 Mon Sep 17 00:00:00 2001 From: Kiro Agent Date: Mon, 27 Apr 2026 18:39:41 +0530 Subject: [PATCH 07/14] 43437 --- articles/limits.mdx | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/articles/limits.mdx b/articles/limits.mdx index 156ed8690..f200855ed 100644 --- a/articles/limits.mdx +++ b/articles/limits.mdx @@ -25,6 +25,12 @@ The limits may vary based on your subscription plan. If you have any questions, 1. Each message, including metadata, must not exceed 65,536 characters (\~65KB). +### File Uploads + +1. The maximum file size for attachments (images, videos, audio, files) is a **fixed platform constraint** and cannot be configured or changed through the Dashboard or API. +2. The default file upload size limit is **100 MB** per file. +3. If you need a higher limit, [contact the CometChat team](https://www.cometchat.com/contact) to discuss options for your plan. + ### Voice & Video Calling 1. For the best experience, a maximum of 50 participants can join a single video call. From 67d1cad7acf7036c7b8d3e8733029f45a3b4067a Mon Sep 17 00:00:00 2001 From: Kiro Agent Date: Mon, 27 Apr 2026 18:46:01 +0530 Subject: [PATCH 08/14] 44272 --- sdk/flutter/3.0/overview.mdx | 4 ++++ sdk/flutter/3.0/setup.mdx | 4 ++++ sdk/flutter/installation.mdx | 4 ++++ sdk/flutter/setup.mdx | 4 ++++ sdk/flutter/v5/setup.mdx | 4 ++++ ui-kit/react-native/call-features.mdx | 4 ++++ ui-kit/react-native/calling-integration.mdx | 4 ++++ ui-kit/react-native/v4/call-features.mdx | 4 ++++ 8 files changed, 32 insertions(+) diff --git a/sdk/flutter/3.0/overview.mdx b/sdk/flutter/3.0/overview.mdx index 629fbcb92..3bbfd05ba 100644 --- a/sdk/flutter/3.0/overview.mdx +++ b/sdk/flutter/3.0/overview.mdx @@ -79,6 +79,10 @@ end + +**Apple Silicon (M1/M2/M3) users:** Excluding `arm64` from the simulator build prevents the app from running natively on Apple Silicon Macs. If you are developing on an Apple Silicon Mac, consider excluding only `i386` instead of `arm64 i386` to enable native simulator builds. + + 4. For iOS navigate to your iOS folder in terminal or CMD and do `pod install` . For apple chip system use rosetta terminal. 5. import CometChat SDK using the following code in dart. diff --git a/sdk/flutter/3.0/setup.mdx b/sdk/flutter/3.0/setup.mdx index b30003c1c..d86c331fb 100644 --- a/sdk/flutter/3.0/setup.mdx +++ b/sdk/flutter/3.0/setup.mdx @@ -63,6 +63,10 @@ end + + +**Apple Silicon (M1/M2/M3) users:** Excluding `arm64` from the simulator build prevents the app from running natively on Apple Silicon Macs. If you are developing on an Apple Silicon Mac, consider excluding only `i386` instead of `arm64 i386` to enable native simulator builds. + 3. For iOS, change the deployment target to `11` or higher. diff --git a/sdk/flutter/installation.mdx b/sdk/flutter/installation.mdx index 4e688be89..fc02812cd 100644 --- a/sdk/flutter/installation.mdx +++ b/sdk/flutter/installation.mdx @@ -56,6 +56,10 @@ post_install do |installer| end ``` + +**Apple Silicon (M1/M2/M3) users:** Excluding `arm64` from the simulator build prevents the app from running natively on Apple Silicon Macs. If you are developing on an Apple Silicon Mac, consider excluding only `i386` instead of `arm64 i386` to enable native simulator builds. + + 2. Set the deployment target to `11` or higher. 3. Navigate to your iOS folder in terminal and run `pod install`. For Apple Silicon systems, use a Rosetta terminal. diff --git a/sdk/flutter/setup.mdx b/sdk/flutter/setup.mdx index c98060603..877c9e0e6 100644 --- a/sdk/flutter/setup.mdx +++ b/sdk/flutter/setup.mdx @@ -97,6 +97,10 @@ end + +**Apple Silicon (M1/M2/M3) users:** Excluding `arm64` from the simulator build prevents the app from running natively on Apple Silicon Macs. If you are developing on an Apple Silicon Mac, consider excluding only `i386` instead of `arm64 i386` to enable native simulator builds. + + 2. Change the deployment target to `11` or higher. 3. Navigate to your iOS folder in terminal and run `pod install`. For Apple Silicon systems, use a Rosetta terminal. 4. Set **Enabled Bitcode** to **NO** in the Build Settings of your Xcode project. diff --git a/sdk/flutter/v5/setup.mdx b/sdk/flutter/v5/setup.mdx index bf9a09835..62827343b 100644 --- a/sdk/flutter/v5/setup.mdx +++ b/sdk/flutter/v5/setup.mdx @@ -78,6 +78,10 @@ end + +**Apple Silicon (M1/M2/M3) users:** Excluding `arm64` from the simulator build prevents the app from running natively on Apple Silicon Macs. If you are developing on an Apple Silicon Mac, consider excluding only `i386` instead of `arm64 i386` to enable native simulator builds. + + 3. For iOS, change the deployment target to `11` or higher. 4. For iOS, navigate to your iOS folder in terminal or CMD and do `pod install` . For apple chip system use rosetta terminal. 5. For iOS you can set the Enabled Bitcode settings to **NO** present in build settings of XCODE project diff --git a/ui-kit/react-native/call-features.mdx b/ui-kit/react-native/call-features.mdx index df77ad227..00fbbe702 100644 --- a/ui-kit/react-native/call-features.mdx +++ b/ui-kit/react-native/call-features.mdx @@ -162,6 +162,10 @@ end + +**Apple Silicon (M1/M2/M3) users:** Excluding `arm64` from the simulator build prevents the app from running natively on Apple Silicon Macs. If you are developing on an Apple Silicon Mac, consider excluding only `i386` instead of `arm64 i386` to enable native simulator builds. + + ## Add the Call Listeners In addition to CallButtons, the Calls UI Kit offers fully functional UI components for handling Incoming, Outgoing, and Ongoing calls. To receive call events in your desired component or screen, you must register a call listener using the `addCallListener()` method. The `onIncomingCallReceived()` event is triggered whenever an incoming call is received. diff --git a/ui-kit/react-native/calling-integration.mdx b/ui-kit/react-native/calling-integration.mdx index ea9703ebf..a34264cac 100644 --- a/ui-kit/react-native/calling-integration.mdx +++ b/ui-kit/react-native/calling-integration.mdx @@ -100,6 +100,10 @@ post_install do |installer| end ``` + +**Apple Silicon (M1/M2/M3) users:** Excluding `arm64` from the simulator build prevents the app from running natively on Apple Silicon Macs. If you are developing on an Apple Silicon Mac, consider excluding only `i386` instead of `arm64 i386` to enable native simulator builds. + + ## Set Up Call Listeners Register a call listener to receive call events in your component: diff --git a/ui-kit/react-native/v4/call-features.mdx b/ui-kit/react-native/v4/call-features.mdx index 7eda3c5dd..ac900ccf8 100644 --- a/ui-kit/react-native/v4/call-features.mdx +++ b/ui-kit/react-native/v4/call-features.mdx @@ -142,6 +142,10 @@ end + +**Apple Silicon (M1/M2/M3) users:** Excluding `arm64` from the simulator build prevents the app from running natively on Apple Silicon Macs. If you are developing on an Apple Silicon Mac, consider excluding only `i386` instead of `arm64 i386` to enable native simulator builds. + + ## Add the Call Listeners Apart from Call Buttons, the Calls UI Kit also provides fully functional UI components for Incoming, Outgoing and Ongoing Calls. From 39c58bf434e47588066936c16284585e8206163e Mon Sep 17 00:00:00 2001 From: Kiro Agent Date: Thu, 30 Apr 2026 17:18:58 +0530 Subject: [PATCH 09/14] 43202 --- widget/html/overview.mdx | 4 ++++ widget/wordpress/overview.mdx | 4 ++++ 2 files changed, 8 insertions(+) diff --git a/widget/html/overview.mdx b/widget/html/overview.mdx index 9963c750c..ebe61b3bd 100644 --- a/widget/html/overview.mdx +++ b/widget/html/overview.mdx @@ -27,6 +27,10 @@ The widget connects to CometChat's SDK and infrastructure, which manages message The Chat Widget is not customizable beyond the configuration options available in the Widget Builder in dashboard. If you require deeper customization, consider using our [UI Kits](/ui-kit/react/overview) instead. + +**Legacy Widget (v3):** If you previously used the legacy CometChat Widget (v3), the legacy widget section in the Dashboard is only visible for apps that had legacy widgets configured before the migration to Widget Builder. New apps will not see the legacy widget section. For migration guidance, see the [Migration Guide](/articles/migration-guide). + + --- ## Widget Builder Features diff --git a/widget/wordpress/overview.mdx b/widget/wordpress/overview.mdx index 1987c3b95..5df1ce10a 100644 --- a/widget/wordpress/overview.mdx +++ b/widget/wordpress/overview.mdx @@ -23,6 +23,10 @@ The widget connects to CometChat's SDK and infrastructure, which manages message Go to the Integration Guide + +**Legacy Widget (v3):** If you previously used the legacy CometChat Widget (v3) on WordPress, the legacy widget section in the Dashboard is only visible for apps that had legacy widgets configured before the migration to Widget Builder. New apps will not see the legacy widget section. For migration guidance, see the [Migration Guide](/articles/migration-guide). + + --- ## Widget Builder Features From d42a63d75239d5d31729464ce2dcc7b9cf547de2 Mon Sep 17 00:00:00 2001 From: Kiro Agent Date: Thu, 30 Apr 2026 17:37:53 +0530 Subject: [PATCH 10/14] 43570 --- widget/shopify/integration.mdx | 3 ++- widget/squarespace/integration.mdx | 3 +++ widget/webflow/integration.mdx | 6 ++++++ widget/wix/integration.mdx | 6 ++++++ 4 files changed, 17 insertions(+), 1 deletion(-) diff --git a/widget/shopify/integration.mdx b/widget/shopify/integration.mdx index 2ed25d872..c770a68c0 100644 --- a/widget/shopify/integration.mdx +++ b/widget/shopify/integration.mdx @@ -69,6 +69,7 @@ Add the CometChat Widget with a single snippet inside your Shopify theme. Choose //chatType: "user" | "group", //defaultChatID: "uid_or_guid", //dockedAlignment: "left" | "right" + //autoOpenFirstItem: false, }; CometChatApp.CometChatAuth.start(COMETCHAT_WIDGET_CONFIG); @@ -79,7 +80,7 @@ Add the CometChat Widget with a single snippet inside your Shopify theme. Choose - `appID`, `region`, `authKey`: Copy from the CometChat Dashboard (use an **App Auth Key**, not REST API key). - `user.name`, `user.avatar`, `user.link`: Optional guest display info. - `width`, `height`, `isDocked`: Size/placement (`isDocked = true` shows a docked bubble). -- `variantID`, `chatType`, `defaultChatID`, `dockedAlignment`: Optional widget targeting/placement controls. +- `variantID`, `chatType`, `defaultChatID`, `dockedAlignment`, `autoOpenFirstItem`: Optional widget targeting/placement controls. Set `autoOpenFirstItem: false` to prevent the widget from automatically opening the first conversation on load. --- diff --git a/widget/squarespace/integration.mdx b/widget/squarespace/integration.mdx index 1e8cbc974..e8039650d 100644 --- a/widget/squarespace/integration.mdx +++ b/widget/squarespace/integration.mdx @@ -70,6 +70,7 @@ Add the CometChat Widget by pasting one small code snippet. It drops in like any width: "400px", height: "80vh", isDocked: true, + //autoOpenFirstItem: false, }; const startWidget = () => CometChatApp.CometChatAuth.start(COMETCHAT_WIDGET_CONFIG); @@ -176,6 +177,7 @@ function initializeCometChat() { isDocked: true, width: "400px", height: "80vh", + //autoOpenFirstItem: false, }); } catch {} }; @@ -233,6 +235,7 @@ Full walkthrough: [How to properly log in and create users in CometChat](https:/ width: "400px", height: "80vh", isDocked: true, + //autoOpenFirstItem: false, }; const startWidget = () => CometChatApp.CometChatAuth.start(COMETCHAT_WIDGET_CONFIG); diff --git a/widget/webflow/integration.mdx b/widget/webflow/integration.mdx index aa5e89e44..1734a79db 100644 --- a/widget/webflow/integration.mdx +++ b/widget/webflow/integration.mdx @@ -85,6 +85,7 @@ Click **Save**, publish the site, then **Visit Website** to confirm the widget a //chatType: "user" | "group", //defaultChatID: "uid_or_guid", //dockedAlignment: "left" | "right" + //autoOpenFirstItem: false, }; const startWidget = () => CometChatApp.CometChatAuth.start(COMETCHAT_WIDGET_CONFIG); @@ -108,6 +109,7 @@ Click **Save**, publish the site, then **Visit Website** to confirm the widget a | `chatType` | Determines the type of conversation the widget initiates by default (one-on-one user chat or a group chat). | | `defaultChatID` | The specific chat with user (`uid`) or group (`guid`) that should automatically open when the widget loads. | | `dockedAlignment` | Controls the position of the docked widget interface on the page (left side or right side). | +| `autoOpenFirstItem` | When set to false, the widget does not automatically open the first conversation on load. Defaults to true. | --- @@ -153,6 +155,7 @@ Click **Save**, publish the site, then **Visit Website** to confirm the widget a //chatType: "user" | "group", //defaultChatID: "uid_or_guid", //dockedAlignment: "left" | "right" + //autoOpenFirstItem: false, }; const startWidget = () => CometChatApp.CometChatAuth.start(COMETCHAT_WIDGET_CONFIG); @@ -178,6 +181,7 @@ Click **Save**, publish the site, then **Visit Website** to confirm the widget a | `chatType` | Determines the type of conversation the widget initiates by default (one-on-one user chat or a group chat). | | `defaultChatID` | The specific chat with user (`uid`) or group (`guid`) that should automatically open when the widget loads. | | `dockedAlignment` | Controls the position of the docked widget interface on the page (left side or right side). | +| `autoOpenFirstItem` | When set to false, the widget does not automatically open the first conversation on load. Defaults to true. | ### Memberstack auto-login (Webflow + Memberstack, still UID flow) @@ -403,6 +407,7 @@ Full walkthrough: [How to properly log in and create users in CometChat](https:/ //chatType: "user" | "group", //defaultChatID: "uid_or_guid", //dockedAlignment: "left" | "right" + //autoOpenFirstItem: false, }; const startWidget = () => CometChatApp.CometChatAuth.start(COMETCHAT_WIDGET_CONFIG); @@ -427,6 +432,7 @@ Full walkthrough: [How to properly log in and create users in CometChat](https:/ | `chatType` | Determines the type of conversation the widget initiates by default (one-on-one user chat or a group chat). | | `defaultChatID` | The specific chat with user (`uid`) or group (`guid`) that should automatically open when the widget loads. | | `dockedAlignment` | Controls the position of the docked widget interface on the page (left side or right side). | +| `autoOpenFirstItem` | When set to false, the widget does not automatically open the first conversation on load. Defaults to true. | --- diff --git a/widget/wix/integration.mdx b/widget/wix/integration.mdx index 25d58cd05..85835e415 100644 --- a/widget/wix/integration.mdx +++ b/widget/wix/integration.mdx @@ -71,6 +71,7 @@ Add the CometChat Widget with a single snippet inside Wix’s **Embed HTML** ele //chatType: "user" | "group", //defaultChatID: "uid_or_guid", //dockedAlignment: "left" | "right" + //autoOpenFirstItem: false, }; const startWidget = () => CometChatApp.CometChatAuth.start(COMETCHAT_WIDGET_CONFIG); @@ -94,6 +95,7 @@ Add the CometChat Widget with a single snippet inside Wix’s **Embed HTML** ele | `chatType` | Determines the type of conversation the widget initiates by default (one-on-one user chat or a group chat). | | `defaultChatID` | The specific chat with user (`uid`) or group (`guid`) that should automatically open when the widget loads. | | `dockedAlignment` | Controls the position of the docked widget interface on the page (left side or right side). | +| `autoOpenFirstItem` | When set to false, the widget does not automatically open the first conversation on load. Defaults to true. | --- @@ -133,6 +135,7 @@ Add the CometChat Widget with a single snippet inside Wix’s **Embed HTML** ele //chatType: "user" | "group", //defaultChatID: "uid_or_guid", //dockedAlignment: "left" | "right" + //autoOpenFirstItem: false, }; const startWidget = () => CometChatApp.CometChatAuth.start(COMETCHAT_WIDGET_CONFIG); @@ -158,6 +161,7 @@ Add the CometChat Widget with a single snippet inside Wix’s **Embed HTML** ele | `chatType` | Determines the type of conversation the widget initiates by default (one-on-one user chat or a group chat). | | `defaultChatID` | The specific chat with user (`uid`) or group (`guid`) that should automatically open when the widget loads. | | `dockedAlignment` | Controls the position of the docked widget interface on the page (left side or right side). | +| `autoOpenFirstItem` | When set to false, the widget does not automatically open the first conversation on load. Defaults to true. | --- @@ -198,6 +202,7 @@ Full walkthrough: [How to properly log in and create users in CometChat](https:/ //chatType: "user" | "group", //defaultChatID: "uid_or_guid", //dockedAlignment: "left" | "right" + //autoOpenFirstItem: false, }; const startWidget = () => CometChatApp.CometChatAuth.start(COMETCHAT_WIDGET_CONFIG); @@ -222,6 +227,7 @@ Full walkthrough: [How to properly log in and create users in CometChat](https:/ | `chatType` | Determines the type of conversation the widget initiates by default (one-on-one user chat or a group chat). | | `defaultChatID` | The specific chat with user (`uid`) or group (`guid`) that should automatically open when the widget loads. | | `dockedAlignment` | Controls the position of the docked widget interface on the page (left side or right side). | +| `autoOpenFirstItem` | When set to false, the widget does not automatically open the first conversation on load. Defaults to true. | --- From 370701f140754e98cb6143aa1dd41970fd898fec Mon Sep 17 00:00:00 2001 From: Kiro Agent Date: Thu, 30 Apr 2026 17:41:09 +0530 Subject: [PATCH 11/14] 44265 --- sdk/javascript/default-call.mdx | 4 ++++ sdk/javascript/direct-call.mdx | 4 ++++ 2 files changed, 8 insertions(+) diff --git a/sdk/javascript/default-call.mdx b/sdk/javascript/default-call.mdx index 8ac8fd1af..d9f591019 100644 --- a/sdk/javascript/default-call.mdx +++ b/sdk/javascript/default-call.mdx @@ -4,6 +4,10 @@ sidebarTitle: "Ringing" description: "Implement a complete calling workflow with ringing, incoming/outgoing call UI, accept/reject/cancel functionality, and call session management." --- + +**Calls SDK Version:** This page documents the **Calls SDK v4.x** APIs (`CallSettingsBuilder`, `CometChatCalls.generateToken()`, `OngoingCallListener`). If you are using **Calls SDK v5.x (Beta)**, refer to the [Calls SDK v5 Ringing documentation](/calls/javascript/ringing) instead. Do not mix v4 and v5 APIs — they are not interchangeable. + + {/* TL;DR for Agents and Quick Reference */} diff --git a/sdk/javascript/direct-call.mdx b/sdk/javascript/direct-call.mdx index c0e5b663f..f40525d7d 100644 --- a/sdk/javascript/direct-call.mdx +++ b/sdk/javascript/direct-call.mdx @@ -4,6 +4,10 @@ sidebarTitle: "Call Session" description: "Learn how to generate call tokens, start and manage call sessions, configure call settings, and handle call events using the CometChat JavaScript Calls SDK." --- + +**Calls SDK Version:** This page documents the **Calls SDK v4.x** APIs (`CallSettingsBuilder`, `CometChatCalls.generateToken()`, `OngoingCallListener`). If you are using **Calls SDK v5.x (Beta)**, refer to the [Calls SDK v5 documentation](/calls/javascript/setup) instead. Do not mix v4 and v5 APIs — they are not interchangeable. + + ```javascript From c1022e370e207ec7220b7c13080164907309410b Mon Sep 17 00:00:00 2001 From: Kiro Agent Date: Thu, 30 Apr 2026 17:43:19 +0530 Subject: [PATCH 12/14] 44285 --- rest-api/constraints-rate-limits-and-errors.mdx | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/rest-api/constraints-rate-limits-and-errors.mdx b/rest-api/constraints-rate-limits-and-errors.mdx index ac7dfb1a6..8bae4d39c 100644 --- a/rest-api/constraints-rate-limits-and-errors.mdx +++ b/rest-api/constraints-rate-limits-and-errors.mdx @@ -88,6 +88,10 @@ title: "Constraints, Rate Limits And Errors" | Core operations | 10,000 requests/min | User connection, create/delete user, create/join/leave group | | Standard operations | 20,000 requests/min | All other operations (sending messages, fetching conversations, updating profiles) | | Build plan (free) | 500 requests/min | Applies to both core and standard operations | + + +The **free Build plan** is intended strictly for testing and development purposes. It cannot be used in a production environment with real end users. To go live, upgrade to a paid plan from the [CometChat Dashboard](https://app.cometchat.com). + | Send message | 30 messages/min | Per user rate limit for sending messages | | Mark as unread | 5 requests/min | Per user rate limit for marking messages as unread | | Data import | 60 requests/min | Rate limit for bulk data import operations | From a2a477cca5792cd136821e091a7281f36422519e Mon Sep 17 00:00:00 2001 From: Kiro Agent Date: Mon, 4 May 2026 16:28:14 +0530 Subject: [PATCH 13/14] 43261 --- rest-api/users/delete.mdx | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/rest-api/users/delete.mdx b/rest-api/users/delete.mdx index 56c83941e..80e5049d0 100644 --- a/rest-api/users/delete.mdx +++ b/rest-api/users/delete.mdx @@ -4,3 +4,7 @@ description: "Deletes a user for the specified UID" --- For the complete error reference, see [Error Guide](/articles/error-guide). + + +**Permanent deletion:** By default, deleting a user only deactivates them. To **permanently** delete a user along with all their messages, conversations, and associated data, you must include `permanent: true` in the request body. This action is irreversible. + From 44a7759fb12a2f3d7361d733ea8c1b90a6c2a4c9 Mon Sep 17 00:00:00 2001 From: Kiro Agent Date: Mon, 4 May 2026 16:43:41 +0530 Subject: [PATCH 14/14] 43276 --- calls/javascript/virtual-background.mdx | 16 +++++++++++++++- calls/v4/javascript/virtual-background.mdx | 4 ++++ 2 files changed, 19 insertions(+), 1 deletion(-) diff --git a/calls/javascript/virtual-background.mdx b/calls/javascript/virtual-background.mdx index d89c605e1..ce9457a92 100644 --- a/calls/javascript/virtual-background.mdx +++ b/calls/javascript/virtual-background.mdx @@ -79,5 +79,19 @@ Virtual backgrounds use machine learning for background segmentation. Performanc - Browser version - Camera resolution -For best results, use a modern browser on a device with adequate processing power. +### Browser Compatibility + +| Platform | Browser | Supported | +|----------|---------|-----------| +| Desktop (Windows, macOS, Linux) | Chrome | ✅ Yes | +| Desktop (Windows, macOS, Linux) | Firefox | ✅ Yes | +| Desktop | Safari, Edge, others | ❌ Not supported | +| iOS (iPhone, iPad) | Safari, Chrome, any browser | ❌ Not supported | +| Android | Chrome | ❌ Not supported | + + +Virtual background is **only supported on desktop Chrome and Firefox**. All browsers on iOS use WKWebView under the hood, which does not provide the APIs required for real-time background segmentation. + + +For best results, use desktop Chrome or Firefox on a device with adequate processing power. diff --git a/calls/v4/javascript/virtual-background.mdx b/calls/v4/javascript/virtual-background.mdx index db532c0c0..5ff75ae60 100644 --- a/calls/v4/javascript/virtual-background.mdx +++ b/calls/v4/javascript/virtual-background.mdx @@ -16,6 +16,10 @@ description: "CometChat Calling SDK v4 - Stable Release - Virtual Background for This section will guide you to implement virtual background feature in video calls. + +**Browser Compatibility:** Virtual background is supported on **desktop Chrome only**. It is **not supported on iOS device browsers** (Safari, Chrome for iOS, or any browser) because all iOS browsers use WKWebView, which does not provide the APIs required for real-time background segmentation. + + ## Implementation Once you have decided to implement [Ringing](/calls/v4/javascript/ringing) or [Call Session](/calls/v4/javascript/call-session) calling and followed the steps to implement them. Just few additional methods will help you quickly implement virtual background.