Configuration

Gozzi uses TOML files for configuration, offering a clean and readable format for site settings.

Configuration Guide

Site Configuration

• Site Settings - Core settings, URLs, and global defaults
• Environment Config - Development, staging, and production setups
• Extended Configuration - Custom data structures and extra fields

Content Configuration

• Front Matter - Page and section front matter options
• Section Configuration - Section-specific settings and list pages
• Page Configuration - Individual page settings

Advanced Topics

• Configuration Inheritance - How configuration cascades
• Troubleshooting - Common issues and solutions

Quick Example

# config.toml - Minimal blog configuration
base_url = "https://myblog.com"
title = "My Blog"
description = "Thoughts and tutorials"
language = "en"

[extra]
name = "Author Name"
bio = "Writer and developer"

Configuration Files

The main configuration file is config.toml by default, but you can specify alternatives:

# Use default config.toml
gozzi build

# Use custom config file
gozzi serve --config config.dev.toml
gozzi build --config config.prod.toml

---

Start with: Site Settings to configure your basic site information.