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 for supported SEO plugins.
Publishing
Set post type, status, author, taxonomy, and schedule.
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.
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.
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.
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:
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:
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.
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.
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.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.
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.
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.
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.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.
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 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 image size, and alignment.
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, 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.
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.
For AI image providers, the image prompt controls content images and the featured image prompt controls the featured image.You can use these placeholders:
Knowledge Base lets Content Writer use vector data you already added in AI Puffer > Knowledge Base.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 first.
In the right-side Advanced card, set Context to OpenAI, Pinecone, or Qdrant.
Select the vector store, index, or collection in Source.
Click the settings icon beside Source to open Context settings.
For Pinecone or Qdrant, select the embedding provider and model in Context settings.
OpenAI uses OpenAI Vector Stores.To create a store:
Go to AI Puffer > Knowledge Base.
Select OpenAI as the provider.
Click Create new vector store.
Enter a store name and create it.
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 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.
Select Pinecone as the provider.
Select the embedding model you want to use.
Click Create new index.
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 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.
Select Qdrant as the provider.
Select the embedding model you want to use.
Click Create new collection.
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.
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.
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.