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, Images, Research & Quality tabs (resizable — drag the panel edge to adjust width)

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 five tabs: Settings, Optimizer, Images, Research, and Quality.

Click Edit next to the title and meta description to open the editor modal. If the brief generated alternate title options, the modal lists them — each labeled by its strategy with a one-line reason — so you can switch to a different option in one click. You can always type your own instead. Changes here update the article only; the brief keeps its own title.

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 and entities that matter most to your topic, prioritizing the most relevant ones
• Whether you use those terms naturally, rather than repeating them for the sake of it
• Content structure and heading hierarchy
• How easy your content is for AI to parse and cite
• Reading level appropriateness for your audience

The score reflects your actual writing, so it climbs as you add real content — an outline of headings alone stays low until you write the body. Your score and competitor scores use the same model, so the comparison in the coverage heatmap is always apples-to-apples.

Tip: Aim for a green score 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:

Use the Sort menu to choose how terms and entities are ordered:

• Relevance — highest relevance score first
• Source - Competitor — highest number of SERP competitor sources first
• Sources - AI — highest number of AI sources first
• A-Z — alphabetical order

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

For pages that already have a matched URL with Search Console data, the Optimizer pulls every GSC query driving traffic to your URL and lists them with the same coverage UI as the Terms list. This lets you optimize toward the queries Google already associates with your page, not just competitor-derived terms.

Each query shows:

When the tab appears:

• Your topic must have a matched URL (manual match or planned URL slug)
• The matched URL must have GSC query data imported

If those conditions aren’t met, the tab guides you to match a URL or import GSC data first.

Actions:

• Click query → Jump to first occurrence in editor
• Highlight icon → Toggle query highlighting in editor
• Highlight All / Clear → Highlight or clear all GSC queries in the editor at once, just like the Terms list
• Copy icon → Copy any query to your clipboard with one click

Tooltips:

Hover over column headers (Clicks, Impressions, Position) to see what each metric means and how it is calculated from your Search Console data.

Why this matters:

• Refresh and rank recovery — see which ranking queries you’ve drifted away from and patch them in the same editor
• Optimize toward real demand — every edit moves you toward queries that already send traffic
• No spreadsheet juggling — your GSC data lives next to the draft, not in a separate tool

Shows content structure issues:

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

• Identifies paragraphs that run too long to be easily scanned or cited
• Click any flagged paragraph to navigate to it
• Long paragraphs are harder for AI to cite — break them into shorter chunks or lists

• 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

The Schema tab generates JSON-LD structured data for your article and links its entities to the Knowledge Graph. Floyi auto-detects which schema types apply (Article, FAQ, HowTo, and more) and builds them from your content. Use the per-type toggle to include or exclude any schema type.

Beyond the standard Article fields, Floyi connects the entities in your article to their canonical Knowledge Graph identifiers and groups them by role:

Each entity includes its canonical name, description, image, a specific schema.org type (Person, Organization, Diet, and so on), sameAs links to Wikipedia and Wikidata, and identifier values for the Google Knowledge Graph MID and Wikidata QID. This is the same entity disambiguation that dedicated entity-SEO tools charge for — built in.

How it works:

• AI-assisted subject detection — Floyi reads your title, topic, and the entities in your draft to pick the primary subject, expanding abbreviations to the canonical entity (e.g., an “IBS Guide” resolves to Irritable bowel syndrome) even when the full name isn’t written out.
• Verified against your content — only entities that actually appear in your article body are included, so competitor-research terms that didn’t make it into your draft never leak into your schema.
• Regenerate — click Regenerate to re-run detection after major edits. The tab shows an “Article edited” hint when your draft has changed since the schema was last generated. Re-running the AI subject detection uses 1 credit.

Export:

Schema flows automatically into WordPress and GitHub publishing and HTML copy through the Include Schema option — no separate step.

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. Nano Banana 2 supports a wide range of ratios (1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, 21:9, and more); GPT Image 2 supports 1:1, 3:2, and 2:3.

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 GPT Image 2 for drafts (cheapest), switch to Nano Banana 2 when you need wider aspect ratios
• Featured Image inserts at the top of your article with its own H2 heading

The Research tab surfaces the research inputs behind every article, so writers can see exactly what AI agents used during brief and draft generation.

Internal link suggestions from your topical map, grouped into three relation types:

Each suggestion includes:

• Anchor text options — Multiple anchor text choices tagged by source (Map, AI, or custom)
• Click to select — Choose the anchor text you want, then place it in your article
• Real-time tracking — Links already placed in the editor show a green checkmark. Remove a link and the checkmark updates instantly.

A list of the fan-out queries the Researcher Agent used during draft generation. These show the exact searches the AI performed to gather information for your article, giving full transparency into the research process.

The top-ranking competitor URLs that were selected and analyzed during brief and draft creation. These are the same sources the AI used to inform content structure, entity coverage, and topic depth.

1. Open the Research tab in the right panel
2. Review Internal Link Suggestions — click any suggestion to expand anchor text options
3. Select an anchor text, then place the link in your article using the editor’s link tool
4. Watch the green checkmarks update as you place links
5. Review Researcher Agent Queries to understand what the AI searched for
6. Check Top SERP Competitors to see which pages informed your brief and draft

The Quality tab scores your draft using the quality signals Google’s patents describe. An AI judge reads your full draft and returns an overall score with per-dimension breakdowns, reasoning, and evidence quotes you can click to jump to the exact section in the editor.

The overall score (0-100) maps to the four-bucket scale Google’s patents describe:

The overall number is a weighted blend of the five dimensions below. When a dimension can’t be scored for your article, the remaining weights rebalance, so a missing signal never counts against you.

• Click any dimension to expand its reasoning and supporting evidence
• Click an evidence quote to jump to that section in the editor
• Use Expand all / Collapse all to open or close every dimension at once
• Hover the info icons to see the Google research behind each dimension

If your article was generated from a brief, the brief research already identified net-new angles the current top results miss. The Information Gain dimension checks which of those angles actually made it into your draft and lists them as evidence, so you can see exactly what your page adds that competitors don’t.

Click Re-analyze to score your draft again after making changes:

• Scores the latest saved version of your draft (auto-save keeps this current)
• Costs 10 credits per run
• Takes about a minute, and the tab updates automatically when the new scorecard is ready
• One analysis runs at a time per article

New drafts are scored automatically when generation finishes, so every article starts with a baseline scorecard at no extra cost.

The two tabs answer different questions. The Optimizer measures coverage: terms, entities, and structure compared to competitors, updating as you type. The Quality tab is a judge: it reads the finished page the way Google’s quality systems do and tells you how it holds up as a whole. Use the Optimizer while writing, then run Quality before you ship.

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 a moment after you stop typing. You’ll see:

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

Click Save or press Cmd + S to save immediately. If a save is already running, your click queues another save right after it.

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 - Work the recommended terms into your writing, starting with the highest-relevance ones near the top of the list
4. Check issues - Fix heading and chunkability issues
5. Run specialists - Enhance with SEO, data, or conversion focus
6. Final review - Aim for a green optimization score
7. Check Quality - Re-analyze in the Quality tab and aim for Good or Excellent before publishing

• 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 — the most relevant terms sit near the top of the list and 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