Content List Format

The content list is a CSV or YAML file that tells Batch Generate Text with any AI what to generate. Each row or item becomes one piece of content.

Use Browse on Step 3 to load your own file, or click Generate CSV to create a starter list inside the app. The folder button opens the built-in topics folder with ready-to-use examples.


Field reference

Field Aliases accepted Required
title topic, subject Yes
theme category No
keywords tags, keyword No
notes note, guidance, context No

All fields except title are optional. A one-column CSV with just titles works fine for a quick run.

What each field does:

  • title - the subject or headline of the piece. The AI uses this as its primary brief.
  • theme - used to steer the angle and match quotes when you load a quote bank.
  • keywords - passed directly into the prompt. Use this to steer the AI toward specific angles, terms, or topics.
  • notes - freeform guidance injected into the prompt for that item only. Use this for per-item instructions like tone direction, structure preferences, or specific points to cover.

CSV format

title,theme,keywords,notes
"How to Price Your First Rental Property","Real Estate","property, investment, rental yield","Walk a first-time landlord through yield calculation and common pricing mistakes."
"5 Mistakes New Dog Owners Make in the First Month","Pets","dog training, puppy, habits","Warm reassuring tone. Practical fixes. Focus on the first critical weeks."

CSV works well when you are building your list in a spreadsheet. Export as CSV and load directly.


YAML format

- title: "How to Price Your First Rental Property"
  theme: Real Estate
  keywords: "property, investment, rental yield"
  notes: |
    Walk a first-time landlord through the key numbers.
    Cover yield calculation, vacancy rate, and common pricing mistakes.
    Keep the maths simple - show the formula with a worked example.

- title: "5 Mistakes New Dog Owners Make in the First Month"
  theme: Pets
  keywords: "dog training, puppy, habits"
  notes: |
    Warm and reassuring tone - not shaming.
    Practical fixes for each mistake.
    Focus on behaviour shaping in the first critical weeks.

YAML is better when you want multi-paragraph notes or richer per-item guidance.


Generate CSV inside the app

Use Generate CSV on Step 3 when you want the app to create a content list for you.

You can choose:

  • Rows - 1 to 50 generated rows
  • Type - the content type, such as Blog Article, LinkedIn Post, X Post, Facebook Post, Short Story, or Custom Content
  • Topic - choose from the list or type your own topic
  • Mood - choose one or more moods; multiple moods are blended
  • Audience - choose the intended reader group
  • Theme - choose one or more themes; generated rows are spread across the selected themes
  • Keywords - optional terms to include in the generated CSV
  • Notes - optional instructions that should apply to the generated list

The generated CSV includes title, theme, keywords, and notes, is saved locally, and is selected automatically for the run.


Built-in example files

The app ships with a topics folder that includes:

File Use
articles.csv / articles.yaml General starter content list
blog-article.csv Blog article list
linkedin-post.csv LinkedIn post list
x-post.csv X post/thread list
facebook-post.csv Facebook post list
short-story.csv Short story list
custom-content.csv Custom template list
samples.yaml Example writing samples
quotes.yaml Example quote bank

Tips

  • One template per file. Each run uses one template for the entire list. Keep separate files for blog articles, LinkedIn posts, X posts, and stories.
  • Notes are powerful. Detailed per-item notes consistently produce better output than a vague title alone.
  • Theme helps with quote matching. If your quotes have themes, matching item themes to quote themes gets you more relevant quote suggestions.
  • Keywords are passed verbatim. Write them as a comma-separated list. The AI uses them to steer content; they do not need to appear literally in the output.