COMPLETE USER GUIDE

RUN YOUR FIRST TEST

Test any post in 60 seconds. See how it scores.

1. Open post or page in editor
2. Scroll to "AI Content Focus Groups" meta box
3. Select General Public
4. Click Analyse Content
5. The analysis is queued and processed by WordPress cron (runs every 5 minutes). You can either wait several minutes for automatic processing, or go to AI Focus Groups → Job Queue and click "Run Now" to process immediately
6. Click View Report

WHAT YOU'LL SEE

• Five scores (0-100): Sentiment, Clarity, Engagement, Tone, Readability
• Summary of findings
• Quick wins (easy improvements)
• Biggest gaps (major issues)
• Suggested improvements

UNDERSTANDING SCORES

Five dimensions. Each measures something specific.

SENTIMENT

How content makes readers feel. Positive, neutral, negative.

Low score? Check for stress language, unintended negativity.

CLARITY

How easy to understand. Catches jargon and complexity.

Low score? Replace jargon. Split complex sentences.

ENGAGEMENT

What hooks readers and what loses them.

Low score? Strengthen hook. Cut boring sections.

TONE

How your voice lands. Must match audience expectations.

Low score? Adjust formality level to match audience.

READABILITY

Technical difficulty. Sentence length, word complexity.

Low score? Shorter sentences. Simpler words.

SCORE RANGES

• 80-100: Excellent
• 60-79: Good, minor fixes
• 40-59: Needs work
• 0-39: Major problems

CHOOSE YOUR AUDIENCE

Three pre-built groups. Pick based on who you're writing for.

GENERAL PUBLIC

Everyday readers. Broad audience. No specialist knowledge.

• Values clarity above all
• Use for blog posts, general content
• Avoid jargon and assumptions

BUSINESS PROFESSIONALS

Corporate readers. Executives and managers.

• Values ROI, data, professionalism
• Use for B2B content, white papers
• Expect professional tone and metrics

YOUNG ADULTS (18-30)

Digital natives. Value authenticity.

• Values casual tone, no corporate speak
• Use for millennial/Gen Z marketing
• Avoid formality and trying too hard

YOUR PUBLISHING WORKFLOW

Make testing part of your process.

1. Write draft
2. Self-edit
3. Test with focus group
4. Read feedback carefully
5. Make improvements (focus on lowest scores)
6. Test again if major changes (30%+ rewrite)
7. Publish when scores hit 75+

CUSTOM FOCUS GROUPS PRO

Build personas matching your exact audience.

HOW TO CREATE

1. AI Focus Groups → Focus Groups
2. Click "Add New Focus Group"
3. Enter name and description
4. Select expertise level
5. Define persona details
6. Save and activate

PERSONA DETAILS

• Identity: Age, occupation, role
• Context: When/where they read
• Values: What matters to them
• Behavior: How they read
• Frustrations: What annoys them

AI PROVIDERS PRO

Switch between OpenAI, Claude, and Gemini.

OPENAI (GPT-4O)

• Fast, reliable, general-purpose
• Best for most content
• ~$0.005 per analysis

CLAUDE (ANTHROPIC)

• Nuanced tone analysis
• Best for sensitive topics
• ~$0.003-$0.015 per analysis

GOOGLE GEMINI

• Technical content, long articles
• Large context windows
• ~$0.001-$0.005 per analysis

HOW TO SWITCH

1. Get API key from provider
2. Settings → AI Focus Groups
3. Select provider
4. Paste API key
5. Select model
6. Save

ADVANCED FEATURES PRO

CONTENT REWRITES

Generate AI-powered rewrites based on feedback.

• Run analysis first
• Click "Generate Rewrite"
• Compare original vs rewritten
• Pick best suggestions
• Version history saves all rewrites

USING REWRITTEN CONTENT

Copy rewritten content directly into your post editor.

Step 1: Open the post you want to update

• Go to Posts → All Posts (or Pages → All Pages)
• Find the post you want to update
• Click "Edit" to open the editor

Step 2: Open the version modal

• Scroll to the "AI Content Focus Groups" meta box
• Click "View Versions" to open the version modal
• Review the available rewritten versions

Step 3: Copy the content you want

• Select the rewritten version you prefer
• Click the copy button next to any section (title, paragraph, etc.)
• You can click multiple copy buttons to add multiple sections to your clipboard
• Or use the "Copy All" button to copy the entire rewritten version at once
• All copied content is stored in your clipboard ready to paste

Step 4: Paste into your editor

• Gutenberg: Select the paragraph block and paste
• Elementor: Open text editor widget and paste
• Divi: Open text module and paste into content area
• WPBakery: Open text block and paste
• Classic Editor: Switch to text or visual tab and paste

Formatting is preserved. Works with any page builder that accepts text content.

TROUBLESHOOTING

BUTTON GREYED OUT

• Check API key configured
• Check focus groups exist
• Check rate limit (10/hour)

INVALID API KEY ERROR

• Remove spaces from key
• Check provider match
• Add billing to OpenAI
• Verify key exists in dashboard

ANALYSIS STUCK

• Check Job Queue for errors
• Try again (API timeout)
• Use instant mode
• Check WordPress cron

SCORES SEEM WRONG

• AI simulates personas (not truth)
• Test multiple groups
• Context matters
• Use as guidance