Writing Blog Posts
A complete walkthrough of the blog post editor — content, metadata, SEO, and publishing.
The blog post editor gives you full control over content, layout metadata, and SEO for every post.
Open it by clicking New Post (and completing the initial dialog) or clicking the three-dot menu and selecting Edit on an existing post in the Blog panel.
Screenshot placeholder
Blog post editor full view
Title & Slug
| Field | Description |
|---|---|
| Title | The post's headline — shown in the browser tab and blog index |
| Slug | The URL path (e.g., /blog/my-first-post) — auto-generated from the title, manually editable |
Once a post is published, changing the slug breaks existing links to the post. Only change it before first publishing.
Cover Image
Click Pick cover image (or Change cover) to select a featured image from your workspace Asset Library, or upload a new one.
- Supported formats: JPG, PNG, WEBP, GIF
- Recommended dimensions: 1200×630 px (16:9 ratio)
- Click the X button on the preview thumbnail to remove the cover image.
Excerpt
A short summary of the post (1–2 sentences). This appears:
- In the blog index preview cards.
- As the default
meta descriptionif no SEO description is set.
Post Body Editor
The post body utilizes a rich text block editor (Tiptap). The toolbar provides a comprehensive set of formatting tools:
- Text Structure: Set blocks to Paragraph, Heading 1, Heading 2, Heading 3, or Heading 4.
- Inline Styling: Apply Bold, Italic, Underline,
Strikethrough,Inline code, Subscript, or Superscript to selected text. - Colors & Highlights: Select from a curated color palette for text colors and highlight/background colors.
- Alignment: Align text left, center, or right.
- Lists: Format content as Bullet lists, Numbered lists, or interactive Task checklists.
- Structural Elements: Insert blockquotes, dividers (horizontal rules), and fully-featured Tables (with row/column insertion and deletion controls).
- Media & Embeds:
- Image (pick) — Select or upload an image via the Asset Library.
- Image from URL — Embed an image from an external web address.
- Embed YouTube — Insert YouTube videos directly using their URL.
- Image Controls: Once an image is inserted, click it to adjust its width in pixels or add custom Alt text for accessibility.
- Raw HTML / Liquid: Insert a raw HTML block to render custom elements, Liquid template tags, or custom scripts verbatim.
- History: Use the Undo and Redo buttons in the toolbar to revert or repeat changes.
Author & Classification
Configure post attribution and organization in the right sidebar:
| Field | Description |
|---|---|
| Author | Select a profile managed in the Authors subtab (or choose Unattributed). |
| Category | Assign the post to one category managed in the Categories subtab (or choose Uncategorised). |
| Tags | Toggle one or more tag badges managed in the Tags subtab. |
Display Settings
Control which elements appear on the public post page using the sidebar toggles:
| Toggle | Description |
|---|---|
| Cover image | Display the featured cover image at the top of the article. |
| Author byline | Display the author's display name and short bio card. |
| Published date | Show the publication date. |
| Reading time | Show an estimated read time based on the post's word count. |
| Tags | Display tag badges at the bottom of the article. |
SEO & Metadata
Optimize how your article appears in search engine results and social media sharing cards:
| Field / Toggle | Description |
|---|---|
| Meta title | Overrides the browser <title> tag. Defaults to the post title if left blank. |
| Meta description | A 150–160 character snippet for search engines. Defaults to the excerpt if left blank. |
| OG image URL | Direct URL to a custom image for social sharing cards (defaults to the cover image). |
| Canonical URL | Specify a canonical link if this article is republished from another source. |
| Exclude from search engines (noindex) | Toggle to prevent search engine web crawlers from indexing this post. |
Saving & Publishing
Saving Drafts
Draft progress is not saved automatically. You must click the Save button in the top right to store your changes.
- Save: Save your current progress (button is enabled when there are unsaved edits).
- Snapshot draft: Save a timestamped version milestone of the draft in the database.
Publishing Workflow
- Publish: Pushes all current changes live. The post becomes instantly accessible at
/blog/[slug]. - Unpublish: Takes the article offline. The status returns to Draft, hiding it from the public.
Post Statuses
| Status | Meaning |
|---|---|
| Draft | Visible only to workspace members within the dashboard. |
| Published | Live and visible to the public. |
| Archived | Reserved status (archiving will be fully exposed in a future update). |
Note: Post scheduling (setting a future date and time to publish) will be available in an upcoming release.