Skip to main content
Posts are the primary content type for your blog. You can create, edit, and publish posts to share articles, news, and updates with your audience.

Creating a post

Follow these steps to create a new blog post:
1

Navigate to posts

From the admin dashboard, click on Posts in the sidebar to access the posts management page.
2

Create new post

Click the New Post button in the top-right corner. The post editor will open.
3

Enter post details

Fill in the following information:
  • Title: Enter a descriptive title for your post
  • Slug: This URL-friendly identifier is auto-generated from the title, but you can customize it
  • Content: Write your post content using the editor. You can format text, add images, embed media, and more
4

Configure post settings

Click the Settings tab to configure additional options:
  • Categories: Select one or more categories to organize your post
  • Tags: Add tags to help readers find related content
  • Excerpt: Write a brief summary or let Halo auto-generate one
  • Cover Image: Upload a featured image for your post
  • Visibility: Choose who can view the post (Public, Internal, or Private)
  • Allow Comments: Enable or disable comments on this post
5

Save as draft

Click Save as Draft to save your work without publishing. You can return to edit it later.
Drafts are only visible to you and other authorized users in the admin dashboard. They won’t appear on your public site.

Publishing a post

When your post is ready to go live:
1

Review your content

Open the post in the editor and review all content and settings to ensure everything is correct.
2

Set publish time

In the Settings tab, you can:
  • Publish immediately by leaving the publish time at the current date and time
  • Schedule for later by selecting a future date and time
3

Publish the post

Click the Publish button. If you set a future date, the post will be scheduled and published automatically at that time.
After publishing, your post will be visible on your site according to the visibility settings you configured. Public posts appear to all visitors, while Internal posts require login, and Private posts are only visible to specific users.

Editing a post

You can edit both draft and published posts:
1

Find the post

Navigate to the Posts page and locate the post you want to edit. You can use the search bar or filters to find it quickly.
2

Open the editor

Click on the post title or the Edit button to open the post editor.
3

Make your changes

Edit the content, title, settings, or any other aspect of the post.
4

Save changes

Click Update to save your changes. For published posts, changes will be reflected on your site immediately.

Managing post visibility

Halo offers three visibility levels for posts:
  • Public: Visible to all visitors on your site
  • Internal: Only accessible to logged-in users
  • Private: Only visible to specific users with appropriate permissions
To change a post’s visibility, open the post editor, go to the Settings tab, and select the desired visibility level from the dropdown menu.

Pinning posts

You can pin important posts to keep them at the top of your post list:
1

Open post settings

In the post editor, navigate to the Settings tab.
2

Enable pinning

Toggle the Pin Post option to keep this post at the top of the list.
3

Set priority

If you have multiple pinned posts, adjust the Priority value. Higher numbers appear first.
Pinned posts are useful for announcements, featured content, or important updates you want readers to see first.

Deleting posts

To remove a post from your site:
1

Locate the post

Navigate to the Posts page and find the post you want to delete.
2

Move to recycle bin

Click the Delete button (trash icon) next to the post. The post moves to the recycle bin.
3

Restore or permanently delete

From the recycle bin:
  • Click Restore to recover the post
  • Click Delete Permanently to remove it completely
Permanently deleted posts cannot be recovered. Make sure you have backups of any content you might need in the future.

Understanding post phases

Posts in Halo go through different phases:
  • Draft: The post is being created or edited and is not published
  • Pending Approval: The post is awaiting review and approval from an editor
  • Published: The post is live and visible according to its visibility settings
  • Failed: An error occurred during publishing (check system logs for details)
The current phase is displayed as a badge next to the post title in the posts list.

Build docs developers (and LLMs) love