diff --git a/docs.json b/docs.json
index 0468cd4f..022c0560 100644
--- a/docs.json
+++ b/docs.json
@@ -171,6 +171,12 @@
"pages": [
"fundamentals/user-roles-and-permissions"
]
+ },
+ {
+ "group": "Guides",
+ "pages": [
+ "fundamentals/user-auth"
+ ]
}
]
},
diff --git a/fundamentals/user-auth.mdx b/fundamentals/user-auth.mdx
new file mode 100644
index 00000000..7e079936
--- /dev/null
+++ b/fundamentals/user-auth.mdx
@@ -0,0 +1,56 @@
+---
+title: "Authentication and User Management"
+description: "Create users, issue auth tokens, and log users into CometChat."
+---
+
+## Create and Log In a User
+
+### Guide details
+
+This guide provides a step-by-step guide on creating and logging in a user using the CometChat platform with authentication using the Authentication Token. Additionally, you will need to make sure you have initialized CometChat in your app prior to logging in the user.
+
+### Introduction
+
+To log in a user, they must first be registered on the CometChat server. For first-time logins, the user needs to be created in CometChat. After this initial creation, we can generate an authentication token for the user.
+
+This authentication token, created via the CometChat API, will be used on the front-end to log the user into the **CometChat UI Kit, SDK, or Widget**.
+
+Once the user is successfully logged into CometChat, we can proceed to request or post any necessary data for the app.
+
+## Prerequisites
+
+* CometChat App (You can create one via the [CometChat Dashboard](https://app.cometchat.com/apps)).
+* CometChat UI Kit or SDK (Custom Widget as well).
+* Your application: Front-end and Back-end / Server Side.
+
+## Create Chat User in CometChat
+
+1. Handle the user creation endpoint in your application.
+2. Add the user to your database.
+3. Invoke the [CometChat API endpoint to create a user](https://api-explorer.cometchat.com/reference/creates-user).
+
+ * Optionally, pass a parameter to generate an authentication token for this user.
+
+4. CometChat will respond with the authentication token to your server.
+5. Your server will send the successful user creation response to your front-end application.
+6. Utilize the CometChat auth token to log the user into the [CometChat SDK / UI Kit](https://www.cometchat.com/docs/javascript-chat-sdk/authentication#login-using-auth-token), or [Widget](/widget/html/integration#3-backend-created-user-auth-token-login).
+
+
+
+
+
+## Log In an Existing User
+
+1. Authenticate the user within your application.
+2. Your API will then request a CometChat auth token for the user. You can call the [create auth token API endpoint](https://api-explorer.cometchat.com/reference/create-authtoken) to create a new one.
+3. Your server responds with the successful retrieval of the CometChat auth token to your front-end application.
+4. Utilize the CometChat auth token to log the user into the [CometChat SDK / UI Kit](https://www.cometchat.com/docs/javascript-chat-sdk/authentication#login-using-auth-token),
+5. If you’re using the **Widget Builder**, refer to the documentation on **[auth token–based user login](/widget/html/integration#3-backend-created-user-auth-token-login)**.
+
+
+
+
+
+## Migrate Existing Users to CometChat
+
+If you need to migrate the existing users, refer to the [Data Import Guide](https://www.cometchat.com/docs/rest-api/data-import)
\ No newline at end of file
diff --git a/images/create-chat-user.png b/images/create-chat-user.png
new file mode 100644
index 00000000..fcbbbcb2
Binary files /dev/null and b/images/create-chat-user.png differ
diff --git a/images/log-in-chat-user.png b/images/log-in-chat-user.png
new file mode 100644
index 00000000..9247c6c9
Binary files /dev/null and b/images/log-in-chat-user.png differ
diff --git a/notifications/android-push-notifications.mdx b/notifications/android-push-notifications.mdx
index 8a8c40f5..0ff00afd 100644
--- a/notifications/android-push-notifications.mdx
+++ b/notifications/android-push-notifications.mdx
@@ -4,7 +4,7 @@ description: "Setup FCM and CometChat for message and call push notifications on
---
diff --git a/notifications/ios-apns-push-notifications.mdx b/notifications/ios-apns-push-notifications.mdx
index 046a9909..7fe49aca 100644
--- a/notifications/ios-apns-push-notifications.mdx
+++ b/notifications/ios-apns-push-notifications.mdx
@@ -4,7 +4,7 @@ description: "Implement APNs push notifications with CometChat UIKit for iOS, in
---
diff --git a/notifications/ios-fcm-push-notifications.mdx b/notifications/ios-fcm-push-notifications.mdx
index c8bdfebd..406ebf33 100644
--- a/notifications/ios-fcm-push-notifications.mdx
+++ b/notifications/ios-fcm-push-notifications.mdx
@@ -6,7 +6,7 @@ description: "Guide to integrating Firebase Cloud Messaging (FCM) push notificat
FCM doesn't support VoIP pushes; use APNs + PushKit for VoIP calls.