The AI will generate appropriate content for each placeholder based on your article brief.

Add internal links automatically

When enabled, the agent automatically adds internal links to your existing content, products, and collections. Default: enabled

Brand voice guidelines

Information about your brand, values, and messaging guidelines to ensure consistent brand voice.

Example: "Eco-friendly company focused on sustainability. Emphasize natural ingredients and environmental responsibility. Speak directly to environmentally conscious consumers."

Default word count

Default target word count for articles. Default: 1200 words

Range: 300-5000 words

Generate images automatically

Enable AI-powered image generation for articles. Default: disabled

Note: Images cost an additional 10 credits per image

Credit costs

Blog article generation uses a credit-based system:

• Base article: 8 credits
• Each image: +10 credits

Examples

• Article only: 8 credits
• Article + 2 images: 28 credits (8 + 20)
• Article + 5 images: 58 credits (8 + 50)

How to use

Basic article generation

1. Go to your Blog Writer agent
2. Enter your article details:

- Article title - Content brief (what the article should cover) - Primary keyword - Secondary keywords (optional) - Target word count

1. Select content format (blog post, guide, listicle, etc.)
2. Choose search intent:

- Informational: Educational content - Commercial: Content with product recommendations

1. Click Generate

Using custom templates

To use a custom template:

1. In agent settings, add your template to the "Content template" field
2. Use [placeholders] for sections you want AI to fill
3. Generate your article as normal
4. The AI will follow your template structure and fill in the placeholders

Generating articles with images

To include AI-generated images:

- Hero image (16:9) for article header - Section images (1:1) for main content sections

Commercial content with products

For articles that feature products:

1. Set search intent to "commercial"
2. Either:

- Preselect specific products to feature, OR - Preselect collections to pull products from, OR - Let AI automatically select relevant products

1. The AI will naturally incorporate product mentions in the content

Output formats

Every article is generated in two formats:

HTML format

• Semantic HTML5 markup
• Proper heading hierarchy (h1, h2, h3)
• Optimized for web publication
• Ready to copy-paste into your CMS

Markdown format

• Full Markdown syntax
• YAML frontmatter with metadata
• Perfect for static site generators
• Compatible with Jekyll, Hugo, Gatsby, etc.

Example Markdown output:

--- title: "Your Article Title" keyword: "primary keyword" date: 2025-12-02 ---

Your Article Title

Introduction paragraph...

Main Section

Content here...

Best practices

Writing effective content briefs

Your content brief should include:

• Target audience and their needs
• Key points to cover
• Specific requirements or constraints
• Desired outcome for the reader
• Any unique angle or perspective

Example: "Write a comprehensive guide for beginners about creating effective skincare routines using organic products. Focus on sensitive skin concerns, include step-by-step instructions, and explain the benefits of natural ingredients over synthetic ones."

Choosing the right content format

• Blog post: Standard articles, news, opinions
• Guide: Step-by-step tutorials, how-to content
• Listicle: Numbered lists, tips, collections
• Comparison: Product comparisons, vs. articles
• Review: Product or service reviews
• Case study: Success stories, before/after

Optimizing for SEO

The agent automatically:

• Integrates keywords naturally (1-2% density)
• Creates SEO-optimized meta descriptions
• Structures content with proper headings
• Analyzes readability
• Suggests internal linking opportunities

You can improve SEO by:

• Using specific, relevant keywords
• Writing compelling titles (under 60 characters)
• Including 3-5 secondary keywords
• Enabling internal linking
• Targeting appropriate word counts (1200-2000 words for competitive keywords)

Template tips

When creating templates:

• Use clear, descriptive placeholder names
• Keep structure logical and easy to follow
• Don't over-specify - let AI add details
• Include 5-10 placeholders for best results
• Test with different article topics

Image generation tips

• Specify article context in your title and brief
• Use clear section headings for better section images
• Start with 2-3 images to control costs
• Hero images work best with descriptive titles

Troubleshooting

Article doesn't match my expectations

• Provide a more detailed content brief
• Use a custom template to control structure
• Adjust tone of voice settings
• Include brand voice guidelines

Keywords aren't integrated well

• Check keyword relevance to topic
• Use more natural, conversational keywords
• Reduce number of secondary keywords
• Review keyword density in analysis

Images don't fit the content

• Make article title more descriptive
• Use clear section headings
• Provide more context in content brief
• Try generating fewer, more targeted images

Template placeholders not filled correctly

• Use descriptive placeholder names
• Keep placeholders focused on single topics
• Avoid overly complex placeholder requirements
• Test template with simple content first

API usage

Generate articles programmatically via API:

POST /api/blog-writer/write-article

{ "articleTitle": "Complete guide to organic skincare", "contentBrief": "Write a comprehensive guide...", "primaryKeyword": "organic skincare", "secondaryKeywords": ["natural skincare", "sensitive skin"], "targetWordCount": 1500, "contentFormat": "guide", "searchIntent": "informational", "generateImages": true, "imageCount": 3 }

Response includes: