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. |

- 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.

Try it with

ChatGPT Claude Gemini

Frequently Asked Questions

What is the Knowledge Base Article Optimizer prompt?

Transform rough support notes or FAQs into polished, searchable knowledge base articles with clear structure, troubleshooting steps, and SEO-friendly formatting. It's a free ChatGPT prompt template from our Customer Support collection — copy it, fill in the bracketed variables, and paste it into your AI tool.

Which AI tools work with this prompt?

It's written and tested for ChatGPT, Claude and Gemini. Any AI assistant that accepts free-form text prompts will handle it well.

How do I customize this ChatGPT prompt?

Replace the bracketed variables — such as [product/service name], [Screenshot: description] — with your own details before running it. Paste actual support tickets as raw input — the AI will extract the real customer language, which improves searchability.