Hi! I am a little confused by the new configuration file netlify.yaml. I imagined it would be a drop-in replacement for netlify.toml, but without the toml file I get the following error: No netlify.toml found. This is needed to configure the function settings. For more info: https://github.com/ne…

We haven’t quite finished implementing the json and yml support, but these are the docs: File-based configuration | Netlify Docs . It is definitely not implemented in the private beta for build plugins yet, so you’ll need to stick with toml as the docs advise.

No longer see YAML mentioning in docs. Is it tied to Build Plugins release?

That’s a real shame! Is there any intention to open it up in the future?

None that I’m aware of. Mind explaining your preference in a bit more detail so I can open a feature request for us around how you’d use it specifically / what the current system blocks you on? “I hate toml” is less useful than something like: “yaml enables inheritance and better indentation/quoti…

The preference to choose YAML is due to the fact that YAML is many more times popular than TOML See https://trends.google.com/trends/explore?geo=US&q=yaml,toml This makes a smaller learning curve for new developers in the team who come from various other tools into Netlify. From AWS to Ansible its …

Thanks, appreciate you taking the time to clarify! I think we’re probably going to stick with toml for the time being, but our product team will take this into account as they develop new features.

You hit the nail on the head with indentation. I don’t hate TOML when it’s a simple definition. But I’ve had too many times when TOML’s lack of semantic indentation helps hide nested data all over the place. Meaning it becomes much harder to parse mentally and leads to weird gotchas. Sure you can ha…

Netlify.toml vs netlify.yaml

Support

fool May 4, 2020, 7:01pm 4

No, we have decided to stick with toml only.

Topic		Replies	Views
Allow Netlify config in JSON or YAML instead of only TOML Features settings-config	3	857	April 5, 2022
A case for netlify.json Features settings-config , building , deployment , feature-request	2	199	December 7, 2024
Netlify CLI toml Support netlify-cli	7	1670	January 21, 2020
Netlify.toml - what functionality would you like to see? Features	2	2051	May 20, 2019
New to Netlify...trying to figure out how to create a netlify.toml file and where to put it Support deployment , netlify-newbie	3	549	July 8, 2020

Netlify.toml vs netlify.yaml

Related topics