General Site Settings
Make your install yours.
All of Statamic’s general site settings are found at the top of your site’s _config/settings.yaml file.
These settings control how Statamic acts site-wide.
Settings
Listed in the order in which you’ll find them in your settings file.
_license_key
This is how you’ll apply your license to Statamic.
_language
This sets which translation to use for your Control Panel.
_site_root
This is the path to where Statamic is installed relative to your website’s document root.
_site_name
This is the name of your site. Although nothing specifically relies on this setting, it’s often used in your layouts or templates.
_content_root
The path containing your content files.
_site_url
This is the full URL to your Statamic install. This is used by Statamic create to permalinks to your content.
_theme
This tells Statamic which theme folder to use for displaying your content.
_entry_timestamps
You can choose if you want to use dates and times for entry filenames, or just dates.
_date_format
This sets the default date format for date tags throughout your site.
_time_format
This sets the default time format for date tags throughout your site.
_timezone
This tells PHP and Statamic which timezone your site is located in. Must be one of the values from PHP’s timezone lists.
_taxonomy
This is a list of the fields that Statamic should consider to be taxonomies.
_taxonomy_slugify
When set to true, this will convert spaces in your taxonomy values to hyphens.
_taxonomy_case_sensitive
This will determine if capitalization matters for your taxonomy values.
_taxonomy_force_lowercase
This will force all taxonomy values to be lowercase when displayed.
_content_type
This is how your content will be written (Markdown, Textile, etc.).
_enable_smartypants
This will automatically convert your straight quotes (' and ") into curly quotes (’ and ”)
_allow_php
This will let you write PHP into your templates.
It’s best to leave this set to false unless you absolutely need it.
_transform_destination
The default location for transformed images. Defaults to assets/img/resized.
_transform_quality
The default quality (as a percentage) for transformed images. Defaults to 100.
_yaml_mode
This can be either strict, transitional, loose, or quick (added in v1.9) based on which YAML spec to parse with.
_markdown_parser
Added in v1.7.9, you can choose which Markdown parser to use, either standard (default) or parsedown.
_parse_order
This determines which order Statamic parses content and tags.
_fix_out_of_range_pagination
This will automatically fix pagination values that are too high or too low.
_email_sender
The address from which emails are sent.
_email_handler
Specify which email handler to use to send emails.
By default (leave blank or set to false) Statamic will use native PHP Mail, but also integrates with the following services:
_email_handler_key
If you’re using an email service (which we highly recommend!) your API key goes here.
Note: Mailgun’s API key is in the format {$domain}:{$API-Key}. An example of that would be email_handler_key: "bjrnskov.mailgun.org:my-secret-api-key"