Settings

General settings

Statamic stores its settings into groups located in site/settings/[group].yaml. These various files map to pages in the CP under Configure > Settings.

The settings files are organized based on their general functions. For example, assets.yaml configures assets and image manipulation, caching.yaml for cache settings, system.yaml for general system settings, and so on.

Addon settings

Each addon can have their own settings file located in site/settings/addons/addon_name.yaml.

Addon settings can be overridden in your environment files. See below for more details.

Environment Specific Settings

Sometimes is beneficial to have different settings depending on where you are running the site. For instance, enabling debug mode when in development, but not in production. Or perhaps running some analytics javascript snippet only on production.

You can do this by overriding settings based on the environment you are serving the site.

Read about environments

Maintenance Mode

When your site is in maintenance mode, a Be Right Back message will be displayed for all requests. This could be useful to “disable” your site while you perform updates.

To enable it run the down command, and to disable it run the up command:

php please down   # enable maintenance mode. take your site "down"
php please up     # disable. bring your site back "up"

This feature is the same as Laravel’s. You may customize the view by adding a 503.html error template to your theme.

Last Updated February 22, 2017

Table of Contents
  1. General settings
  2. Addon settings
  3. Environment Specific Settings
  4. Maintenance Mode