Writing & Publishing
How to create posts, use the element editor, work with AI assistants, and navigate the review process.
Blogs
A blog is a content channel -- a named feed with its own URL, image, and description. Think of blogs as categories or columns in a magazine: "Travel Stories", "Tech Reviews", "Club News".
Every post belongs to a blog (or is unassigned). When a post is approved, it appears in its blog's public feed at /{blog-slug} and the post itself is reachable at /{blog-slug}/{post-slug}.
Creating a Blog
Click New Blog on the Post Board (or the + column on the right). You'll be asked for:
- Title -- the blog's display name
- Slug -- URL-friendly identifier (auto-generated from title if left blank). Cannot be changed after creation.
- Description -- a short summary shown on the blog's public page
After creation, the blog appears as a new column on the Post Board.
Blog Settings
Click the expand arrow on any blog column header to see its details. From there, click Edit to change the blog's title, description, image, or status.
| Status | Meaning |
|---|---|
| Active | Blog and its posts are publicly visible |
| Completed | Publicly visible (signals the blog is finished but still readable) |
| On Hold | Hidden from public site |
| Archived | Hidden from public site |
Shared Blogs
Blogs can be shared -- meaning multiple bloggers can contribute posts to the same blog. Shared blogs show a "Shared" badge in the column header. You'll see shared blogs from other contributors on your Post Board alongside your own.
Deleting a Blog
Only the blog owner can delete it. Posts in a deleted blog are moved to Unassigned -- they're never deleted.
The Post Board
The Post Board is a kanban-style board where you manage all your posts. Each column represents a blog. The first column, Unassigned, holds posts not yet assigned to any blog.
What You See
Each post card shows a thumbnail, title, status badge, and last update time. Click the expand arrow on a card to reveal more: cover image, template name, tags, latest review feedback, and action buttons (Edit, Preview, Submit/Resubmit, Delete).
Use Expand All / Collapse All in the top bar to toggle all cards at once.
Drag & Drop
Drag any post card from one column to another to assign it to a different blog. The post immediately moves to the target column, and the blog assignment is saved automatically.
- Drag a post from Unassigned to a blog column to assign it
- Drag a post between blog columns to reassign it
- Drag a post back to Unassigned to remove its blog assignment
You can also assign a blog from the post editor sidebar (the Blog dropdown).
Submitting from the Board
You don't have to open a post to submit it for review. If a post is ready, click Submit (or Resubmit) directly on the expanded card. A confirmation dialog shows the post title and any previous review feedback before submitting.
Creating a Post
1. Choose a Template
Click New Post on the Post Board. You'll see a grid of available templates -- each one defines a starting layout with predefined content blocks. Pick the template that best fits your content type.
Templates show which element types they support (text, images, video).
2. The Element Editor
The post editor is a two-part interface:
Top bar -- post title, save/preview buttons, and a template indicator.
Canvas -- the main content area where you build your post using drag-and-drop elements.
Element Types
| Element | What It Does |
|---|---|
| Rich Text | Formatted text with headings, lists, links, bold, italic. Uses a Trix editor. |
| Media | Single image with caption and alt text, image gallery with individual captions, or embedded video. |
How to Add Elements
- Drag from the palette -- drag "Text" or "Media" from the top-right palette onto the canvas
- Click to add -- or click "Start with Text" / "Start with Image" on an empty canvas
Layout Options
Elements can be full-width or half-width (side-by-side). Toggle between them to create richer layouts -- for example, text on the left, image on the right.
Reorder elements by dragging them up or down on the canvas.
Post Settings (Sidebar)
While editing a post, the right sidebar shows:
| Setting | What It Does |
|---|---|
| Cover Image | The main image displayed in post listings and social shares |
| Teaser | A short summary shown in post previews and feeds |
| Blog | Which blog this post belongs to |
| Tags | Labels for organizing content. You can add tags manually, but most tagging happens automatically (see below). |
| Status | Current state: draft, submitted, needs revision, approved, published |
AI Assistants
The editor includes AI-powered helpers accessible from each element:
| Assistant | What It Does |
|---|---|
| Improve Text | Polishes wording, fixes grammar, enhances clarity. Shows a diff preview before applying. |
| Generate Teaser | Writes a short summary for article previews and social sharing. |
| Generate Tags | Suggests relevant tags based on your content. |
| Image Captions & Alt Text | Generates descriptions for accessibility and SEO. |
These are suggestions, not replacements. You always have the final say -- review the AI output and apply or discard it.
Automatic Tagging
You don't need to worry about tagging your posts. When a post is approved, the AI automatically assigns tags based on its content -- typically around 10 tags per post. The AI knows the existing tags on your site, reuses them when they fit, and only creates new ones when nothing matches.
This means consistent, thorough tagging without anyone having to think about it. No forgotten tags, no inconsistent naming, no duplicates.
You can still add tags manually in the sidebar if you want -- for example, to flag a post for a specific collection. But it's entirely optional.
Submitting for Review
When your post is ready:
- Click Submit for Review in the sidebar
- The AI reviewer evaluates your content for quality, tone, and adherence to the site's content guidelines
- You'll receive a review result -- usually within seconds
Review Outcomes
| Status | What It Means | What To Do |
|---|---|---|
| Approved | Meets all guidelines. Published immediately. | Nothing -- your post is live! |
| Needs Revision | Specific feedback on what to improve. | Read the feedback, make changes, resubmit. |
| Flagged | Edge case sent to an admin for manual review. | Wait for the admin's decision. |
| Rejected | Clear guideline violation. | Read the explanation, revise significantly, and resubmit. |
Review feedback appears in the sidebar and on the Dashboard's Recent Activity section.
Resubmitting
After making revisions based on feedback:
- Open the post from the Post Board or from the review link in the sidebar
- Make your changes
- Save the draft
- Submit for review again
Previewing Your Post
Click Preview in the top bar to see how your post will look on the live site. The preview opens in a new tab using the site's actual theme.
Preview requires a title and a saved draft. If the Preview button is grayed out, enter a title and save first.
Managing Your Profile
Go to Profile in the sidebar to edit:
- Avatar -- upload a profile photo
- Name -- first and last name displayed on your posts
- Username -- your public URL (
/bloggers/your-username) - Bio -- a short description shown on your blog page
Quick Tips
- Save often -- the editor auto-saves, but manual saves are instant
- Use descriptive titles -- they appear in search results and help readers find your content
- Add alt text to images -- helps accessibility and SEO
- Write a teaser -- it's what readers see before clicking into your post
- Assign posts to a blog -- organize your content by topic
- Check the Getting Started guide in your sidebar -- it has the content guidelines for your specific site