Product Changelog — User-Facing
Announce a feature ship. Lead with the job it does, not the feature name.
Prompt
**Role:** Product marketing lead who writes the public changelog for a SaaS used by 100,000+ active users. You know which entries get read and which get skipped. **Context:** Feature shipped: [name + 1-sentence description]. The job it does: [what user task it makes faster/easier/possible]. The user who asked for this: [a real persona, paraphrased]. The trade-off (if any): [what changed that some users might not like]. **Task:** Write the changelog entry. 1. Title: 6-9 words. Lead with the JOB, not the feature name. NOT "New: Saved Views" but "Save and reuse your filtered dashboards." 2. Intro paragraph: 2-3 sentences. The job + the moment the user feels the win. 3. Visual: short caption for the screenshot/GIF that should accompany this. Describe what's IN the visual. 4. How it works: 3 numbered steps a user can follow today. 5. Why we shipped it: 1-2 sentences. Reference the user research or specific request (paraphrased) that drove it. 6. Trade-offs (if any): be honest about what changed. "Old behavior X is now Y. If you relied on X, here's the workaround." **Constraints:** - No "We're excited to announce" - No "improved performance" without a number - Steps must be testable (a user can do exactly what step 2 says) - Trade-off section is required IF any default behavior changed **Output format:** 6 sections · ≤300 words · with visual caption.
How to use this prompt
- 1
Copy the prompt above and paste it into ChatGPT, Claude, or Gemini — or open it in the visual Studio to edit each part on a canvas and run it with your own key.
- 2
Replace any bracketed placeholders with your specifics. The more concrete your context and constraints, the sharper the result — see the 5-part prompt structure.
- 3
Run it, then refine. Ask the model to critique and improve its own answer with self-critique prompting.
Techniques in this prompt
Assigns the model an expert persona so it adopts the right vocabulary, depth, and standards for the task.
Learn this techniqueSets the rules and boundaries — tone, length, what to avoid — that keep the output on-target.
Learn this techniqueSpecifies the exact shape of the result — sections, a table, JSON, a word count — so the output is predictable and ready to use.
Learn this techniqueRecommended models
Build on this prompt
Open it in the visual Studio to wire it into a full workflow with your own API key — or learn the craft behind prompts like this.
More in Writing
Brand Voice Rewrite
Take any draft and rewrite it in your brand's voice. Keep meaning, drop hedges.
Newsletter Issue — Specific Subject Line
Hook earns the open. 3 curated items, one personal note, soft CTA.
Resume Rewrite — Tech IC
Cut every adjective. Quantify three things. Make the recruiter call you back.
Conference Talk Abstract
Submit a talk that reviewers can't skip. Hook, claim, 3 takeaways, audience.