# Rename the default configuration file

**URL:** <https://zola.discourse.group/t/rename-the-default-configuration-file/2880>\
**Category:** Feature requests\
**Created:** [November 22, 2025, 10:16am UTC](https://zola.discourse.group/t/rename-the-default-configuration-file/2880 "2025-11-22T10:16:35Z")\
**Posts on this page:** 5\
**Page:** 1

<div class="post-metadata">

**Author:** ![walpox](https://yyz2.discourse-cdn.com/free1/user_avatar/zola.discourse.group/walpox/32/1078_2.png) [@walpox](https://zola.discourse.group/u/walpox)\
**Post date:** [November 22, 2025, 10:16am UTC](https://zola.discourse.group/t/rename-the-default-configuration-file/2880/1 "2025-11-22T10:16:35Z")

</div>

The configuration file for Zola is named `config.toml`.

TOML files can be validated using JSON schemas through tools such as the [Even Better TOML](https://marketplace.visualstudio.com/items?itemName=tamasfe.even-better-toml#completion-and-validation-with-json-schema) extension in Visual Studio Code.

To facilitate creating a schema for Zola configuration and upload it to a public registry such as the [JSON Schema Store](https://www.schemastore.org), a distinguishable filename should be used for this file.

Thus, I propose changing the configuration filename for future releases of Zola. My suggestions are `zola.config.toml` or `zola.toml`.

---

<div class="post-metadata">

**Author:** ![keats](https://avatars.discourse-cdn.com/v4/letter/k/34f0e0/32.png) [@keats](https://zola.discourse.group/u/keats)\
**Post date:** [November 22, 2025, 9:47pm UTC](https://zola.discourse.group/t/rename-the-default-configuration-file/2880/2 "2025-11-22T21:47:42Z")

</div>

See [Adding schema file for zola config file](https://zola.discourse.group/t/adding-schema-file-for-zola-config-file/2875) as well

I think we can support both config.toml and zola.toml

---

<div class="post-metadata">

**Author:** ![mrec](https://yyz2.discourse-cdn.com/free1/user_avatar/zola.discourse.group/mrec/32/1485_2.png) [@mrec](https://zola.discourse.group/u/mrec)\
**Post date:** [November 23, 2025, 10:49am UTC](https://zola.discourse.group/t/rename-the-default-configuration-file/2880/3 "2025-11-23T10:49:31Z")

</div>

@keats worth reopening [Config file name conflict as `config.toml` is too generic · Issue #2919 · getzola/zola · GitHub](https://github.com/getzola/zola/issues/2919) if you’re considering this?

---

<div class="post-metadata">

**Author:** ![keats](https://avatars.discourse-cdn.com/v4/letter/k/34f0e0/32.png) [@keats](https://zola.discourse.group/u/keats)\
**Post date:** [November 24, 2025, 9:23am UTC](https://zola.discourse.group/t/rename-the-default-configuration-file/2880/4 "2025-11-24T09:23:37Z")

</div>

as long as both are supported, someone can create a PR

---

<div class="post-metadata">

**Author:** ![walpox](https://yyz2.discourse-cdn.com/free1/user_avatar/zola.discourse.group/walpox/32/1078_2.png) [@walpox](https://zola.discourse.group/u/walpox)\
**Post date:** [January 23, 2026, 9:40pm UTC](https://zola.discourse.group/t/rename-the-default-configuration-file/2880/5 "2026-01-23T21:40:19Z")

</div>

This feature has been implemented. Thank you.