> For the complete documentation index, see [llms.txt](https://swiftteam.gitbook.io/wiki/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://swiftteam.gitbook.io/wiki/swiftutils/configuration/configuration-file.md).

# Configuration File

Configure SwiftUtils correctly to get the most out of it!

{% hint style="info" %}
Access the default configuration [here](#id-2.-default-configuration-file).
{% endhint %}

***

## 1. How to configure SwiftUtils?

Please leave this value unchanged, as it is used by SwiftUtils to check that the configuration file is up to date.

```yaml
config-version: "1.0"
```

Here you can enable or disable modules. To do this, save your configuration file, then run `/su reload` command.

```yaml
modules:
  announcementMessages: true
```

Here you can change the permissions required to access various SwiftUtils features. To update permissions, save your configuration file, then run `/su reload` command.

```yaml
permissions:

  commands:
    swiftutils: swiftutils.command.swiftutils
```

***

## 2. Default configuration file:

Here you'll find the configuration file generated by default by SwiftUtils.

{% code fullWidth="false" %}

```yaml
############################################################
# +------------------------------------------------------+ #
# |                     Informations                     | #
# +------------------------------------------------------+ #
############################################################

# This is the configuration file for SwiftUtils.

# If you need help with the configuration of the plugin,
# you can join our discord server at: https://discord.gg/fSzK79TAYf

# For more information about how to configure SwiftUtils, check our Wiki at: https://swiftteam.gitbook.io/swiftutils

############################################################
# +------------------------------------------------------+ #
# |                    Main Settings                     | #
# +------------------------------------------------------+ #
############################################################

# Please do not change this value as it may cause the file to be reset.
# Default: 1.0
config-version: "1.0"

############################################################
# +------------------------------------------------------+ #
# |                       Modules                        | #
# +------------------------------------------------------+ #
############################################################

# In this section, set true to enable the module, and set false to disable it.
# More detailed information about each module is available here: https://swiftteam.gitbook.io/swiftutils/modules
modules:
  announcementMessages: true

############################################################
# +------------------------------------------------------+ #
# |                     Permissions                      | #
# +------------------------------------------------------+ #
############################################################

permissions:

  # Here you can change the permissions for the different commands.
  # Check default permissions here: https://swiftteam.gitbook.io/swiftutils/permissions
  commands:
    swiftutils: swiftutils.command.swiftutils
```

{% endcode %}