User manual

User Manual: How to Use blogworkflow.ai

A practical guide to the 8-step SEO article workflow, including what every field means, example answers, and how each input changes generated output.

Product logic background

blogworkflow.ai is a full web app for structured SEO article generation, not a simple shell. It keeps topic setup, brand context, SEO research, evidence, outline, drafting, QA, and visuals connected in one production workflow.

The product reduces blank-prompt friction by turning business context into structured inputs before generation starts. Users can fill only the core fields first, then add optional detail when the article needs more precision.

Fast-start path

The fastest practical path is not to complete every field. Start with enough context to generate a coherent article, then use the first output to decide which optional settings deserve more detail.

  1. Fill Step 1 with a title, focus area, and target pain point.
  2. Add a brand name and target audience in Step 2.
  3. Keep the default draft lane unless the article needs higher-stakes polish.
  4. Set target word count, then generate. Optional sections can be refined later.

Navigating the software

Use the workflow library to open a saved workflow, the workflow builder to select one of the fixed 8 steps, and the step editor to change prompts, fields, and output rules. The product is designed so users can move left to right without designing a workflow from scratch.

  • Open or duplicate a workflow from the library before editing production settings.
  • Select a step in the workflow builder; the right-side editor changes to that step.
  • Use Save Step Settings for step-level changes, then use the main Save action when the workflow should be preserved.

Recommended generation routine

For normal production, do not try to fill every field on the first pass. Build a minimum viable brief, generate once, then use the result to decide which optional fields need refinement.

  • First pass: Step 1 topic, Step 2 brand/audience, Step 6 draft lane and word count.
  • Second pass: add SEO research, proof, outline, and QA rules when the article needs ranking precision.
  • Final pass: review generated output, SEO pack, link warnings, and visual recommendations before publishing.

Saving, reviewing, and handoff

Treat generated output as a production artifact, not a chat response. The workflow stores context, settings, and outputs so a team can inspect what drove the draft.

  • Save before generating if you changed important context or prompt rules.
  • Use warnings as review signals. A warning about missing links or sources does not automatically mean generation failed.
  • For team handoff, keep fields specific enough that another editor can understand why the article was generated that way.
Step 1

Topic & Query

Turn a blank prompt into a usable content brief: what the article is about, who it helps, what problem it solves, and what action it should support.

Use this first. These inputs drive the main article direction more than any later refinement field.

How to operate this step

  • Treat this step as the editorial brief. A specific title, focus area, and reader pain point usually matter more than adding many keywords.
  • If the article is a revision, use uploaded-article fields to preserve source material instead of pasting rewrite instructions into unrelated fields.
  • Use angle and CTA only when the default direction is too generic or the article has a clear commercial destination.

Optional logic

Optional

Uploaded article fields, keywords, angle, CTA, custom CTA, and enhancement toggles are optional. They improve intent precision and conversion fit, but a clean topic brief can still generate a usable article.

Quality standard

A strong Step 1 should make the reader, topic, pain point, and desired action obvious to an editor who has not seen the business before.

Fields, examples, and output impact

Use the field notes below to decide whether an input is part of the minimum brief or a refinement layer for precision, source quality, QA, or publish readiness.

Start mode

Logic
Choose whether the workflow creates a fresh article from a brief or revises an uploaded draft.
Example answer
Create from brief
Effect on output
Controls whether the model builds from your inputs or treats pasted content as source material to revise.

Title

Logic
Give the article a clear working title. It can be changed by SEO research later, but it sets the first direction.
Example answer
How AI SEO Workflows Help Small Teams Publish Better Blog Posts
Effect on output
Shapes the H1, opening angle, metadata fallback, and visual research topic.

Focus area

Logic
Select the business area the article supports, or write a custom focus area.
Example answer
Content operations
Effect on output
Helps the draft choose relevant examples, benefits, and conversion framing.

Target pain point

Logic
Describe the reader problem the article should solve.
Example answer
The team can generate drafts, but every article still needs too much manual cleanup before publishing.
Effect on output
Anchors the intro, problem framing, direct answer, and conclusion.

Uploaded article fields

Optional
Logic
When revising an article, provide source language, translation preference, revision notes, source text, file name, and format.
Example answer
Keep the original case study, remove filler, translate from Chinese to English, and rebuild weak sections.
Effect on output
Changes the workflow from new drafting to revision while preserving the source article's useful material.

Keywords

Optional
Logic
Add known target terms if you already have them. AI research can expand or refine them later.
Example answer
AI SEO workflow, content production system, blog workflow software
Effect on output
Improves keyword coverage, headings, and SEO tracking output.

Angle

Optional
Logic
Define the editorial angle when the title alone is too broad.
Example answer
Focus on repeatable process quality, not generic faster AI writing.
Effect on output
Pushes the article away from generic summaries and toward a sharper point of view.

Call to action

Optional
Logic
Choose what the reader should do after the article.
Example answer
Start a workflow session
Effect on output
Shapes the closing section and internal conversion language.

Custom call to action

Optional
Logic
Use this when preset CTAs do not match your offer.
Example answer
Open the editor and generate your first structured article brief.
Effect on output
Makes the CTA more specific to your product or campaign.

Enhancement toggles

Optional
Logic
Choose whether to encourage case studies, statistics, or comparison sections.
Example answer
Include statistics and comparison
Effect on output
Adds stronger proof and structure requests to the generation prompt.
Step 2

Brand & Language

Give the workflow enough company, audience, tone, and linking context to keep the article on-brand.

Use basic brand name and audience for every article. Fill optional language and authority details when output needs tighter brand control.

How to operate this step

  • Use brand name and target audience as the minimum viable brand context.
  • Use Language system when tone, locale, market, formality, or readability must stay consistent across many articles.
  • Use Authority when author metadata, reviewer context, and allowed internal links matter for trust, compliance, or SEO structure.

Optional logic

Optional

Language system is safe to skip because defaults cover locale, market, tone, tone ratio, and readability. Authority is safe to skip because author falls back to Editorial team, and empty internal links tell the writer not to invent internal URLs. Empty internal links may still create a QA warning later, but that warning does not block generation.

Quality standard

A strong Step 2 should prevent the article from sounding like a generic AI post by making audience, positioning, voice, and link permissions clear.

Fields, examples, and output impact

Use the field notes below to decide whether an input is part of the minimum brief or a refinement layer for precision, source quality, QA, or publish readiness.

Brand name

Logic
Name the company, product, or publisher the article represents.
Example answer
blogworkflow.ai
Effect on output
Appears in brand framing, examples, author context, and image planning.

Tagline

Optional
Logic
Summarize the product promise in one short phrase.
Example answer
Structured AI content workflows for publish-ready SEO articles.
Effect on output
Helps the draft describe the offer consistently without inventing positioning.

Website

Optional
Logic
Provide the domain used for canonical URLs and internal-link matching.
Example answer
https://blogworkflow.ai
Effect on output
Improves canonical URL fallback, internal link classification, and SEO pack accuracy.

Services

Optional
Logic
List what the business offers.
Example answer
SEO article workflow, AI draft generation, visual research, publishing QA
Effect on output
Gives the draft accurate product references and service examples.

Target audience

Logic
Define the reader or buyer group.
Example answer
Small marketing teams and founders who publish SEO articles but do not have a full content department.
Effect on output
Controls vocabulary, examples, assumed knowledge, pain points, and CTA fit.

Language system

Optional
Logic
Set locale, market, tone, tone ratio, signature phrases, words to avoid, formality, and readability.
Example answer
Locale: en-US; market: United States; tone: educational and authoritative; readability: general.
Effect on output
Refines voice and regional assumptions. If empty, defaults are used.

Author name

Optional
Logic
Attach a named author or editorial identity.
Example answer
blogworkflow.ai Editorial Team
Effect on output
Feeds author metadata and trust signals. If empty, the system uses Editorial team.

Reviewer name

Optional
Logic
Add a reviewer when the article needs extra authority.
Example answer
SEO Operations Lead
Effect on output
Adds review context to the prompt and metadata where applicable.

Internal links

Optional
Logic
List URLs the article is allowed to link to, with anchor text and descriptions.
Example answer
https://blogworkflow.ai/pricing | pricing plans | Compare included draft, premium text, and image usage.
Effect on output
Allows the model to place real internal links. If empty, it is told not to invent internal URLs.
Step 3

SEO Research

Translate the article idea into search intent, keyword priorities, SERP gaps, and content angles.

Use this when ranking quality matters, when the topic is competitive, or when you want AI to expand beyond your first keyword idea.

How to operate this step

  • Use the AI SEO analysis as the main research entry point, then manually override only the fields you trust more than the analysis.
  • Use competitor URLs and gaps to define differentiation, not to copy the current SERP structure.
  • People Also Ask and related keywords are best used to improve section coverage and answer-engine visibility.

Optional logic

Optional

Search volume, difficulty, related keywords, competitor URLs, People Also Ask, suggested angles, and competitor gaps are optional enrichment. Leave them empty when you do not have reliable data.

Quality standard

A strong Step 3 should clarify search intent, primary keyword focus, missing SERP angles, and the questions the article must answer.

Fields, examples, and output impact

Use the field notes below to decide whether an input is part of the minimum brief or a refinement layer for precision, source quality, QA, or publish readiness.

AI SEO analysis

Logic
Run the research lane to summarize query intent, keyword opportunities, People Also Ask, and gaps.
Example answer
Analyze 'AI SEO content workflow software' for commercial investigation intent.
Effect on output
Improves keyword targeting, suggested headings, meta suggestions, and article angle.

Primary keyword

Logic
Set or override the main keyword the article should rank around.
Example answer
AI SEO content workflow software
Effect on output
Guides H1/H2 wording, SEO pack primary keyword, and body keyword usage.

Search volume

Optional
Logic
Add an estimated search volume if available.
Example answer
5400
Effect on output
Helps prioritize opportunity, but does not block generation when empty.

Difficulty

Optional
Logic
Add a 0-100 keyword difficulty estimate.
Example answer
35
Effect on output
Helps frame how specific or differentiated the article should be.

Related keywords

Optional
Logic
Add secondary terms and semantic variations.
Example answer
structured SEO workflow, AI blog workflow, publish-ready content system
Effect on output
Improves topical breadth and secondary keyword coverage.

Competitor URLs

Optional
Logic
Add pages the article should learn from or outperform.
Example answer
https://example.com/ai-content-workflow-guide
Effect on output
Helps the workflow identify gaps and avoid shallow duplicate framing.

People Also Ask

Optional
Logic
List common search questions readers may ask.
Example answer
How do AI SEO workflows improve content quality?
Effect on output
Encourages answer sections, FAQ material, and answer-engine-friendly copy.

Suggested angles

Optional
Logic
Capture possible editorial angles from research.
Example answer
Compare one-shot prompting with structured workflow systems.
Effect on output
Gives the draft stronger positioning and less generic framing.

Competitor gaps

Optional
Logic
Record what existing ranking pages miss.
Example answer
Most pages explain AI writing tools but do not show how QA, links, and visuals stay connected.
Effect on output
Helps the article include differentiating sections and stronger conclusions.
Step 4

Evidence & Entities

Give the article proof, sources, first-party observations, and named entities so it does not read like generic AI output.

Use this for posts that need credibility, citations, subject-matter nuance, or original product knowledge.

How to operate this step

  • Use first-party insights to add information competitors cannot easily reproduce.
  • Use source URLs for claims that need external support, especially technical, legal, pricing, medical, or time-sensitive claims.
  • Use entity inputs to make the article more machine-readable for search systems and AI answer engines.

Optional logic

Optional

Entity map is safe to skip. Expert quotes, key entities, and proprietary assets are only added to the prompt when values exist. Empty values are skipped instead of causing backend errors.

Quality standard

A strong Step 4 should separate what the company knows first-hand from what needs external citation, so the draft has both originality and support.

Fields, examples, and output impact

Use the field notes below to decide whether an input is part of the minimum brief or a refinement layer for precision, source quality, QA, or publish readiness.

First-party insights

Logic
Add lessons, operator knowledge, customer patterns, or observations from your own experience.
Example answer
Teams usually fail not because the first draft is bad, but because research, brief, links, and QA live in separate places.
Effect on output
Makes the article more original and less like a generic SERP summary.

Statistics / proof points

Optional
Logic
Add concrete numbers the draft can use.
Example answer
Target output: 1,200-1,600 words; benchmark checklist flags missing internal links.
Effect on output
Adds specificity and proof, especially in introductions and comparison sections.

Source URLs

Logic
Provide official reports, documentation, research pages, or trusted sources.
Example answer
https://developers.google.com/search/docs/fundamentals/creating-helpful-content
Effect on output
Lets the article cite or reference real sources instead of unsupported claims.

Expert quotes / notes

Optional
Logic
Add direct quotes, paraphrased expert notes, or stakeholder comments.
Example answer
The fastest draft is not useful if the editor still has to rebuild the structure manually.
Effect on output
Adds authority, nuance, and quotable material when provided.

Key entities

Optional
Logic
List important brands, tools, concepts, locations, regulations, or platforms.
Example answer
Google Search, schema markup, internal links, AI Overviews, GA4
Effect on output
Improves entity coverage and helps search engines understand the topic context.

Proprietary assets

Optional
Logic
Add internal frameworks, checklists, datasets, or reusable IP.
Example answer
8-step article workflow, SEO tracking pack, benchmark checklist
Effect on output
Gives the article unique assets that competitors cannot easily copy.
Step 5

Critical Outline

Shape the argument and article structure before drafting so the model does not improvise away important sections.

Use this when the article needs a specific thesis, answer block, comparison, or must-cover outline.

How to operate this step

  • Use thesis and direct answer to control the article's argument before drafting starts.
  • Use required sections when the article must follow a specific editorial structure or sales narrative.
  • Use comparison tables and takeaways when the reader is comparing options or needs a decision framework.

Optional logic

Optional

Structure is safe to skip. Required sections, comparison table ideas, and key takeaways are skipped when empty, so the model can still draft from topic, brand, SEO, and proof context.

Quality standard

A strong Step 5 should make the article's point of view, direct answer, and section logic clear enough that the draft does not drift into a generic listicle.

Fields, examples, and output impact

Use the field notes below to decide whether an input is part of the minimum brief or a refinement layer for precision, source quality, QA, or publish readiness.

Thesis

Logic
Write the main argument of the article.
Example answer
AI SEO tools become more useful when they are organized into a repeatable workflow instead of used as isolated prompts.
Effect on output
Controls the article's point of view and conclusion.

Direct answer

Logic
Write the short answer readers should get near the top.
Example answer
An AI SEO workflow helps teams turn a topic into research, proof, structure, draft, QA, and visuals inside one repeatable process.
Effect on output
Improves answer blocks, summaries, and AI visibility readiness.

Contrarian / critical insight

Optional
Logic
Define what common content misses or gets wrong.
Example answer
The main advantage is not speed; it is reducing late-stage editorial repair.
Effect on output
Adds originality and prevents generic listicle output.

Required sections

Optional
Logic
List section headings or topics that must appear.
Example answer
Why one-shot prompts fail; The 8-step workflow; Optional fields; QA and visual packaging
Effect on output
Creates stronger structure and makes sure critical sections are included.

Comparison table idea

Optional
Logic
Define a table the article should include.
Example answer
One-shot prompting vs structured SEO workflow
Effect on output
Encourages clear comparison content instead of vague prose.

Key takeaways

Optional
Logic
List the conclusions the reader should remember.
Example answer
Core fields are enough to start; optional fields improve precision; QA warnings are not generation blockers.
Effect on output
Shapes summary blocks, conclusion, and final lessons.
Step 6

Draft Generation

Choose the drafting lane, target length, metadata behavior, output format, and any hard generation overrides.

Use this before generating. Most users only need draft lane and target word count at first.

How to operate this step

  • Use draft lane to control the cost-quality tradeoff before generation.
  • Use target word count as a practical editorial target, not a guarantee that every generated article will land on the exact number.
  • Use publish output settings when the final deliverable needs metadata, schema hints, benchmark checks, or export-ready formatting.

Optional logic

Optional

Prompt override is safe to skip. An empty custom system prompt adds no extra instruction. Use it only for hard constraints that cannot be expressed through the structured fields.

Quality standard

A strong Step 6 should define the article length, model lane, publish packaging, and any exceptional drafting rules before the Generate action starts.

Fields, examples, and output impact

Use the field notes below to decide whether an input is part of the minimum brief or a refinement layer for precision, source quality, QA, or publish readiness.

Draft lane

Logic
Choose the model/credit lane used for main article generation.
Example answer
Standard draft lane for routine articles; premium text for higher-stakes content.
Effect on output
Affects model quality, cost bucket, and writing depth.

Target word count

Logic
Set the intended article length.
Example answer
1400
Effect on output
The server tries to keep the draft near this target and uses it in benchmark checks.

Meta title max length

Optional
Logic
Set the target character limit for SEO titles.
Example answer
65
Effect on output
Keeps title metadata short enough for search result display.

Meta description max length

Optional
Logic
Set the target character limit for meta descriptions.
Example answer
155
Effect on output
Guides snippet and SEO pack description length.

Image, link, summary, schema, and naturalness toggles

Optional
Logic
Control whether the article includes image suggestions, links, summaries, schema notes, and an editorial naturalness pass.
Example answer
Include summary block, internal links, external links, schema notes, and naturalness pass.
Effect on output
Changes publish-readiness, QA expectations, and final polish.

Export format

Optional
Logic
Choose the output format.
Example answer
HTML
Effect on output
Affects whether metadata, canonical hints, and structured data can be embedded directly.

Auto-save

Optional
Logic
Choose whether generated output is stored in the database.
Example answer
On
Effect on output
Keeps generated sessions available in the workspace history.

SEO tracking pack and benchmark checklist

Optional
Logic
Choose whether to include publishing metadata and QA metrics.
Example answer
Include SEO tracking pack and benchmark checklist.
Effect on output
Adds review data such as title length, word count, links, schema, and keyword coverage.

Custom system prompt

Optional
Logic
Add a hard instruction only when normal fields are not enough.
Example answer
Always include a section that explains the operational tradeoff for non-specialist users.
Effect on output
Appends extra drafting instructions. If empty, nothing is added.
Step 8

Visual / Image Generation

Plan search-based visuals or generate image prompts/images connected to the article.

Use this when the final output needs visual direction, image placements, or generated images.

How to operate this step

  • Use Search Research mode when an editor should find real screenshots, diagrams, or reference assets first.
  • Use direct image generation only when generated visuals are acceptable for the article's use case.
  • Use style, ratio, and image count to keep visual output aligned with the article placement, not just the aesthetic preference.

Optional logic

Optional

Asset research is safe to skip. Empty search keywords, source types, and preferred sources are treated as "none"; visual research still uses article title and content as fallback context.

Quality standard

A strong Step 8 should specify whether the article needs real-source visual research, AI-generated concepts, or simply enough visual direction for a designer/editor.

Fields, examples, and output impact

Use the field notes below to decide whether an input is part of the minimum brief or a refinement layer for precision, source quality, QA, or publish readiness.

Visual mode

Logic
Choose search-first visual research or direct AI image generation.
Example answer
Search-first
Effect on output
Controls whether the output is a research pack or generated image flow.

Image lane

Logic
Choose the visual quality/credit lane.
Example answer
Standard visuals for routine support; premium visuals for hero assets.
Effect on output
Affects image quality and which visual credit bucket is used.

Credit usage

Logic
Shows which visual allowance will be consumed.
Example answer
Standard visuals left: 10; Premium visuals left: 2
Effect on output
Helps users avoid starting visual work without enough included usage.

Search keywords

Optional
Logic
List visual search prompts for stock, screenshots, references, or inspiration.
Example answer
SEO workflow dashboard, content brief checklist, editorial QA process
Effect on output
Improves visual research specificity. If empty, visual research still uses title and article content.

Source types

Optional
Logic
List asset formats to consider.
Example answer
Workflow chart, product screenshot, comparison diagram
Effect on output
Guides asset type recommendations in the visual research pack.

Preferred sources

Optional
Logic
List websites or source categories for asset discovery.
Example answer
Official docs, product screenshots, first-party diagrams
Effect on output
Guides where editors should look for assets.

Image style

Logic
Choose the desired visual treatment.
Example answer
Infographic
Effect on output
Shapes visual prompts and research recommendations.

Aspect ratio

Logic
Choose landscape, portrait, or square.
Example answer
Landscape
Effect on output
Guides generated image dimensions and placement suitability.

Number of images

Logic
Set how many visual placements or images are needed.
Example answer
3
Effect on output
Controls the size of the visual research pack or image generation batch.

Custom prompt template

Optional
Logic
Override image prompt wording when direct generation needs tighter creative control.
Example answer
Create a clean SaaS workflow diagram for {{description}} using {{brand}} visual language.
Effect on output
Changes generated image prompt structure when AIGC mode is used.