Content Writer - AI Puffer

Overview

Content Writer creates WordPress content from topics, CSV files, RSS feeds, web pages, and Google Sheets. It can also update existing posts, image metadata, and WooCommerce product copy. To start using Content Writer, open WordPress Admin and go to AI Puffer > Content Writer.

Create Content

Generate posts from topics, CSV, RSS, URLs, and Sheets.

Optimize

Rewrite posts, update image metadata, and edit products.

Templates

Save reusable writer settings.

AI

Choose the provider, model, and generation settings.

Prompts

Customize instructions for each generated output.

SEO

Generate metadata and improve SEO scores.

Publishing

Set post type, status, author, taxonomy, and schedule.

Images

Generate or search images for content.

Knowledge Base

Use vector data while generating content.

Logs

Review generated content activity.

Create Content

To create new content, first choose where the input comes from. You can type topics manually, upload a CSV, use RSS feed items, extract text from web pages, or read rows from Google Sheets. Manual Entry is for topics you type directly into Content Writer. Choose Single, Batch Editor, or Quick Paste, then use the right panel to select the model, edit prompts, set publishing options, add images, and enable SEO.

Set up at least one AI provider before using Content Writer. If the model list is empty, configure and sync a provider in AI Providers.

Single Entry

Single Entry is for one content item.

Select Manual Entry.
Select Single.
Enter the topic.
Add keywords if needed.
Choose the provider, model, and content length.
In the right-side General card, click Customize next to Prompts if you want to edit the instructions.
Set the post type, status, author, categories, table of contents, and URL option.
Click Generate.
Review the output.
Save it as a WordPress post when ready.

Batch Editor

Batch Editor is a row-based queue. Each row creates one content item. The main row fields are Topic and Keywords. Click the row settings icon to set Category, Author, Post Type, and Schedule for that row.

Select Manual Entry.
Select Batch Editor.
Add one topic per row.
Add keywords or row settings where needed.
Choose the shared model, prompts, publishing, image, and SEO settings.
If row schedules should be used, set publishing to Publish and select Use Dates from Input.
Click Generate or Create Task.

Quick Paste

Quick Paste is for adding many rows at once. Each line becomes one Batch Editor row. Only the topic is required. Optional fields can be added with a pipe character. Quick Paste format:

Topic | Keywords | Category ID | Author Login | Post Type | YYYY-MM-DD HH:MM

Example:

How to clean leather boots | leather care, boots | 12 | editor | post | 2026-05-01 09:00

You can also enter only a topic:

How to clean leather boots

To use Quick Paste:

Select Manual Entry.
Select Quick Paste.
Paste one topic per line.
Switch to Batch Editor if you want to review or edit the rows.
Choose the shared model, prompts, publishing, image, and SEO settings.
If lines include schedule dates, set publishing to Publish and select Use Dates from Input.
Click Generate or Create Task.

CSV

CSV import reads every non-empty row and converts it into a generation task. Download sample CSV

Select Import CSV.
Upload a .csv file.
Confirm the number of tasks found.
Set model, prompts, publishing, and other options.
Click Generate or Create Task.

CSV columns are read in this order:

Column	Field	Required
1	Topic	Yes
2	Keywords	No
3	Category ID	No
4	Author Login	No
5	Post Type	No
6	Schedule	No

Do not add a header row unless you want the header row to be treated as a topic.

RSS Feed

Use RSS Feed to generate content from feed items.

Select RSS Feed.
Add one feed URL per line.
Add Include keywords if only matching titles should be used.
Add Exclude keywords if matching titles should be skipped.
Click Fetch Feeds to preview available items.
Click Generate or Create Task.

Our plugin checks up to 15 items per feed. Automated RSS tasks keep a history of processed feed items so the same item is not queued again.

Web Page

Use Web Page to generate content from a list of URLs.

Select Web Page.
Add one URL per line.
Click Test First URL to preview extracted text.
Set prompts and publishing options.
Click Generate or Create Task.

When using Web Page mode, prompts can use:

Placeholder	Value
`{url_content}`	Extracted page text.
`{source_url}`	Source URL.

Some pages block extraction or return very little readable text. Use Test First URL before creating a large task.

Google Sheets

Use Google Sheets when your content inputs are managed in a spreadsheet. Open the sample Google Sheet, make a copy, and keep the same column order.

AI Puffer reads columns A:G.

Column	Field	Notes
A	Topic	Required.
B	Keywords	Optional.
C	Category ID	Optional.
D	Author Login	Optional.
E	Post Type	Optional.
F	Schedule Date	Optional. Use `YYYY-MM-DD HH:MM`.
G	Status	Leave empty for rows that should be processed.

Column G controls whether a row is processed. If column G has any value, AI Puffer skips that row.

Rows are processed only when column A has a topic and column G is empty. After a post is created, AI Puffer writes Processed on ... to column G so the row is not used again. If you use a header row, put a value in column G for that row, such as Status, so it is skipped. AI Puffer uses a Google Cloud to read the sheet and update the status column. Create the service account:

Open Google Cloud Console.
Create a new project, or select an existing project.

Open the project dashboard.
Go to APIs & Services.
Click Enable APIs and Services.

Search for Google Sheets API.
Select Google Sheets API.
Click Enable.

Go to Credentials.
Click Create credentials.
Select Service account.
Enter a service account name and click Done.

Open the service account.
Go to Keys.
Click Add key.
Select Create new key.
Select JSON and click Create.

Keep the service account JSON file private. Anyone with this file can use the permissions granted to that service account.

Google downloads a .json file. You will upload it in AI Puffer.

The service account needs Editor access because AI Puffer writes the processed status back to column G. Share the sheet:

Open your Google Sheet.
Click Share.
Copy the service account email from Google Cloud or from the JSON file field named client_email.
Share the sheet with that email as Editor.

Share the sheet with the service account

Connect it in Content Writer:

Select Google Sheets in Content Writer.
Paste the Google Sheet ID.
Upload the service account JSON file.
Wait for the connection check to pass.
Set the model, prompts, publishing, image, and SEO options.
Click Generate or Create Task.

The Google Sheet ID is the value between /d/ and /edit in the sheet URL.

https://docs.google.com/spreadsheets/d/GOOGLE_SHEET_ID/edit

Optimize

Use optimize modes when you want to update content that already exists in WordPress. To update content from WordPress post lists or editor screens, use WordPress Utilities.

Rewrite Posts and Pages

Use Rewrite Content to update selected posts or pages.

Rewrite Content updates selected WordPress content directly. Test with one item first when changing prompts or enabled fields.

Select Rewrite Content.
Filter by type, status, or search term.
Select one or more rows.
In the right-side General card, click Customize next to Prompts and choose the fields to update.
Click Update.

Available update targets:

Target	Result
Title	Updates the post title.
Content	Updates the post content.
Meta Description	Updates the search meta description.
Focus Keyword	Updates the focus keyword when supported.
Excerpt	Updates the excerpt.
Tags	Updates tags.
URL	Updates the slug when Optimize URL is enabled.

For existing content prompts, include at least one source placeholder:

{original_title}
{original_content}
{original_excerpt}
{original_meta_description}
{original_focus_keyword}
{original_tags}
{categories}

Available update fields depend on the selected content type and active plugins.

Image Metadata

Use Image Metadata to update media library attachment data.

Image Metadata writes to media attachment fields directly. Enable only the fields you want to replace.

Select Image Metadata.
Filter images by media type, unattached items, owner, or search term.
Select the image.
In the right-side General card, click Customize next to Prompts.
Enable the metadata fields you want to update.
Click Update.

Fields:

Field	WordPress attachment field
Image title	Attachment title.
Alt text	Alternate text.
Caption	Attachment excerpt.
Description	Attachment content.

Image metadata prompts can use:

{file_name}
{original_title}
{original_alt}
{original_caption}
{original_description}
{image_context}

You can update one selected image or use bulk updates when available in your installed plugin version.

WooCommerce Products

Optimize Products appears when WooCommerce is active.

Optimize Products requires AI Puffer Pro. If WooCommerce is not active, this mode is not shown. On the free version, product updates are blocked and the action button opens the upgrade flow.

Use it to update existing WooCommerce product titles, descriptions, short descriptions, SEO data, tags, and URLs. To update products:

Open AI Puffer > Content Writer.
Select Optimize Products under Optimize.
Use Status and Search to find products.
Select one or more products.
In the right-side General card, click Customize next to Prompts.
Enable the product fields you want to update.
Edit the prompts if needed.
Choose the AI provider, model, and length.
In the right-side Advanced card, set Context if product copy should use stored business or product information.
Click Update.

Fields:

Field	What it updates
Product Title	Product name.
Product Description	Main product description.
Short Description	Product short description.
Meta Description	SEO meta description in supported SEO plugins.
Focus Keyword	SEO focus keyword in supported SEO plugins.
Tags	WooCommerce product tags.
URL	Product slug when URL optimization is enabled.

Price, SKU, stock, dimensions, purchase note, categories, and attributes are available for prompts. AI Puffer uses them as source data; it does not change those WooCommerce product fields. Product prompts can use:

{original_title}
{original_content}
{original_excerpt}
{original_meta_description}
{original_focus_keyword}
{original_tags}
{categories}
{price}
{regular_price}
{sale_price}
{sku}
{stock_quantity}
{stock_status}
{weight}
{length}
{width}
{height}
{short_description}
{purchase_note}
{product_categories}
{attributes}

Settings

Templates

Templates save reusable Content Writer settings. Use them when you often write with the same model, prompts, publishing rules, image settings, or knowledge settings. The Template control is in the General panel on the right side of Content Writer. Use the template menu to load, create, edit, rename, delete, and reset templates. Starter templates and default templates cannot be renamed or deleted.

AI

Content Writer uses the AI providers configured in AI Puffer, including hosted providers, xAI, and local Ollama models. To set the model:

In the right panel, open AI.
Select the model.
Select the content Length.
Click the settings icon next to the model.
Adjust Temperature if you want more or less variation.
Set Reasoning only for models that support it. Keep it on None for faster generation.

Model settings include:

Setting	What it does
Model	Model used for generation.
Temperature	Controls response variation.
Reasoning	Sets reasoning effort for supported OpenAI and Ollama models.
Length	Sets the token budget used for the generated content.

Length values map to these :

Length	Token budget
Short	2000
Medium	4000
Long	6000

Prompts

Prompts are the instructions Content Writer sends to the selected model. Each output has its own prompt, so the title, article body, SEO fields, excerpt, and tags can follow different rules. To customize prompts:

In the right-side General card, click Customize next to Prompts.
Enable the outputs you want Content Writer to generate.
Click the edit icon next to an output.
Select Default or a saved prompt from the dropdown, or edit the prompt text directly.
Use the variables shown under the editor. Click a variable to copy it.
Click Apply changes if the button appears.
Generate one item and review the result before running a batch.

Output	What it updates
Title	WordPress post title.
Content	WordPress post content.
Meta Description	SEO meta description.
Focus Keyword	Focus keyword in supported SEO plugins.
Excerpt	WordPress excerpt.
Tags	Post tags or product tags.

Available variables change based on the selected source or optimize mode.

Workflow	Variables to use
Manual Entry, CSV, Google Sheets	Use `{topic}` in enabled prompts. Use `{keywords}` when keyword input should guide the result.
RSS Feed	Use `{description}` in the title and content prompts. Use `{source_url}` if the source URL should be included.
Web Page	Use `{url_content}` in the title and content prompts. Use `{source_url}` if the source URL should be included.
SEO, excerpt, tags	Use `{content_summary}` when the output should be based on the generated article.
Rewrite, image metadata, products	Use the variables shown under the prompt editor. They change for each optimize mode.

AI Puffer checks required variables before generation. If a required variable is missing, it stops and asks you to update the prompt.

SEO

Use SEO settings when the generated post should leave Content Writer with search metadata already filled in. AI Puffer can create a meta description, focus keyword, tags, and a cleaner WordPress URL slug. Pro users can also use Smart SEO to audit and improve the generated draft against the active SEO plugin. To use SEO output:

In the right-side General card, click Customize next to Prompts.
Enable Meta Description, Focus Keyword, or Tags.
Edit the prompt for each enabled output if the default instruction does not match your site.
In the right-side General card, click the settings icon next to Status to open Post settings.
Enable Optimize URL if you want AI Puffer to update the post .
Generate the content.
Review the SEO fields in the output panel before saving the post.

The focus keyword is generated first. Meta description, excerpt, and tag prompts can then use that keyword. If you enter keywords manually, the first keyword is used as the focus keyword.

Output	How it is saved
Meta description	Saved to the active SEO plugin. If no supported SEO plugin is active, AI Puffer saves it as fallback post meta.
Focus keyword	Saved to Yoast SEO, Rank Math, or All in One SEO.
Tags	Saved as WordPress tags for new posts. Existing-post and product update workflows use the matching tag taxonomy when available.
URL	Updates the WordPress post slug when Optimize URL is enabled.

Smart SEO

Smart SEO is a Pro feature.

It works in Content Writer Create mode.
It supports Single generation, Batch generation, Quick Paste, CSV, RSS, URL, and Google Sheets batches.
It automatically detects the active SEO plugin.
It checks the generated draft against that SEO profile.
It improves the draft before you save it.
For SEO revisions, Smart SEO may use a quality-focused model from the same AI provider selected for generation, never switches providers, and uses the selected deployment or local model for Azure and Ollama.
It tries to improve the generated draft up to 100/100.
It can run up to three SEO revisions.
If the draft cannot reach 100/100, AI Puffer keeps the best-scoring revision.
In Single mode, users can review the SEO score and switch between revisions before saving.
In batch modes, users see the SEO score and status in the batch monitor.
Free users can still generate meta descriptions, focus keywords, tags, excerpts, and optimized slugs.
Only Smart SEO score improvement is paid.

To use Smart SEO:

Open AI Puffer > Content Writer.
Choose a Create source such as Manual Entry, CSV, RSS, URL, or Google Sheets.
In the right-side General card, enable Smart SEO.
Generate the content.
Review the SEO score and generated post before saving.

Advanced users can open Smart SEO rules from the settings icon next to the Smart SEO toggle. This panel lets you choose a preset or enable and disable individual rules for the active SEO plugin profile.

Preset	Default	What it does
Strict score	No	Enables every listed rule to chase the highest possible SEO plugin score. Use it when matching the plugin score is more important than minimizing editorial constraints.
Balanced	Yes	Keeps the main SEO checks enabled, including Rank Math title-start, table of contents, rich media, and keyword density checks. It still skips optional title gimmicks such as numbers, power words, sentiment wording, and selected image-alt/headline pressure.
Content first	No	Keeps essential metadata and placement checks while reducing content-length, density, readability, media, and plugin-specific pressure. Use it when natural writing matters more than maximum plugin score.

After choosing a preset, you can still toggle individual rules. If the selected rules no longer match a preset, the panel shows the selection as custom. Depending on the active SEO plugin profile, Smart SEO can check:

Area	Examples
Focus keyword	Title, introduction, headings, meta description, slug, and duplicate-keyword usage.
Metadata	Meta description presence and length.
Content structure	Content length, heading balance, table of contents, paragraph length, and sentence length.
Links	Internal links, outbound links, and dofollow outbound links when the active SEO plugin scores them.
Media	Image presence and focus-keyword image alt text.
Readability	Transition words, repeated sentence openings, passive voice, and reading ease where supported.

The exact checks depend on the active SEO plugin profile. Some checks are shared across profiles, while others mirror plugin-specific scoring behavior.

Smart SEO rules

Check	Applies to	What Smart SEO checks
Focus keyword in title	Yoast SEO, Rank Math, All in One SEO	The SEO title should include the focus keyword. Yoast prefers the exact keyphrase at the beginning, while Rank Math and AIOSEO add their own title-position checks.
Focus keyword in URL slug	Yoast SEO, Rank Math, All in One SEO	The optimized slug should include the focus keyword when Optimize URL is enabled or a slug is available.
Paragraph length	Yoast SEO, Rank Math, All in One SEO	Long paragraphs should be split so the article is easier to scan.
Meta description exists	Yoast SEO, Rank Math, The SEO Framework	A meta description should be present. AIOSEO uses its own profile-specific meta description check.
Content length	Yoast SEO, Rank Math	Yoast uses the selected minimum word count. Rank Math uses its own scoring ladder and gives full content-length credit at `2500+` words.
Focus keyword in introduction	Yoast SEO, Rank Math	Yoast checks the first paragraph. Rank Math checks the first 10% of the content.
Focus keyword in meta description	Yoast SEO, Rank Math	The meta description should include the focus keyword.
Focus keyword in heading	Yoast SEO, Rank Math	Yoast checks H2/H3 balance. Rank Math accepts H2-H6 and needs at least one matching heading.
Internal link	Yoast SEO, Rank Math	The article should include a verified internal link. Rank Math requires a link to another published post or page.
External link	Yoast SEO, Rank Math	The article should include a safe outbound link when the profile scores outbound links.
Image alt keyphrase	Yoast SEO, Rank Math	At least one image alt text should contain the focus keyphrase or enough keyphrase words.
Previously used keyphrase	Yoast SEO, Rank Math	The focus keyphrase should not already be used by another post.
Keyword density	Yoast SEO, Rank Math	Exact focus-keyphrase usage should stay in the plugin’s target range without stuffing.

Yoast SEO rules

Check	What Smart SEO checks
SEO title width	Title should be in a strong display range, roughly 35-65 characters.
Focus keyphrase length	Focus keyphrase should usually be 1-4 words.
Meta description length	Strong range is 120-156 characters. Longer descriptions are reduced.
Focus keyphrase in first paragraph	The first introduction paragraph should include the focus keyphrase when natural.
Focus keyphrase in subheadings	Enough H2/H3 subheadings should include the keyphrase, but over-optimization is avoided.
Heading distribution	Longer articles should use H2/H3 headings to break up sections.
Image exists	The draft should include at least one image.
Single H1	The article body should not contain multiple H1 headings.
Competing links	Link anchor text should not be the exact focus keyphrase.
Consecutive sentence starts	Avoid three or more consecutive sentences starting with the same word.
Transition words	At least about 30% of eligible sentences should use transition words.
Sentence length	Long sentences over 20 words should stay within Yoast’s readability threshold.
Passive voice	Passive voice should generally stay at or below 10% of sentences.

Rank Math rules

Check	What Smart SEO checks
Content length	Full content-length credit is `2500+` words. Rank Math gives partial credit at lower ranges and fails very short content.
Focus keyword at title beginning	The SEO title should start with the exact focus keyword.
Number in title	The SEO title should include a relevant number.
Power word in title	The SEO title should include a natural power word such as “best”, “complete”, “easy”, “powerful”, or “ultimate”.
Sentiment in title	The SEO title should include natural positive or negative sentiment wording.
Permalink length	The full permalink should be 75 characters or fewer.
Table of contents	A Rank Math-compatible table of contents should be present, or a ToC plugin should be detected.
Keyword density	Exact focus-keyphrase usage should stay in Rank Math’s target range. Low density is improved and overuse is reduced.
Images or videos	Rank Math gives media credit for images or videos. Smart SEO preserves media and alt text but does not invent image or video URLs.

All in One SEO rules

Check	What Smart SEO checks
Focus keyword in content	The content should contain the focus keyword.
Focus keyword in introduction	The first paragraph should contain the focus keyword when natural.
Focus keyword in meta description	The meta description should contain the focus keyword.
Focus keyword in image alt	Existing image alt text should contain the exact focus keyword.
Focus keyword in subheadings	The exact focus keyword should appear in about 30%-75% of H2/H3 subheadings.
Focus keyword length	1-4 words passes; longer keyphrases may warn or fail.
Meta description length	The target range is roughly 121-160 characters. Empty descriptions fail.
Content length	More than 300 words passes. Shorter content may warn or fail.
Internal links	The content should link to another resource on the same site.
External links	The content should link to a relevant external resource.
Focus keyword near title beginning	The focus keyword should appear near the beginning of the SEO title.
SEO title length	The title should generally be 41-60 characters after AIOSEO-style title scoring.
Headline score	If AIOSEO’s headline analyzer is available, Smart SEO aims for a 70+ headline score.
Images or videos	The content should include rich media when AIOSEO scores it.
Sentence length	Too many sentences over 20 words can reduce the readability score.
Passive voice	Passive voice should generally stay at or below 10% of sentences.
Transition words	At least about 30% of eligible sentences should use transition words.
Consecutive sentences	Avoid four or more consecutive sentences starting with the same word.
Subheading distribution	Long sections should be separated by subheadings.
Flesch reading ease	Copy should be easy to read, with a target score of about 63 or higher.

The SEO Framework rules

Check	What Smart SEO checks
Meta description exists	A meta description should be present.
Meta description length	The strongest range is roughly 80-160 characters.
SEO title length and width	Smart SEO estimates the title shown by The SEO Framework, including the site title unless that setting removes it, and keeps it within the target display range.
Focus keyword behavior	The SEO Framework does not provide a native focus keyword field, so Smart SEO does not apply focus-keyword placement rules for this profile.

Smart SEO follows the active SEO plugin profile automatically. If more than one supported SEO plugin is active, AI Puffer chooses one profile and shows a warning. For predictable scores, use one SEO plugin at a time.

Some SEO plugin checks are owned by the SEO plugin itself and cannot always be fixed by AI Puffer. For example, plugin-specific premium AI checks or settings-based checks may still appear in the SEO plugin after generation.

Yoast SEO

AI Puffer saves the generated meta description to the Yoast meta description field and the generated focus keyword to the Yoast focus keyphrase field. If Optimize URL is enabled, the slug is built from the focus keyphrase when available. If there is no focus keyphrase, the post title is used. Smart SEO’s Yoast profile is tuned for Yoast SEO analysis and readability checks, including keyphrase placement, meta description length, links, image alt text, and readability signals.

Rank Math

AI Puffer saves the generated meta description to the Rank Math description field and the generated focus keyword to the Rank Math focus keyword field. Smart SEO’s Rank Math profile is tuned for Rank Math’s Basic SEO, Additional SEO, Title Readability, and Content Readability checks.

All in One SEO

AI Puffer saves the generated meta description to All in One SEO and updates the focus keyphrase data used by AIOSEO. Smart SEO’s All in One SEO profile is tuned for TruSEO checks, focus keyphrase analysis, readability checks, and headline score improvements.

The SEO Framework

AI Puffer saves the generated meta description to The SEO Framework description field. The SEO Framework does not provide a native focus keyword field, so AI Puffer does not save a focus keyword for it. Smart SEO’s The SEO Framework profile focuses on title and description behavior because The SEO Framework does not provide a native focus keyword field. If none of the supported SEO plugins are active, AI Puffer still saves the meta description as fallback post meta. Focus keyword output remains visible in Content Writer, but there is no SEO plugin field to save it into. WordPress tags and the optimized URL slug still work without an SEO plugin.

Publishing

Publishing controls the WordPress post that gets created after generation. To set the post target:

In the right-side General card, select the post Status.
Click the settings icon next to Status to open Post settings.
Select the Post Type.
Select the Author.
Select categories if the post type supports them.
Enable Table of Contents if you want a generated table of contents added to the top of the post.
Enable Optimize URL if you want AI Puffer to generate a cleaner WordPress slug.

Setting	Use it for
Status	Draft, Publish, Pending Review, or Private.
Post Type	Public WordPress post type.
Author	WordPress author.
Categories	WordPress categories assigned to the post.
Table of Contents	Adds a table of contents from the generated headings.
Optimize URL	Updates the WordPress slug after the post is saved.

Schedule

Schedule options appear when Status is set to Publish and you are generating multiple items. Single Entry publishes immediately when the status is Publish. To schedule posts:

Set Status to Publish.
Choose one of the available schedule modes.
Use Smart Schedule when AI Puffer should space posts automatically.
Use Use Dates from Input when each row, CSV line, or Google Sheets row already has its own date.
Generate the batch or create the task.

Option	Behavior
Publish Immediately	Publishes without spacing posts out.
Smart Schedule	Starts at a date/time and spaces posts by hours or days.
Use Dates from Input	Uses the schedule field from Batch Editor, Quick Paste, CSV, or Google Sheets.

Use this date format:

YYYY-MM-DD HH:MM

Quick Paste can include the schedule as the last field:

Topic | Keywords | Category ID | Author Login | Post Type | YYYY-MM-DD HH:MM

Use Dates from Input is available for Batch Editor, Quick Paste, CSV, and Google Sheets. RSS Feed and Web Page sources can use Publish Immediately or Smart Schedule.

Images

Images can be inserted into the article content, set as the featured image, or both. To use images, first choose what AI Puffer should create:

In the right-side Media card, set Images to Content, Featured, or Content + Featured.
Select the image provider or model from Image source.
Click the settings icon beside Image source to open Image settings.
Set the image count, placement, WordPress display size, alignment, and provider options.
Generate one item and review the image previews before saving the post.

Mode	Result
Off	No images are generated or fetched.
Content	Adds images inside the post content.
Featured	Sets a featured image.
Content + Featured	Adds content images and sets a featured image.

AI image sources use the image prompt. Stock photo sources use the generated keywords first. If there are no keywords, AI Puffer uses the topic or title as the search query.

Image prompts are used for OpenAI, Google, OpenRouter, Azure, xAI, and Replicate. Pexels and Pixabay do not use image prompts because they search existing stock photos.

Image placement controls where content images are inserted after the post is saved.

Setting	Use it for
Count	Number of content images to insert.
Placement	Where content images should be inserted.
X	Used only with every-X placement options.
Display size	WordPress image size used in the post.
Align	WordPress image alignment.

Placement options:

Placement	Result
After 1st H2	Inserts the first image after the first H2 heading.
After 1st H3	Inserts the first image after the first H3 heading.
Every X H2s	Inserts images after every selected number of H2 headings.
Every X H3s	Inserts images after every selected number of H3 headings.
Every X paragraphs	Inserts images after every selected number of paragraphs.
End of content	Adds images at the end of the article.

OpenAI

OpenAI uses your OpenAI API key and one of the image models available in your synced model list. To set it up:

Go to AI Puffer > Settings > AI.
Select OpenAI.
Add your OpenAI API key.
Sync models.
In the right-side Media card, set Images to Content, Featured, or Content + Featured.
Select an OpenAI image model from Image source.
In the right-side General card, click Customize next to Prompts if you want to change the image prompt or featured image prompt.

Google

Google uses your Google API key and the Google image models available in your synced model list. To set it up:

Go to AI Puffer > Settings > AI.
Select Google.
Add your Google API key.
Sync models.
In the right-side Media card, set Images to Content, Featured, or Content + Featured.
Select a Google image model from Image source.
In the right-side General card, click Customize next to Prompts if you want to change the image prompt or featured image prompt.

OpenRouter

OpenRouter uses image-capable models from your OpenRouter account. To set it up:

Go to AI Puffer > Settings > AI.
Select OpenRouter.
Add your OpenRouter API key.
Sync models.
In the right-side Media card, set Images to Content, Featured, or Content + Featured.
Select an OpenRouter image model from Image source.

If a selected OpenRouter model does not return images, choose another image-capable model from the synced list.

Azure

Azure uses your Azure OpenAI endpoint, API key, API version, and image deployment. To set it up:

Go to AI Puffer > Settings > AI.
Select Azure.
Add the Azure endpoint and API key.
Add or sync the image deployment you want to use.
In the right-side Media card, set Images to Content, Featured, or Content + Featured.
Select the Azure image deployment from Image source.

xAI

xAI uses your xAI API key and synced xAI image models such as grok-imagine-image. To set it up:

Go to AI Puffer > Settings > AI.
Select xAI.
Add your xAI API key.
Sync models.
In the right-side Media card, set Images to Content, Featured, or Content + Featured.
Select an xAI image model from Image source.

Replicate

Replicate uses your Replicate API key and synced text-to-image models. To set it up:

Go to AI Puffer > Settings > Integrations.
Select Replicate.
Add your Replicate API key.
Sync Replicate models.
In the right-side Media card, set Images to Content, Featured, or Content + Featured.
Select a Replicate model from Image source.

Pexels

Pexels searches stock photos instead of generating a new image. To set it up:

Go to AI Puffer > Settings > Integrations.
Select Pexels.
Add your Pexels API key, or use the Get Key link to create one.
In the right-side Media card, set Images to Content, Featured, or Content + Featured.
Select Pexels from Image source.
Click the settings icon beside Image source to open Image settings.
Set Orientation, Size, and Color if you want to filter results.
Generate one item and review the selected photo.

Pixabay

Pixabay searches stock photos, illustrations, or vectors. To set it up:

Go to AI Puffer > Settings > Integrations.
Select Pixabay.
Add your Pixabay API key, or use the Get Key link to create one.
In the right-side Media card, set Images to Content, Featured, or Content + Featured.
Select Pixabay from Image source.
Click the settings icon beside Image source to open Image settings.
Set Orientation, Type, and Category if you want to narrow results.
Generate one item and review the selected image.

Provider Options

Provider options control the generation request sent to the selected AI provider. They are separate from WordPress display settings such as Display size and Align. Only options supported by the selected provider and model are shown.

Provider	Available options
OpenAI	Canvas size, quality, output format, compression, background, moderation.
Azure	Canvas size, quality, output format, compression, background.
Google	Aspect ratio, image resolution, and person generation for supported Imagen models. Nano Banana models are included in the Google image model list.
OpenRouter	Aspect ratio and image resolution for models that support image configuration.
xAI	Aspect ratio and image resolution.
Replicate	Model-specific options from synced model schemas.

Pexels and Pixabay are stock image sources. Their filters narrow search results instead of changing an AI generation request.

Image Prompts

For AI image providers, the image prompt controls content images and the featured image prompt controls the featured image. You can use these placeholders:

Placeholder	Replaced with
`{topic}`	Generated title.
`{keywords}`	Generated keywords.
`{post_title}`	WordPress post title.
`{excerpt}`	Generated excerpt.

Image Metadata

To generate image metadata:

In the right-side General card, click Customize next to Prompts.
Enable the image metadata fields you want: Title, Alt Text, Caption, or Description.
Edit the metadata prompts if needed.
Generate the content and images.

AI Puffer saves generated metadata to the WordPress media attachment fields. Alt text is saved as the attachment alternate text.

Knowledge Base

Knowledge Base lets Content Writer use vector data you already added in AI Puffer > Knowledge Base > Data. When Knowledge Base is enabled, AI Puffer searches the selected vector source with the current generation prompt and adds the closest matches to the request. To enable it:

Add data in AI Puffer > Knowledge Base > Data first.
In the right-side Advanced card, set Context to OpenAI, Pinecone, Qdrant, or Chroma.
Select the vector store, index, or collection in Source.
Click the settings icon beside Source to open Context settings.
For Pinecone, Qdrant, or Chroma, select the embedding provider and model in Context settings.
Set Results Limit and Confidence Threshold.
Generate one item and check the output.

OpenAI

OpenAI uses OpenAI Vector Stores. To create a store:

Go to AI Puffer > Knowledge Base > Stores.
Select OpenAI as the provider.
Click Create Store.

Enter a store name and create it.
Go to AI Puffer > Knowledge Base > Data and add data to the store.

To use it in Content Writer:

In the right-side Advanced card, set Context to OpenAI.
Select one or more vector stores in Source.
Click the settings icon beside Source if you need to adjust Results Limit or Confidence Threshold.

When Content Writer uses an OpenAI model, AI Puffer can pass the selected vector stores to OpenAI file search. With other content models, AI Puffer searches the stores first and adds matching text to the prompt.

Pinecone

Pinecone stores vectors in an index. AI Puffer creates and searches those vectors with the embedding model you choose. The Pinecone index dimension must match the embedding model. For example, if your index is 3072 dimensions, use a 3072-dimension embedding model.

Use the same embedding model when adding data to Pinecone and when enabling Pinecone in Content Writer.

To create an index:

Add your Pinecone credentials in AI Puffer > Settings > Integrations.

Go to AI Puffer > Knowledge Base > Stores.
Select Pinecone as the provider.
Select the embedding model you want to use.
Click Create Store.

Enter an index name and use the dimension for the selected embedding model.
Create the index, then add data with the same embedding model.

To use it in Content Writer:

In the right-side Advanced card, set Context to Pinecone.
Select the Pinecone index in Source.
Click the settings icon beside Source to open Context settings.
Select the same embedding provider and model used when you added the data.
Adjust Results Limit or Confidence Threshold if needed.

Qdrant

Qdrant stores vectors in a collection. AI Puffer creates and searches those vectors with the embedding model you choose. The Qdrant collection size must match the embedding model. For example, if your collection is 3072 dimensions, use a 3072-dimension embedding model.

Use the same embedding model when adding data to Qdrant and when enabling Qdrant in Content Writer.

To create a collection:

Add your Qdrant URL and API key in AI Puffer > Settings > Integrations.

Go to AI Puffer > Knowledge Base > Stores.
Select Qdrant as the provider.
Select the embedding model you want to use.
Click Create Store.

Enter a collection name and use the dimension for the selected embedding model.
Create the collection, then add data with the same embedding model.

To use it in Content Writer:

In the right-side Advanced card, set Context to Qdrant.
Select the Qdrant collection in Source.
Click the settings icon beside Source to open Context settings.
Select the same embedding provider and model used when you added the data.
Adjust Results Limit or Confidence Threshold if needed.

Chroma

Chroma stores vectors in a collection. AI Puffer creates and searches those vectors with the embedding model you choose. Chroma collections do not require a dimension when they are created in AI Puffer, but stored vectors still need a consistent dimension. Use the same embedding model when adding data to Chroma and when enabling Chroma in Content Writer. To create a collection:

Add your Chroma endpoint, tenant, database, and API key in AI Puffer > Settings > Integrations.

Go to AI Puffer > Knowledge Base > Stores.
Select Chroma as the provider.
Click Create Store.

Enter a collection name.
Create the collection, then add data with the same embedding model.

To use it in Content Writer:

In the right-side Advanced card, set Context to Chroma.
Select the Chroma collection in Source.
Click the settings icon beside Source to open Context settings.
Select the same embedding provider and model used when you added the data.
Adjust Results Limit or Confidence Threshold if needed.

Limit and Threshold

Use these settings to control how much vector context is added to the generated content.

Setting	How it works	Example
Results Limit	How many matching pieces of knowledge AI Puffer can use.	`3` means AI Puffer can use up to 3 matching pieces.
Confidence Threshold	How closely a result must match before AI Puffer includes it.	Lower values allow looser matches. Higher values allow only stronger matches.

Use a lower threshold if useful context is being missed. Use a higher threshold if unrelated context is being included. After testing, open Usage > Logs and check the Score badge when vector results are recorded.

Start with a small limit and tune the threshold after testing real topics.

Logs

Content Writer activity is logged under AI Puffer logs.

Source	Log module
Direct Content Writer generation	`content_writer`
Automated Content Writer tasks	`content_writer_automation`

Use the content.generated event when another system needs to receive generated content after Content Writer finishes. See Event Webhooks for payload and delivery details.

​Overview

Create Content

Optimize

Templates

AI

Prompts

SEO

Publishing

Images

Knowledge Base

Logs

​Create Content

​Single Entry

​Batch Editor

​Quick Paste

​CSV

​RSS Feed

​Web Page

​Google Sheets

​Optimize

​Rewrite Posts and Pages

​Image Metadata

​WooCommerce Products

​Settings

​Templates

​AI

​Prompts

​SEO

​Smart SEO

​Yoast SEO

​Rank Math

​All in One SEO

​The SEO Framework

​Publishing

​Schedule

​Images

​OpenAI

​Google

​OpenRouter

​Azure

​xAI

​Replicate

​Pexels

​Pixabay

​Provider Options

​Image Prompts

​Image Metadata

​Knowledge Base

​OpenAI

​Pinecone

​Qdrant

​Chroma

​Limit and Threshold

​Logs

Overview

Create Content

Single Entry

Batch Editor

Quick Paste

CSV

RSS Feed

Web Page

Google Sheets

Optimize

Rewrite Posts and Pages

Image Metadata

WooCommerce Products

Settings

Templates

AI

Prompts

SEO

Smart SEO

Yoast SEO

Rank Math

All in One SEO

The SEO Framework

Publishing

Schedule

Images

OpenAI

Google

OpenRouter

Azure

xAI

Replicate

Pexels

Pixabay

Provider Options

Image Prompts

Image Metadata

Knowledge Base

OpenAI

Pinecone

Qdrant

Chroma

Limit and Threshold

Logs