Content Editor & Optimizer

The complete guide to writing, editing, and optimizing content in Floyi.

The Content Editor is Floyi’s all-in-one workspace for creating, editing, and optimizing content. You can access it by:

1. From Topical Authority → Click “Create Draft” on any keyword
2. From Content Briefs → Click “Generate Draft” after brief generation
3. From Projects → Open any existing article draft

The workspace consists of three main areas:

• Left Panel (collapsed by default): View your content brief
• Center: The rich text editor
• Right Panel: Settings & Optimizer tabs

Click Split Screen in the header to view your content brief alongside the editor. This helps you:

• Reference brief recommendations while writing
• Check structural suggestions
• Verify term coverage against competitor targets
• Stay aligned with strategic intent

Use the draggable divider to adjust panel widths.

The toolbar provides all formatting options for your content.

When inserting a link, you can configure:

• URL - The destination URL
• Link Text - Display text for the link
• Open in new tab - Whether to open externally
• Nofollow - Add rel=“nofollow” attribute

After inserting a table:

• Click any cell to edit
• Use the table menu to add/remove rows and columns
• Drag to resize columns
• Merge cells for complex layouts

Click the Search icon or press Cmd + F to open Find:

• Search for text in your content
• Navigate between matches with arrows
• Replace individual or all occurrences

Use the Zoom dropdown (bottom right) to adjust editor zoom level:

• 75%, 90%, 100%, 110%, 125%, 150%
• Helps readability without affecting actual content

The AI Writing Assistant is your in-editor AI copilot. Select any text and transform it instantly—simplify complex sentences, expand ideas, fix grammar, or give custom instructions.

For a deep dive into all features, see the AI Writing Assistant guide.

1. Select text in the editor (up to ~400 words)
2. AI bubble appears above your selection
3. Choose an action or type custom instructions
4. Preview the result before accepting

After the AI generates a result:

• Original tab → See your original text
• Generated tab → Preview the AI’s version (with proper formatting for lists, tables, links)

Actions:

• ✓ Accept → Replaces your selection with the AI version
• ✗ Reject → Keeps your original text, closes the panel

• Keep selections focused — 1-2 paragraphs work best
• Use Optimize Mode — Click Optimize, then select terms from the right panel to fill gaps
• Use Custom for tone — “Make it sound more confident” or “Use active voice”
• Links are preserved — Any links in your selection stay intact after transformation
• Works with formatting — Lists, bold, italic all render correctly in the preview

The right panel has three tabs: Settings, Optimizer, and Images.

Choose how the AI writes your content:

Note: You can only change Strategic Intent before generating your first draft.

After generating an initial draft, you can run Specialist Agents to enhance specific aspects:

How to use:

1. Select one or more specialists
2. (Optional) Add custom instructions
3. Click “Run Specialists”
4. Review the enhanced content

Add specific instructions for the AI:

• Click Edit Prompt to open the custom instructions modal
• Add guidance like “Include a comparison table” or “Focus on small businesses”
• These instructions apply to drafts and specialist runs

The Optimizer tab provides real-time content analysis and scoring.

The circular gauge shows your overall optimization score (0-100). Unlike simple keyword-count tools, Floyi’s score reflects multiple dimensions of content quality:

• How well you cover the terms that matter most to your topic (weighted by relevance, not just count)
• Whether high-priority terms are present at all
• Whether any terms are overused relative to what competitors do
• Content structure and heading hierarchy
• How easy your content is for AI to parse and cite
• Reading level appropriateness for your audience

Your score and competitor scores use the same model, so the comparison in the coverage heatmap is always apples-to-apples.

Tip: Aim for 70+ for well-optimized content.

Shows the data sources used for optimization:

• Competitors (6) - Top-ranking SERP pages analyzed
• AI (3) - Google AI Overview, AI Mode, ChatGPT responses

Click to expand and see individual sources with word counts.

Buttons:

• View Sources - See full content from each source
• Coverage - Open the term coverage heatmap

Lists all recommended terms and entities extracted from competitors and AI sources, organized in two groups:

• Terms — topical phrases, concepts, and keywords found across competitor and AI content
• Entities — named entities like companies, tools, frameworks, and people

Each term shows:

Color-coded usage indicators:

• ⬜ Gray = Not yet used in your content
• 🟢 Green = Used and within the target range
• 🟡 Yellow = Slightly above the competitor target
• 🔴 Red = Significantly over the target — likely keyword stuffing

The target for each term is based on how often top-ranking competitors actually use it, so you’re always benchmarking against real content that ranks.

Actions:

• Click term → Jump to first occurrence in editor
• Highlight icon → Toggle term highlighting in editor
• Hide icon → Remove term from list (can restore later)
• Highlight All → Highlight all terms at once

Shows content structure issues:

• Validates H2/H3/H4 hierarchy
• Flags skipped heading levels
• Recommends adding more sections if needed

• Identifies paragraphs that are too long (>100 words)
• Click any flagged paragraph to navigate to it
• Long paragraphs are harder for AI to cite

• Shows Flesch-Kincaid grade level
• Recommends improvements for accessibility
• Target: 8th-10th grade for general audiences depending on the topic. Keep the reading level appropriate for the target audience.

Click Coverage to open the full term coverage matrix:

• Numbers show frequency of each term per source
• Green = present, Red = missing
• Compare your coverage to competitors at a glance

Click View Sources to see full content from each source:

• Competitors: Full extracted text, summary, key claims, terms, entities
• AI Sources: Complete AI responses with extracted insights
• Expand/Collapse individual sources
• Expand All / Collapse All buttons at top

Generate AI images directly inside the editor and insert them into your article without leaving Floyi.

Click the AI Images button in the toolbar (or switch to the Images tab in the right sidebar) to open the image generation panel.

Click Analyze Draft to scan your article structure. Floyi identifies optimal image placements based on your H2 headings and content sections. Each suggested placement includes:

• Position — Which section the image belongs under (e.g., “After: Introduction”)
• AI-generated prompt — A detailed image description based on the section content
• Alt text — SEO-friendly alternative text for accessibility

You can edit any prompt before generating to fine-tune the image you want.

• Select/Deselect individual placements using checkboxes, or use Select All / Deselect All
• Choose a model from the dropdown at the bottom of the panel:

• Choose an aspect ratio — Options vary by model. Default is 16:9 (landscape), which works best for article content. Available ratios include 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, and 21:9.

Click Generate N Images to start. The button shows the total credit cost. During generation:

• A progress bar shows completion status
• Images appear as thumbnails in a grid when ready
• Partial failures show per-image error messages with retry options

After generation, you have two options:

• Click any thumbnail to open the full-size lightbox preview. Use arrow keys or click the arrows to navigate between images. Click Insert to place the image in your article below its target heading.
• Click “Insert All Remaining” to batch-insert all un-inserted images at once.

Inserted images show a green checkmark. If you delete an image from the article, the checkmark updates in real time so you can re-insert it.

• Generated images are stored permanently on Floyi’s CDN (Cloudflare R2) and linked to your article
• Inserted images are saved as part of your article content (doc_json) and persist across page refreshes
• Previously generated images load automatically when you return to the Images tab — no need to regenerate
• Click “Generate more” to create additional images while keeping your existing ones

If your Brand Foundation includes a visual style analysis, Floyi uses it to guide image generation — maintaining consistency with your brand’s aesthetic, color palette, and visual identity across all generated images.

• Use 16:9 or 3:2 aspect ratios for article images — they fit naturally in content flow
• Edit prompts before generating — the AI suggestions are a starting point, not final
• Start with Flux 2 Max for drafts (cheapest), switch to Seedream 5 for final quality
• Featured Image inserts at the top of your article with its own H2 heading

If you have a WordPress site connected in Settings > Integrations, you can publish your article directly from the editor.

The WordPress publish button appears in the editor header. It shows your current WordPress status:

Click the button to open the Publish to WordPress modal.

1. Select the WordPress site from the dropdown.
2. Choose the post type (Post, Page, or custom type).
3. Set the publish status (Draft, Publish Now, or Schedule).
4. Assign categories and tags (for Post type).
5. Choose an author from your WordPress site.
6. Expand SEO Metadata to review or edit the SEO title, meta description, and focus keyword. These are auto-filled from your brief.
7. Click Publish, Save as Draft, or Schedule.

Floyi converts your editor content to native Gutenberg blocks (or Classic HTML if your site uses the Classic Editor) and sends it with your configured metadata.

After editing a published article, the publish modal shows a blue “Published on WordPress” banner with the current status and a link to view the live page. Click Update to push the latest version. The WordPress post ID and URL remain the same.

If you have multiple connected WordPress sites, you can publish the same article to each one separately. Each site maintains its own publish record.

For full details, see the WordPress Publishing guide.

Content is automatically saved as you type (debounced 5 seconds). You’ll see:

• “Saving…” - Save in progress
• “Saved” - Content saved successfully
• “Save” button - Click to manually save

Click Save or press Cmd + S to save immediately.

Click Copy to copy your content:

• Copies as rich text (formatted)
• Paste directly into Google Docs, WordPress, etc.
• Preserves headings, lists, links, and formatting

Click Export to download your content:

Click View Brief to open your content brief in a new tab:

• See complete brief recommendations
• Review structural suggestions
• Check keyword targets

1. Start with the brief - Open split screen and review recommendations
2. Follow the structure - Use suggested H2s as your outline
3. Cover high-priority terms - Check the Optimizer for terms with R:80+ and work toward the competitor-based targets
4. Check issues - Fix heading and chunkability issues
5. Run specialists - Enhance with SEO, data, or conversion focus
6. Final review - Aim for 70+ optimization score

• Watch the color indicators — green means you’re in range, yellow means ease off, red means you’re overusing a term
• Break up long paragraphs — AI struggles to cite walls of text
• Use clear headings — H2 → H3 → H4 hierarchy helps both readers and search engines
• Match competitor depth — check competitor word counts in Source Overview
• Focus on high-relevance terms first — terms with R:80+ have the biggest impact on your score

• Run one at a time first to see individual improvements
• Use custom prompts to guide specific enhancements
• Review changes - specialists suggest improvements, you control final output
• Combine strategically - SEO + Data Enricher for authoritative content

• In-app tooltips - Hover over ℹ️ icons for quick explanations
• Documentation - Visit docs.floyi.com for detailed guides
• Support - Contact support@floyi.com for assistance