netlify-config

Configure Netlify deployments with netlify.toml syntax and examples.

32|7|Updated Nov 26, 2025
One-click install
npx skills add https://github.com/netlify/context-and-tools --skill netlify-config-netlify
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: netlify-config
Source: https://github.com/netlify/context-and-tools/tree/main/codex/skills/netlify-config
Command: npx skills add https://github.com/netlify/context-and-tools --skill netlify-config-netlify

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Netlify-config provides a reference and guidance for configuring netlify.toml to control builds, redirects, headers, deploy contexts, functions, and edge functions across projects.

Core Features & Use Cases

  • Centralizes Netlify configuration with netlify.toml syntax and practical examples for common scenarios.
  • Supports defining build settings, redirects (including splats and conditions), headers, environment variables, deploy contexts, and function/edge function configurations.
  • Use cases include setting a base directory, customizing the publish directory, and enabling per-branch contexts for previews.

Quick Start

Create a netlify.toml at the repository root and add a simple [build] section, a [redirects] block, and a [headers] block to get started.

Frequently Asked Questions about netlify-config

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I configure redirects and headers in netlify.toml?

To configure redirects and headers in netlify.toml, add a [redirects] block and a [headers] block at the repository root. This centralizes routing rules and HTTP headers, supporting splats and conditions for precise URL matching across deployment contexts.

What is the best way to set per-environment build settings for Netlify deployments?

The best way to set per-environment build settings is using netlify.toml to define deploy contexts. You can customize the publish directory and set specific environment variables for branch previews and production deployments within a single configuration file.

Can I configure edge functions and serverless functions using netlify.toml?

Yes, you can configure edge functions and serverless functions using netlify.toml. The configuration file provides syntax and best practices for defining function settings alongside your build rules, redirects, and headers within the same project.

Does Netlify configuration support splats and routing conditions?

Netlify configuration supports splats and routing conditions within the [redirects] block of netlify.toml. This allows you to define advanced URL matching rules and wildcard path redirects for controlling traffic across different deploy contexts.

When do I need a netlify.toml file for my project?

You need a netlify.toml file when centralizing build settings, redirects, headers, and deploy contexts across a project. It is essential for teams requiring consistent configuration for base directories, environment variables, and function deployments within the repository.