Publication Settings Reference
Complete reference for all publication settings. The settings editor covers identity, custom home pages, navigation, forms, theming, SEO, PDF typography, and more. Available tabs depend on the publication type (Website or PDF).
Publication settings control every aspect of your published documentation. Website publications use site.cf.settings.json and PDF publications use pdf.cf.settings.json. The settings editor shows different tabs depending on the publication type. This page links to detailed reference documentation for each area.
Settings Areas
| Area | Tabs Covered | What It Controls |
|---|---|---|
| General and Identity | General, Home Page | Site title, subtitle, logo, brand colours, SEO URL, title bar and sidebar panel colours |
| Custom Home Page | Custom Home Page | Marketing home page builder with 8 section types including hero, feature grid, CTA, and embedded diagrams |
| Top Menu | Top Menu | Configurable top navigation bar with links to pages, external URLs, forms, and home |
| Custom Sidebar | Custom Sidebar | Marketing sidebar replacing the default content tree with icon-based navigation to directories, pages, and external links |
| Footer | Footer | Site footer with link groups, colours, and copyright text |
| Forms | Forms | Visual form builder with 9 control types for data collection on published sites |
| Cookie Banner | Cookie Banner | GDPR-compliant cookie consent banner with configurable text and privacy policy link |
| API Inclusion | REST API, GraphQL | Control which REST APIs and GraphQL APIs are included in the published site |
| Theme Colours | Theme | Colour settings across categories including UI elements, validation states, HTTP methods, status codes, and knowledge map |
| SEO and Scripts | robots.txt, llms.txt, Custom Scripts | Search engine directives, LLM discovery information, and custom header/body script injection |
| Custom Icons | All icon pickers | Upload and manage custom SVG icons for use in menus, sidebar, footer, and marketing sections |
| PDF Typography | PDF Typography | Per-element font control for PDF output: base font family, size, line height, and colour, plus individual overrides for body text, each heading level (H1-H6), and code blocks |
Detailed Reference Pages
Configure your site title, subtitle, logo, brand colours, title bar appearance, sidebar panel colours, home page hero colours, and site URL for SEO.
Build a marketing-style home page with 8 section types including hero banners, feature grids, call-to-action buttons, and embedded diagrams. Reorder and configure each section visually.
Configure the top navigation menu bar with links to pages, external URLs, forms, and home. Each item supports optional icons from built-in icons from Lucide, Heroicons, Bootstrap and brand collections or custom uploaded SVGs.
Replace the default content tree sidebar with a marketing-style icon sidebar. Configure items that link to content directories, pages, external URLs, or forms with custom icons and colours.
Configure the site-wide footer with link groups, custom colours, and copyright text. Organise links into named groups with optional icons.
Build data collection forms with 9 control types for published sites. Configure form submissions, success and failure messages, validation, honeypot spam protection, and redirect URLs.
Configure a GDPR-compliant cookie consent banner for published sites. Set the banner text, accept button text, and link to your privacy policy page or external URL.
Control which REST APIs and GraphQL APIs are included in your published site. Toggle individual APIs on or off to publish only relevant API documentation.
Configure colour settings across categories: UI elements, validation states, content type badges, HTTP methods, status codes, and knowledge map visualisations.
Configure robots.txt for search engines, llms.txt for AI crawlers, and inject custom scripts into the header or body of your published site for analytics, fonts, or chat widgets.
Upload custom SVG icons for use in menus, sidebars, footers, and marketing home page sections. Icons are validated, sanitised for security, and available across all icon pickers.
Settings File Format
Publication settings are stored in a JSON file at the root of your Content Foundry publication: site.cf.settings.json for website publications or pdf.cf.settings.json for PDF publications. The file is edited visually through the settings editor, but can also be inspected as JSON.
Auto-Save and Validation
Publishing Targets Integration
Publishing targets override display settings (top bar, footer, home page type, sidebar type) per target. The base site settings define defaults, and each publishing target can override whether to show the top bar, footer, marketing home page, and marketing sidebar.