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.

KrateCMS gives you control over your site’s behavior, appearance, and security entirely through the admin interface. All customer-facing settings live under Settings in the left sidebar, organized into categories. This page explains what each category controls and where to find it.
You need the admin role or higher to access Settings. If you do not see the Settings item in your sidebar, contact your platform administrator to adjust your role.

Settings categories

General settings control the foundational identity of your site.
SettingWhat it does
Site NameThe name displayed in the browser tab, emails, and the admin header
Site DescriptionA short summary used in meta tags and the public homepage
Footer TextCustom text or HTML shown in the site footer
Company NameYour organization’s legal or operating name (used in invoices and formal email footers)
Company AddressMailing address used in invoices and email footers where required
Set your site name and description first — they appear in every outbound email your site sends and in search engine previews.
Timezone is platform-managed via the APP_TIMEZONE environment variable and is not exposed as a UI field. Contact your platform administrator if you need it changed.
Brand settings control the entire visual identity of your site. Changes here apply to both the public-facing site and, where applicable, the admin interface.
SettingWhat it does
Primary ColorThe main color used for primary buttons, links, and active states
Secondary ColorA complementary tone for surfaces and supporting UI
Accent ColorA highlight color for decorative elements and emphasis
TypographySeparate heading and body fonts
Theme ModeLight or dark
LogoUploaded image displayed in the header and emails
FaviconSmall icon shown in browser tabs and bookmarks
Custom CSSFreeform CSS injected into every public page for fine-grained overrides
Use Custom CSS for tweaks that the color and typography controls do not cover — for example, adjusting spacing around a specific element or overriding a default font weight.
Content settings determine how your site presents content to visitors.Site Visibility controls who can read your site:
ValueBehavior
PublicAll published content is readable by anyone, no login required
Members OnlyVisitors must be logged in to read any content
Homepage Type controls what appears at the root URL of your site:
ValueBehavior
PostsA scrolling feed of published posts with category filters (default)
PageA specific Page you select from the page picker — useful for custom landing pages
MarketingA legacy marketing template
Posts in Nav toggles whether a “Posts” link appears in the public navigation bar. Disable it if your site uses a Page as its homepage and you want to keep the nav focused on your custom page structure.
Site visibility is a site-wide gate. Individual posts also have their own visibility setting (public or members-only), which combines with the site-wide setting — a members-only post is always private regardless of site visibility.
Tracking and analytics tags (Google Tag Manager, etc.) are configured at the platform level during the KrateCMS alpha period and are not available as a tenant-facing settings panel. Platform tags render across the central marketing site and every tenant subdomain.
The tenant /admin/settings/analytics route is blocked by middleware during alpha — tenants do not see this entry in the sidebar. Per-tenant analytics configuration will be exposed in a future release. For now, ask your platform administrator if you need a tag added.
Contact settings configure the public contact form that appears on your site. Use these to control whether the form is active, where submissions are sent, and how emails are labeled.
SettingWhat it does
Enable Contact FormShow or hide the public contact form
Recipient EmailThe address where contact form submissions are delivered
Subject PrefixA short label prepended to every contact email subject line (for example, [My Site])
Submissions are also logged in the admin at /admin/contact-submissions so you can review them even if an email is missed.
Security settings let you enforce authentication and session policies for everyone who logs into your site.
SettingWhat it does
Max Login AttemptsNumber of failed logins before an account is locked out
Lockout DurationHow long (in minutes) a locked account must wait before retrying
Password PolicyMinimum length and complexity requirements for all user passwords
Session TimeoutIdle time (in minutes) before a user is automatically logged out
A lockout duration of 15–30 minutes and a max of 5 attempts is a common starting point. For high-security environments, consider tightening to 3 attempts and a 60-minute lockout.
KrateCMS also automatically rejects passwords found in data breaches via the Have I Been Pwned database — this protection is always on and cannot be disabled.
Chat settings configure the AI assistant that powers the chat interface, the image generator, and the API Q&A mode.
SettingWhat it does
AI Chat ModelThe OpenAI model used for chat responses (for example, gpt-4o, gpt-4o-mini)
Model FallbacksOrdered list of fallback models if the primary model is unavailable
TemperatureControls response creativity; range 0–2, where 0 is deterministic and 2 is most creative
Max TokensThe maximum length of each AI response
HTTP TimeoutSeconds to wait for an OpenAI response before failing
HTTP RetriesNumber of automatic retries on transient API failures
HTTP Retry Delay (ms)Milliseconds to wait between retries
Verify SSLWhether to validate SSL certificates on outbound API calls
AI Image ModelThe OpenAI model used for image generation (for example, dall-e-3)
AI Image QualityStandard or HD output quality
AI Image HTTP TimeoutSeconds to wait for an image generation response
API Read Allowed HostsAllowlist of external hostnames the API Q&A mode is permitted to read
The Chat settings panel is gated by a feature flag. If you do not see it in your sidebar, the AI chat feature has not been enabled on your plan.
If a setting in the Chat panel appears grayed out and labeled “overridden by environment,” it has been locked by your platform operator and cannot be changed from the UI.
Billing settings let you view your current subscription, update your payment method, and access invoice history. All payment processing is handled by Stripe — your card details are never stored in KrateCMS.From the Billing page you can:
  • Check your current plan and billing period
  • Update your payment method via Stripe’s secure hosted page
  • Download PDF invoices for past charges
The Billing panel is gated by a feature flag and is off by default during early access. Contact your platform administrator to enable Stripe billing for your site.

Settings priority

When a setting can be configured both through the admin UI and through a platform-level environment variable, the environment variable always wins. If a field is grayed out in the UI with a note that it is “overridden by environment,” it means your platform operator has locked that value. Contact them to change it.

Quick reference

CategoryURLRole RequiredFeature Flag
General/admin/settings/generaladminAlways on
Brand/admin/settings/brandadminAlways on
Content/admin/settings/contentadminAlways on
Security/admin/settings/securityadminAlways on
Contact/admin/settings/contactadminOn by default
Analytics(platform-managed during alpha)Not exposed to tenants
Chat/admin/settings/chatadminOff by default
Billing/admin/settings/billingadminOff by default