Netlify.toml vs netlify.yaml


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:

When both of them are present I have

 failed during stage 'Reading and parsing configuration files': Multiple potential Netlify configuration files in "/opt/build/repo": netlify.toml, netlify.yaml

I would like to access the “plugins” functionality and I am not certain if it exists on the toml version of the configuration as this doesn’t seem to trigger anything:

  type = "./.netlify/plugins/xxx"

What would you recommend as the best course of action?

We haven’t quite finished implementing the json and yml support, but these are the 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?

No, we have decided to stick with toml only.

1 Like

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/quoting for automation needs and works with other tools” :slight_smile: