Back to prompts
Customer SupportChatGPTClaudeGemini

Knowledge Base Article Optimizer

Transform rough support notes or FAQs into polished, searchable knowledge base articles with clear structure, troubleshooting steps, and SEO-friendly formatting.

Prompt Template

I need to create (or rewrite) a knowledge base article for our [product/service name] help center.

**Topic:** [describe the issue or feature the article covers]

**Raw information / current draft:**
[paste existing notes, support ticket examples, or rough draft]

**Target audience:** [e.g., non-technical end users, IT admins, developers]

Please create a polished knowledge base article following these guidelines:

1. **Title**: Clear, search-friendly title using the words customers actually type
2. **Summary**: 1-2 sentence overview at the top (answers the question immediately)
3. **Applies to**: Product version, plan tier, or platform (if relevant)
4. **Step-by-step instructions**: Numbered steps with expected outcomes after each step
5. **Screenshots/visual placeholders**: Indicate where screenshots should be added with [Screenshot: description]
6. **Troubleshooting section**: "Still not working?" with 3-5 common failure scenarios and fixes
7. **Related articles**: Suggest 3 related topics that should be linked
8. **SEO metadata**: Suggested meta title (under 60 chars) and meta description (under 155 chars)

Tone: Friendly, confident, jargon-free. Use "you" and "your." Write at a 6th-grade reading level.

Example Output

# How to Reset Your Password

**Quick answer:** Go to the login page, click "Forgot password," enter your email, and follow the link in your inbox to set a new password.

**Applies to:** All plans (Free, Pro, Enterprise) · Web and mobile app


Steps to Reset Your Password

1. Go to [yourapp.com/login](https://yourapp.com/login)

2. Click **"Forgot password?"** below the password field

[Screenshot: Login page with "Forgot password" link highlighted]

3. Enter the email address associated with your account

4. Click **"Send reset link"**

5. Check your inbox for an email from no-reply@yourapp.com

- **Expected:** Email arrives within 2 minutes

6. Click the **"Reset my password"** button in the email

7. Enter your new password (must be at least 8 characters with one number)

8. Click **"Save new password"**

9. You'll be redirected to the login page — sign in with your new password ✅


Still Not Working?

| Problem | Solution |

|---------|----------|

| Didn't receive the reset email | Check your spam/junk folder. Add no-reply@yourapp.com to your contacts and try again. |

| Reset link says "expired" | Links expire after 30 minutes. Request a new one from the login page. |

| "Email not found" error | You may have signed up with a different email or via Google/SSO. Try those options. |

| New password not accepted | Ensure it meets requirements: 8+ characters, at least one number. Avoid reusing your last 3 passwords. |


Related Articles

- How to enable two-factor authentication (2FA)

- How to update your email address

- Signing in with Google or SSO

SEO Metadata

**Meta title:** How to Reset Your Password | YourApp Help Center

**Meta description:** Forgot your password? Follow these simple steps to reset your YourApp password in under 2 minutes. Works on web and mobile.

Tips for Best Results

  • 💡Paste actual support tickets as raw input — the AI will extract the real customer language, which improves searchability.
  • 💡Always specify your audience's technical level; an article for IT admins should read very differently than one for consumers.
  • 💡Use the [Screenshot: ...] placeholders to create a checklist for your design team.
  • 💡Run the output through a readability checker (like Hemingway Editor) to verify the reading level.