{
  "slug": "settings-prompts",
  "title": "AI Prompts settings",
  "description": "Customise the prompt templates the CMS uses for field generation, SEO optimisation, translation, and other AI features — per site.",
  "category": "settings",
  "order": 5,
  "locale": "en",
  "translationGroup": "1c7e7c66-1090-42b9-89f8-974a2a434bb3",
  "helpCardId": null,
  "content": "## Where it is\n\n**Settings → AI Prompts** (`/admin/settings?tab=prompts`).\n\nThe CMS uses curated prompt templates for every AI-backed feature — generating a field, rewriting, translating, scoring SEO, optimising for GEO, summarising, extracting metadata. This tab lets you override the defaults on a per-site basis so the output matches your site's needs without having to build a custom agent.\n\n## Prompt categories\n\nThe tab lists every prompt slot the CMS exposes, grouped by purpose:\n\n### Content generation\n\n- **Field generate** — fills a single field given the rest of the document\n- **Field rewrite** — rewrites a field (shorter, longer, formal, casual, etc.)\n- **Document generate** — generates a complete document from a title + brief\n- **Interactive generate** — AI-builds a standalone HTML widget\n\n### Optimisation\n\n- **SEO optimise** — generates meta title, description, keywords, JSON-LD for a document\n- **GEO optimise** — restructures content to be answer-first, adds question headers, citations, statistics\n- **Alt-text generate** — fills `alt` for an image given its caption and filename\n\n### Translation\n\n- **Document translate** — document-level translation to a target locale\n- **Field translate** — single-field translation (used for UI strings in globals)\n\n### Research\n\n- **Content research** — gathers live web sources via `web_search` for a draft\n- **Citation format** — formats an external URL into a proper citation block\n\n### Moderation\n\n- **Proofread** — grammar, style, tone corrections (the inline proofreader)\n- **Moderation check** — flags potentially harmful content\n\n## What a prompt looks like\n\nEach prompt has three parts:\n\n- **System** — fixed instructions about role, tone, output format. Seldom needs changing.\n- **User template** — the variable part, with placeholder tokens like `{{field}}`, `{{title}}`, `{{brand_voice}}`, `{{locale}}`, `{{document_json}}`\n- **Example output** — a worked example the model can anchor on (optional but helps)\n\nBrand Voice is automatically injected as `{{brand_voice}}`; you don't need to duplicate it into every prompt.\n\n## Overriding a prompt\n\n1. Find the prompt in the list. Each row shows the slot name and the current source (`default` or `custom`).\n2. Click **Edit**.\n3. Write your override. The editor shows the default text as a reference and highlights placeholder tokens.\n4. **Test** runs the prompt against a sample document with your override. Verify the output looks right.\n5. **Save** — takes effect immediately for all future AI calls on this site.\n\nOverrides are stored in `_data/prompts.json`. They're included in site beams (so exported sites carry their prompt customisation).\n\n## Reverting\n\nEach row has a **Revert to default** button that drops the override. The default text is shipped with the CMS and updated with each release — reverting means you follow any improvements the @webhouse/cms team makes.\n\n## When to override\n\nReach for this tab when:\n\n- A specific prompt is consistently producing output that misses your brand\n- You want to inject domain-specific constraints (e.g. \"always include the product name\", \"avoid these legal phrases\")\n- You're A/B testing tone strategies between two sites\n- You want to translate prompts themselves to match a non-English editor team\n\n**Don't** override when you can solve the problem via Brand Voice — that's simpler, cheaper, and propagates to every feature automatically.\n\n## Related\n\n- [Brand Voice](/docs/brand-voice) — the global tone config injected into every prompt\n- [AI agents](/docs/ai-agents) — for full custom agents with their own prompts\n- [Cockpit](/docs/cockpit) — global temperature, token budget, model selection",
  "excerpt": "Where it is\n\nSettings → AI Prompts (/admin/settings?tab=prompts).\n\nThe CMS uses curated prompt templates for every AI-backed feature — generating a field, rewriting, translating, scoring SEO, optimising for GEO, summarising, extracting metadata. This tab lets you override the defaults on a per-site ",
  "seo": {
    "metaTitle": "AI Prompts settings — webhouse.app Docs",
    "metaDescription": "Override the built-in prompt templates for field generation, SEO, translation, and every other AI feature — per site.",
    "keywords": [
      "webhouse",
      "cms",
      "settings",
      "prompts",
      "ai",
      "templates",
      "override",
      "customise"
    ]
  },
  "createdAt": "2026-04-15T21:48:00.000Z",
  "updatedAt": "2026-04-15T21:48:00.000Z"
}