Setting the file. One moment.
Subchapter 7.14
references/blog/seed/SEED.mdMarkdown4 KBView on GitHub
Seed by running seed-blog.mjs with a plan file — don’t hand-write the REST calls.
The script mints its own site token via the Wix CLI (logged-in session + wix.config.json
required), installs the Blog app if needed, resolves a real author memberId (every post
create requires one), and creates everything in the right order — categories/tags first,
then posts, then imported cover images (PATCH + re-publish).
# from the project root (where wix.config.json lives):
node <SKILL_ROOT>/references/blog/seed/seed-blog.mjs plan.jsonplan.json is plain data — write it from the brief. Default to 3 posts (the seed shows
the shape; the owner writes the rest in the dashboard) and make them exercise the UI: group
them into 2 categories when the brief has natural sections, tag a couple, vary the content
blocks (heading + paragraphs + a quote or list per post), and give every post a cover — a
feed without covers looks broken.
{
"categories": ["Brewing", "Stories"],
"posts": [
{ "title": "How We Roast Our Single-Origin Beans", "category": "Stories", "tags": ["coffee"],
"coverImageUrl": "https://…",
"content": [
{ "type": "heading", "text": "From farm to cup", "level": 2 },
{ "type": "paragraph", "text": "Every batch starts with beans sourced from a single estate." },
{ "type": "quote", "text": "Great coffee is grown, not made." }
] },
{ "title": "The Pour-Over, Step by Step", "category": "Brewing", "tags": ["guides"],
"coverImageUrl": "https://…",
"content": [
{ "type": "paragraph", "text": "A repeatable ritual in five minutes." },
{ "type": "ordered", "items": ["Rinse the filter", "Bloom 30 seconds", "Pour in circles"] }
] },
{ "title": "Why Water Matters More Than You Think", "category": "Brewing",
"coverImageUrl": "https://…",
"content": [
{ "type": "paragraph", "text": "Coffee is 98% water — its minerals decide the cup." },
{ "type": "bulleted", "items": ["Filtered, not distilled", "Aim for ~150 ppm hardness"] }
] }
]
}content blocks: {type:"heading",text,level?} · {type:"paragraph",text} ·
{type:"quote",text} · {type:"bulleted"|"ordered",items:[…]}. For node types these don’t
cover (code, inline images), pass a pre-built Ricos richContent on the post instead.category/categories/tags are display names — created idempotently and resolved to
ids internally. Optional: skip them entirely when the brief doesn’t group posts.coverImagePrompt (AI-generated, ~1 Wix AI credit per image,
account-billed): brand-contextual — subject, aesthetic/mood, palette, lighting — always
ending “no text, no watermarks”. At least one image in the set shows the real subject of the business — the actual product/space/service, not abstract decoration. For an asset the user actually supplied use
coverImagePath (a file on this machine — uploaded to Wix Media) or coverImageUrl (their
own hosted URL; verify it with curl -sI → 200) — never a stock-photo or guessed URL. Covers resolve
in parallel and never block the seed; a failed cover leaves that post text-only (the script
re-publishes each post it covers).posts[].success in the result.Seeding is additive — never delete or overwrite existing content; ask first if a cleanup seems needed.
setupBlog composes exported steps — installBlogApp, getAuthorMemberId, createPosts,
createCategories, createTags, importImage, attachPostCovers, plus makeCtx() —
import them only for a partial re-seed.
Unexpected shape or an uncovered operation → read the live Wix API reference; the
authoritative source recipe is wix-headless/references/inline-recipes/setup-blog.md.