Skip to main content

Documentation Index

Fetch the complete documentation index at: https://kratecms.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Posts are the primary content type in KrateCMS. Use them to publish news articles, written pieces, audio recordings, or video content. Every post gets a clean, SEO-friendly URL generated from its title, and KrateCMS automatically links adjacent posts so readers can navigate forward and backward through your content.

​
Create a post

Navigate to Admin → Posts → New Post (or go directly to /admin/posts/create) to open the post editor.
1

Add a title

Enter your post title in the Title field. KrateCMS automatically generates a URL slug from the title — for example, a title of “Welcome to Our Blog” becomes /welcome-to-our-blog. The slug is generated for you and is not editable from the post editor; if you need a different URL, change the title.
2

Write your content

The Content field uses the TinyMCE rich-text editor. You can format text, add headings, insert links, create lists, and embed images directly within the body of the post. KrateCMS sanitizes post HTML at render time (via HTMLPurifier) before showing it to readers, so unsafe markup from pasted content is stripped from the public-facing page even if it is present in the stored content.
3

Add an excerpt

The Excerpt field (optional, up to 500 characters) is a short summary of the post. Excerpts appear in post listings and previews.
4

Choose a category

Select one of the four post categories from the Category dropdown. Categories appear as filter tabs on the public homepage posts feed, so readers can browse by type.

Text

Standard written articles and news posts.

Audio

Audio content, such as SoundCloud embeds or podcast episodes.

Video

Video content, typically accompanied by a YouTube embed.

Uncategorized

General posts that don’t fit a specific type.
5

Upload a featured image

Click Featured Image to upload an image from your device. Supported formats are JPEG, PNG, and WebP (maximum 2 MB). The featured image appears at the top of the published post. You can also generate a featured image using AI directly from the post editor — see AI image generation for details.
6

Add media (optional)

KrateCMS has three independent media fields. Fill in any combination — they each render their own player on the published post.
  • YouTube Video Link — paste a standard youtube.com/watch?v=… or youtu.be/… URL. Converted to an embedded YouTube player.
  • Audio URL — paste the URL of an audio file (MP3 recommended). KrateCMS embeds an audio player pointing at the URL. The optional Audio File Name field labels the player (for example, “Episode 1 – Introduction”).
  • Embed URL — paste a URL from a supported third-party provider (such as SoundCloud) to embed its player. The provider is detected automatically via EmbedService.
7

Set visibility

Use the Visibility toggle to control who can read the post.
  • Public — visible to all visitors, including people who aren’t logged in.
  • Members only — visible only to signed-in members of your site.
8

Set the publish date

The Publish Date field defaults to the current date and time. Change it to schedule a post for future publication — the post will only become visible to readers once that date and time has passed.
9

Save as draft, publish, or archive

Use the Status selector to control the post’s state before you save.
  • Draft — saves the post without making it publicly visible. Use this while you’re still writing or waiting for review.
  • Published — makes the post live immediately (or at the scheduled publish date if you set one in the future).
  • Archived — hides the post from the public feed without deleting it. Useful for retiring outdated content while keeping the record.

​
Draft and publish workflow

Save your work as a draft early and often. Drafts are only visible to you and other admin users — they never appear in the public posts feed until you publish them.
A typical workflow looks like this:
  1. Create the post and save it as a draft.
  2. Write and revise your content.
  3. Set a publish date if you want the post to go live at a specific time.
  4. Change the status to Published and save. The post appears in the public feed immediately (or at the scheduled date).
You can return a published post to draft at any time by editing the post and changing its status back to Draft.

​
Manage existing posts

Go to Admin → Posts (/admin/posts) to see all of your posts in a single list. From this view you can:
  • Filter posts by status (draft or published) or category
  • Click any post to open it for editing
  • See the publish date and visibility at a glance

​
How posts appear to readers

Once published, each post is available at its slug-based URL (for example, /my-post-title). KrateCMS automatically adds previous and next navigation links at the bottom of each post, so readers can move through your content in chronological order without returning to the homepage. Category filter tabs appear on the public homepage feed, letting readers browse posts by type (text, audio, video, or uncategorized).

​
Content security

KrateCMS sanitizes post HTML at render time before showing it to readers, using HTMLPurifier. This means that any unsafe or potentially harmful markup — whether pasted from an external source or entered manually — is cleaned out before the post is displayed on a public page. Stored content may still contain the raw HTML you pasted; the protection is applied on the way out.
The TinyMCE editor may display pasted content differently from how it will appear to readers. Always preview your post after publishing to confirm the layout looks as expected.

​
Post fields reference

Required. The headline of the post (up to 255 characters). Used to generate the URL slug and appears as the page heading on the published post.
Required. The full body of the post, edited in the TinyMCE rich-text editor. Supports formatted text, headings, links, lists, and inline images.
Optional. A short summary up to 500 characters. Shown in post listings and link previews.
Required. One of: Text, Audio, Video, or Uncategorized. Controls which filter tab the post appears under on the homepage feed.
Optional. The URL of an audio file, typically MP3 (audio_url column). KrateCMS embeds an audio player pointing at the URL on the published post.
Optional label for the audio file (audio_filename column) — for example, “Episode 1 – Introduction.” Shown alongside the audio player.
Optional. A URL from a supported third-party provider — SoundCloud and others (embed_url column). The embed_provider accessor is computed from this URL at read time via EmbedService.
Controls who can read the post. Public is open to all visitors. Members only requires the reader to be logged in.
The date and time the post becomes visible. Set a future date to schedule publication. Defaults to the current date and time.
Draft keeps the post hidden from public view. Published makes it live (at the publish date, if one is set). Archived hides the post from the public feed without deleting it.