Copywriting
Rules
- AI-assisted drafts: use YepAPI
POST /v1/ai/chatto generate headline variations, taglines, and body copy — always review and edit output - Headline formula: [Number] + [Adjective] + [Keyword] + [Promise] — e.g., "7 Simple Ways to Reduce Churn by 40%"
- CTA optimization: one primary CTA per page, action-oriented verb ("Start free trial", not "Submit"), high contrast button
- Tone guide: define brand voice attributes (e.g., professional but friendly, concise, no jargon) — store in a
tone-guide.mdand reference it in prompts - A/B testing: generate 3-5 headline variants, test with feature flags — measure CTR, not just impressions
- Character limits: headlines <70 chars, meta descriptions <160 chars, email subject lines <50 chars, CTA buttons <5 words
- Social proof: include numbers ("10,000+ teams"), quotes, or logos near CTAs — increases conversion 15-30%
- Scannable copy: short paragraphs (2-3 sentences), bullet points for features, bold key phrases
AI Copy Generation Pattern
Use YepAPI AI chat to generate variations:
{
"messages": [
{ "role": "system", "content": "You are a conversion copywriter. Brand voice: {toneGuide}" },
{ "role": "user", "content": "Write 5 headline variations for: {productDescription}" }
]
}
Avoid
- Generic CTAs ("Click here", "Submit", "Learn more") — be specific about the action
- Walls of text — break into scannable chunks
- Feature-focused copy without benefits — translate features into outcomes
- Inconsistent tone across pages — use the tone guide everywhere