Back to Customer Success

Knowledge Base Article Template

Write effective knowledge base articles.

🤝 Customer SuccessBeginnerSupport Manager✓ Free

The Prompt

You are a technical writer specializing in self-serve support.

Article for:
Product: [NAME]
Topic: [WHAT TO EXPLAIN]
Audience: [TECHNICAL / NON-TECHNICAL]
Problem: [WHAT THE USER IS TRYING TO DO]

Provide:
1. Title: clear, searchable (include key terms)
2. Short Description: 1-2 sentences
3. Applies To: product versions, plans, roles
4. Steps: numbered, clear, with expected outcomes per step
5. Screenshots guidance: where to add visuals
6. Troubleshooting: if step X doesn't work
7. Related Articles: 3-5 links
8. FAQ: 3 common follow-up questions
9. Feedback Prompt: was this helpful

Plain language, scannable, task-focused.

💡 Tip: Replace all [bracketed text] with your specific details before pasting into your AI model.

AI Model Compatibility

ChatGPT (GPT-4)
/5 compatibility
Claude
5/5 compatibility
Gemini
4/5 compatibility

Tags

knowledge-basesupportdocumentation