copier/docs/settings.md

Settings

Copier settings are stored in <CONFIG_ROOT>/settings.yml where <CONFIG_ROOT> is the standard configuration directory for your platform:

• $XDG_CONFIG_HOME/copier (~/.config/copier in most cases) on Linux as defined by XDG Base Directory Specifications
• ~/Library/Application Support/copier on macOS as defined by Apple File System Basics
• %USERPROFILE%\AppData\Local\copier on Windows as defined in Known folders

This location can be overridden by setting the COPIER_SETTINGS_PATH environment variable.

User defaults

Users may define some reusable default variables in the defaults section of the configuration file.

defaults:
    user_name: "John Doe"
    user_email: john.doe@acme.com

This user data will replace the default value of fields of the same name.

Well-known variables

To ensure templates efficiently reuse user-defined variables, we invite template authors to use the following well-known variables:

Variable name	Type	Description
user_name	str	User's full name
user_email	str	User's email address
github_user	str	User's GitHub username
gitlab_user	str	User's GitLab username