Creating and Using Posts

Posts are pieces of content such as articles, news items, events, or any other content type configured for your site. Each post belongs to a collection (sometimes called a post type), which determines its fields, layout, and behaviour.

Accessing Posts

Posts are accessed through Collections in the admin sidebar. Each collection (for example, Blog, News, or Events) has its own listing. Select the collection to see its posts.

The Posts Listing

The listing screen shows all posts in a collection. Depending on your configuration, you may be able to switch between views using the view controls:

  • Table -- the default row-by-row listing
  • Kanban -- posts grouped into columns by category or another field, draggable to reorder and reassign
  • Calendar -- posts plotted by publish date

Searching and Filtering

Use the search bar to find posts by title or content. Filters are available to narrow results by status, category, tags, or custom fields.

Sorting

Click a column header to sort ascending or descending.

Bulk Actions

Select multiple posts using the checkboxes and choose an action from the bulk actions menu. Available actions include:

  • Delete
  • Publish / Unpublish
  • Assign to a category
  • Apply a tag

Creating a Post

Standard Creation

  1. In the posts listing, click New or the equivalent add button.
  2. Enter a Title. The URL slug is generated automatically from the title but can be edited.
  3. Fill in the content fields. Which fields appear depends on the collection configuration.
  4. Set publishing options in the right-hand panel (see below).
  5. Click Save.

After saving you are redirected to the full edit screen where all fields are available.

AI-Assisted Creation

If OpenAI is configured on your site, you can create a post with AI-generated content:

  1. Enter a title and an optional brief description or prompt.
  2. Click the AI generation option.
  3. The system dispatches a background job to generate the article. If the content is not ready immediately, you will see a waiting screen that refreshes automatically.
  4. Once generation is complete, you are taken to the edit screen to review and refine the content.

Editing a Post

The edit screen is divided into two areas.

Left Column -- Content Fields

The main content area contains the fields defined by the collection schema. Common fields include:

  • Title -- the post headline; also used to generate the slug
  • Content -- the main body (rich text editor where configured)
  • Any custom fields set up for the collection (dates, selects, media, etc.)

Right Column -- Panels

Publish

Controls when and how the post appears publicly.

Field Description
Status Published makes the post live; Draft hides it from the public
Visibility Public is visible to anyone; Private is visible only to authenticated users
Publish At Schedule a future date and time for the post to go live. Leave blank to publish immediately when Status is set to Published
Publish Until Optional expiry date. After this date the post will no longer appear publicly

A "View Post" link appears when the collection has a valid base URL configured, letting you preview the live page in a new tab.

Summary

Field Description
Post Type The collection this post belongs to. Changing this moves the post to a different collection
Summary A short description used in listings, previews, and SEO meta descriptions. An AI generate button is available to draft this from the content
Keywords SEO keywords. An AI generate button is available to suggest keywords from the content

Tags

Appears when the collection has tagging enabled. Select one or more tags from the list. Multiple tag types may be shown as separate panels if the collection is configured that way.

Attachments

Appears when the collection has thumbnail support enabled. Use the asset selector to choose an image from the media library or upload a new one.

Parent / Hierarchy

Appears when the collection supports hierarchical posts. Assign a parent post to nest this post within a tree structure.

Version History

Every time a post is saved, the previous state is automatically snapshotted. Up to 50 versions are stored per post.

To access versions:

  1. On the edit screen, open the version history panel (if shown by your theme).
  2. Each version shows the date and time it was created.
  3. Click Preview to view a version without restoring it.
  4. Click Restore to roll back to that version. The current state is snapshotted before the restore so you can undo the restore if needed.

Exporting Posts

From the posts listing, use the export option to download all posts in the current collection (respecting any active search or filters). Supported formats: CSV, XLSX, XLS, ODS, TSV, HTML.

Deleting a Post

Open the post and use the Delete option, or select it in the listing and use the bulk delete action. Deleting a post also removes its associated thumbnail from storage.

Publishing Rules

A post is visible to the public only when all of the following are true:

  • Status is Published
  • Visibility is Public
  • Publish At date is in the past (or not set)
  • Publish Until date is in the future (or not set)

Posts set to Draft or Private are never shown on the public-facing site regardless of the dates.
esc