Configuration

whiz.pub handles all server configuration automatically. This page covers the settings available to you as a blog owner.

Blog Settings

You can manage your blog settings from the dashboard at /app/settings. Available options:

Custom Domain

Add a custom domain to replace your yourname.whiz.pub subdomain. See Custom Domains for full DNS setup instructions.

Web

Go to /app/settings and enter your domain in the Custom Domain field, then click Save.

API

curl -X PUT https://whiz.pub/api/v1/settings \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"custom_domain": "blog.example.com"}'

CLI

whiz settings set custom-domain blog.example.com

SEO & Metadata

• Display name — shown in the blog header and browser title.
• Description — used in meta tags for search engines and social previews.
• Open Graph image — URL of an image used for social media previews.

Web

Go to /app/settings and fill in the Display name, Description, and Open Graph image fields, then click Save.

API

curl -X PUT https://whiz.pub/api/v1/settings \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "display_name": "My Blog",
    "description": "A blog about interesting things",
    "og_image": "https://example.com/og.png"
  }'

CLI

whiz settings set display-name "My Blog"
whiz settings set description "A blog about interesting things"
whiz settings set og-image "https://example.com/og.png"

API Key

Your API key is used with the CLI (whiz auth YOUR_KEY) and MCP endpoint. You can regenerate it at any time — the old key stops working immediately.

Web

Go to /app/settings. Your API key is displayed under the API Key section. Click Regenerate to create a new key.

API

curl -X POST https://whiz.pub/api/v1/settings/regenerate-api-key \
  -H "Authorization: Bearer YOUR_API_KEY"

CLI

whiz auth YOUR_KEY
whiz settings regenerate-api-key

AI Access

Toggle whether your blog exposes machine-readable pages at /llms.txt, /sitemap.xml, and markdown mirrors (/*.md). When disabled, these endpoints return 404.

Web

Go to /app/settings and toggle the AI Access switch on or off, then click Save.

API

curl -X PUT https://whiz.pub/api/v1/settings \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ai_access": true}'

CLI

whiz settings set ai-access true
whiz settings set ai-access false

Headless Mode

Use whiz purely as a headless CMS. When enabled, your blog's public pages (subdomain, sitemap, robots.txt, markdown mirrors) return 404. The API, CLI, and MCP continue to work normally — you can still create, edit, and manage posts. Your subdomain remains reserved.

Headless mode and custom domains are mutually exclusive. Remove your custom domain before enabling headless mode; disable headless mode before adding a custom domain.

Web

Go to /app/settings and toggle the Headless Mode switch on or off, then click Save. The toggle is disabled when a custom domain is configured.

API

# Enable headless mode
curl -X PUT https://whiz.pub/api/v1/headless \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"enabled": true}'

# Disable headless mode
curl -X PUT https://whiz.pub/api/v1/headless \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"enabled": false}'

CLI

whiz headless enable
whiz headless disable

MCP

Call whiz_set_headless with {"enabled": true} or {"enabled": false}.

Appearance

Customise your blog's visual appearance at /app/settings/appearance. See Themes & Appearance for details on presets, fonts, custom CSS, custom head HTML, and favicons.

Account

Password Reset

If you forget your password:

Web

1. Visit https://whiz.pub/forgot-password.
2. Enter your email and click Send reset link.
3. Check your email for a reset link (valid for 1 hour).
4. Set a new password.

API

# Step 1: Request a reset link
curl -X POST https://whiz.pub/api/v1/forgot-password \
  -H "Content-Type: application/json" \
  -d '{"email": "you@example.com"}'

# Step 2: Reset the password using the token from your email
curl -X POST https://whiz.pub/api/v1/reset-password \
  -H "Content-Type: application/json" \
  -d '{"token": "RESET_TOKEN", "password": "newpassword"}'

CLI

whiz forgot-password
# Follow the prompts, then check your email for a reset link.

Delete Account

You can permanently delete your account and all associated data. This action is irreversible.

Web

Go to /app/settings, scroll to the bottom, and click Delete Account. Confirm the deletion when prompted.

API

curl -X DELETE https://whiz.pub/api/v1/account \
  -H "Authorization: Bearer YOUR_API_KEY"

CLI

whiz account delete

Content Limits

Setting	Limit
Post title length	200 characters
Post content size	100 KB
Tags per post	10
Tag length	50 characters
Custom CSS	10 KB
Custom head HTML	5 KB
Favicon upload	2 MB