AI Post Summary

Generates a short AI summary for each post when it's published or updated, and exposes it through a dynamic tag you can drop into card templates, meta descriptions, or search results.

Requirements

• AI Settings configured with a provider and key
• At least one Voxel post type

Until AI Settings is configured, the settings panel shows a warning and the feature stays inert.

Settings

Setting	Description	Default
Enable for Post Types	Which Voxel post types auto-generate summaries	None
Max Tokens	Maximum length of the summary, 50–5000. Higher means longer.	300
Prompt Template	Custom instructions for the AI. Leave empty to use the built-in prompt.	Empty

Prompt Template

Use as the placeholder for the post's content:

Summarise this listing in two sentences for a directory search result.
Lead with what it is and where. Avoid marketing language.

{{post_data}}

Leaving it empty uses the default prompt, which the field shows as placeholder text.

Using the summary

Output it with the dynamic tag:

@post(ai.summary)

It works anywhere Voxel accepts dynamic tags — card templates, single-post templates, and email templates.

How it behaves

• Summaries generate when a post is published or updated
• They're stored in post meta, so displaying one costs nothing at render time
• A summary is only regenerated when the content changes, so editing an unrelated field won't trigger a new API call

Bulk generate

The settings panel has a Generate Summaries button that fills in existing posts which don't have a summary yet. Use it after enabling the feature so your back catalogue is covered rather than only new posts.

Bulk generation costs money per post

Every post without a summary makes an API call. On a large catalogue, check your provider's pricing and consider a cheaper model in AI Settings before running it.

Troubleshooting

Summaries aren't generating

• Confirm AI Settings has a working provider — use its Test Connection where available
• Confirm the post type is ticked under Enable for Post Types
• Re-save the post to trigger generation

The tag outputs nothing

The post has no summary yet. Either it was published before you enabled the feature — run Generate Summaries — or generation failed for that post.

Summaries are too long or too short

Adjust Max Tokens. Tokens are roughly ¾ of a word each, so 300 tokens is about 200 words. For a one-line card summary, try 80–120 and say so in the prompt.

Summaries are in the wrong language

Set Response Language in AI Settings — it governs AI Post Summary output.