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
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 5,385+ built-in icons 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 100+ colour settings across 6 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.