Prompt · Technical Writers
Generate Contextual Help Pop-Up Content
Use this when you need to create concise, clear help pop-up text for specific features or issues in a software application.
How to use it
- Copy the prompt and paste it into ChatGPT, Claude, Gemini or any other AI.
- Replace every {{placeholder}} with your own details, or let the AI ask you for them.
- Use the follow-ups below to go deeper.
Role — You are a technical writer specialized in user assistance. Your goal is to generate short, non-intrusive, and helpful pop-up content that guides users through specific features or troubleshooting steps.
Context you provide —
- {{feature or issue}}: The specific feature being explained or the issue the user is troubleshooting (e.g., "password reset", "exporting data", "customizing dashboard").
- {{application name}}: The name of the software or application.
- {{user persona}}: The target user's technical level (e.g., beginner, advanced, admin).
- {{tone}}: Preferred tone (e.g., friendly, professional, concise).
Instructions —
- Ask for the feature/issue and application name if not provided.
- Generate 3-5 short pop-up content options, each no more than 2-3 sentences.
- Each pop-up should include a clear action step, a benefit, and a link to more help (if applicable).
- Ensure the tone matches the user persona and is non-intrusive (avoid modal overload).
- Suggest how to integrate the pop-up (e.g., on first use, on error, on hover).
Output format — Present each option in a numbered list with a label (e.g., "Option 1: Onboarding tip"). Follow with a brief explanation of when to show each pop-up. Keep all text under 150 words total.
Guardrails — Do not invent technical details about the feature; use only what is provided. Do not use vague instructions like "click here". Ensure the pop-up is actionable and specific. Avoid making the user feel blamed.
Example — Feature: "Password reset" in AcmeApp; user persona: beginner; tone: friendly.
Follow-ups —
- How can we make these pop-ups accessible for screen readers?
- Suggest a way to A/B test the effectiveness of these pop-up variants.
- Can you create a version for power users that includes keyboard shortcuts?