diff --git a/components/troubleshooting-flow.tsx b/components/troubleshooting-flow.tsx
index f9c82a4..67d27e9 100644
--- a/components/troubleshooting-flow.tsx
+++ b/components/troubleshooting-flow.tsx
@@ -84,12 +84,13 @@ const troubleshootingPaths: TroubleshootingPath[] = [
'Update Codex and the extension to the latest version.',
'Restart the application or reload the editor window.',
'Confirm your password meets the requirements.',
- 'Use password reset if you already created an account.',
+ 'Use the Forgot Password option on the login screen (detailed guide available).',
'Make sure the app has the permissions it requests.',
'Check your network if the issue involves sign-in or AI access.',
'Check the Codex Status page (status.codexeditor.com) to see if the servers are currently down.',
],
docs: [
+ { title: 'Forgot Password', href: '/docs/getting-started/forgot-password' },
{ title: 'Initial Setup', href: '/docs/getting-started/initial-setup' },
{ title: 'FAQ', href: '/docs/faq' },
{ title: 'Codex Status', href: 'https://status.codexeditor.com' },
diff --git a/content/docs/faq.mdx b/content/docs/faq.mdx
index e09d271..80d4c6f 100644
--- a/content/docs/faq.mdx
+++ b/content/docs/faq.mdx
@@ -304,7 +304,11 @@ Yes. Projects are stored locally on your device, allowing for offline work. Chan
### I forgot my password. How do I reset it?
-Use the password reset option on the login screen. This is why it's important to use a real email address during [registration](/docs/getting-started/initial-setup).
+See the full step-by-step guide:
+
+**[Forgot Your Password →](/docs/getting-started/forgot-password)**
+
+Use the **Forgot Password** option on the login screen. This is why it's important to use a real email address during [registration](/docs/getting-started/initial-setup).
---
diff --git a/content/docs/getting-started/forgot-password.mdx b/content/docs/getting-started/forgot-password.mdx
new file mode 100644
index 0000000..ce07169
--- /dev/null
+++ b/content/docs/getting-started/forgot-password.mdx
@@ -0,0 +1,70 @@
+---
+title: Forgot Your Password
+description: "Reset your Codex Editor password if you've forgotten it. Quick guide for the login screen reset flow."
+---
+
+# Forgot Your Password?
+
+If you can't remember your password, use the **Forgot Password** flow directly from the Codex login screen. This is the fastest way to regain access.
+
+## Reset Your Password (Step by Step)
+
+1. **Open the login screen**
+ - Launch Codex Editor
+ - If you're already logged in, log out first (or restart the app to reach the login screen)
+
+2. **Click "Forgot Password"**
+ - On the login screen, look for and click the **Forgot Password** option
+
+3. **Enter your registered email**
+ - Use the exact email address you used when you created your account
+
+4. **Check your email**
+ - Look in your inbox for a password reset email from Codex
+ - **Also check spam, junk, and promotions folders**
+
+5. **Click the reset link**
+ - Open the email and click the password reset link (the link expires after some time)
+
+6. **Create a new password**
+ - Must be at least **15 characters** long
+ - Must contain at least one **uppercase** letter and one **lowercase** letter
+ - Confirm the new password
+
+7. **Log in**
+ - Return to the login screen
+ - Enter your **username** (case sensitive) or **email address**
+ - Enter your new password
+
+## Critical Requirements
+
+
+**You must have used a real email address during registration.**
+
+Fake or temporary emails cannot receive password reset links. This is why the registration screen strongly warns you to use a real or reliable email.
+
+
+- Usernames are **case sensitive** — double-check capitalization if login fails after reset.
+- You can also use your registered **email address** in the username field to log in.
+
+## Didn't Receive the Reset Email?
+
+- Wait 2–5 minutes after requesting the reset.
+- Search your entire email (including spam) for "Codex", "password", or "reset".
+- Request the reset link again — you can do this multiple times.
+- Make sure you're entering the **exact email** used at registration.
+
+If you still cannot receive or complete the reset:
+
+- Go to the **[Troubleshooting guide](/docs/troubleshooting)** and choose **"I cannot log in or finish setup"**.
+- Or contact support on [Discord](https://discord.gg/6kVJTEXYEp) with details of what you've tried.
+
+## Related Guides
+
+- [Initial Setup & Registration](/docs/getting-started/initial-setup) — Full account creation and login instructions
+- [Frequently Asked Questions](/docs/faq) — Other common account questions
+- [Troubleshooting](/docs/troubleshooting) — Guided support flow for login problems
+
+---
+
+**Tip:** Write down or securely store your username and the email you used for registration. This makes future password resets much easier.
\ No newline at end of file
diff --git a/content/docs/getting-started/initial-setup.mdx b/content/docs/getting-started/initial-setup.mdx
index c48cd92..143550a 100644
--- a/content/docs/getting-started/initial-setup.mdx
+++ b/content/docs/getting-started/initial-setup.mdx
@@ -64,6 +64,11 @@ When you need to log in manually:
- Your account password
3. **Click Login**: Submit your credentials to access your account
+
+Forgot your password? Use the **Forgot Password** option on the login screen.
+See the dedicated guide: **[Reset Forgotten Password →](/docs/getting-started/forgot-password)**
+
+
## Account Security Best Practices
### Password Guidelines
@@ -147,7 +152,7 @@ After registering, Codex logs you in automatically. You should not need to log i
1. Enter your **username** (case sensitive) or the **email address** you used to register.
2. Enter your password.
3. If you see an error message, note the exact text. Complete the [Troubleshooting guide](/docs/troubleshooting) support form and paste the generated template into [Discord](https://discord.gg/6kVJTEXYEp).
-4. If you forgot your password, use the **Forgot Password** option on the login screen. Check your spam folder for the reset email.
+4. If you forgot your password, use the **[Forgot Password](/docs/getting-started/forgot-password)** flow on the login screen. Check your spam folder for the reset email.
#### Registration is not working
@@ -166,7 +171,7 @@ If registration still fails, complete the [Troubleshooting guide](/docs/troubles
#### Common account issues
- **Username already taken**: Try variations of your preferred username, or add numbers or underscores to make it unique.
-- **Email already registered**: You may already have an account. Try the password reset option if you have forgotten your credentials.
+- **Email already registered**: You may already have an account. Use the **[Forgot Password](/docs/getting-started/forgot-password)** flow if you need to regain access.
---
diff --git a/content/docs/getting-started/meta.json b/content/docs/getting-started/meta.json
index a62ebe7..87b8026 100644
--- a/content/docs/getting-started/meta.json
+++ b/content/docs/getting-started/meta.json
@@ -2,6 +2,7 @@
"title": "Getting Started",
"pages": [
"download-codex",
- "initial-setup"
+ "initial-setup",
+ "forgot-password"
]
}
\ No newline at end of file