Overview
Statamic can be configured to handle multiple "sites". A site is a way of localized version of your content - whether another language, region, or even company or brand (think Proctor & Gamble).
Each site can have different base URLs:
- subdomains:
example.comandfr.example.com - subdirectories:
example.comandexample.com/fr/ - different domains:
hello.comandbonjour.com
Converting from Single to Multiple Sites
The default single-site setup uses a folder structure optimized for hand editing, but when using a multi-site setup the folder structure is a bit more complex. If you already have a site with content, switching to a multi-site setup will require moving files and folders around.
Luckily for you, this conversion can be done automatically with the following command:
php please multisiteMore details on how to convert to a multi-site setup
Configuration
Let's look at a basic site configuration, and then we'll walk through each configuration option.
# config/statamic/sites.php return [ 'sites' => [ 'default' => [ 'name' => config('app.name'), 'locale' => 'en_US', 'url' => '/', ] ]];Sites
Every Statamic install needs at least one site, whether you are using multiple sites or not. Building zero sites is a bad way to build a website and clients will probably challenge any invoices.
Locale
Each site has a locale which is used to format region-specific data (like date strings).
URL
A URL is also required, which defines where statamic will serve and generate all URLs relative to.
Site URLs
As mentioned above, each site needs to define a url.
The default site url is /, which is portable and works fine in most typical sites. Statamic uses a little magic to work out what a full URL should be, based on the domain the site is running on.
It can be a good idea to change this to a fully qualified, absolute URL. This ensures that server/environment configurations or external quirks interfere with that "magic". Using an environment variable is an ideal solution here.
'sites' => [ 'en' => [ // ... 'url' => env('APP_URL') ], 'fr' => [ // ... 'url' => env('APP_URL').'fr/' ]]# productionAPP_URL=https://mysite.com/ # developmentAPP_URL=http://mysite.test/Text Direction
If your site or sites have different text directions, for example if you have an English and a Hebrew version, you can define the direction in the config and use it on your front-end.
'sites' => [ 'en' => [ 'name' => 'English', ], 'he' => [ 'name' => 'Hebrew', 'direction' => 'rtl', ]]<html dir="{{ site:direction }}">Statamic's direction is ltr by default. You only need to set direction when your site is rtl.
Additional Attributes
You may also add an array of arbitrary attributes to your site's config, which can later be accessed with the site variable .
'sites' => [ 'en' => [ 'name' => 'English', 'attributes' => [ 'theme' => 'standard', ] ],]<body class="theme-{{ site:attributes:theme }}">Nothing fancy happens here, the values are passed along "as is" to your templates. If you need them to be editable, or store more complex data, you could use Globals.
Views
Views can be organized into site directories.
If a requested view exists in a subdirectory with the same name as your site, it will load it instead. This allows you have site-specific views without any extra configuration.
# config/statamic/sites.php 'sites' => [ 'site_one' => [ /* ... */ ], 'site_two' => [ /* ... */ ],]resources/views/ site_one/ home.antlers.html home.antlers.html page.antlers.htmlFor example, given template: home, Statamic will load site_one/home because that view exists in the subdirectory. If you were to have template: page, it would load the one in the root directory because there's no site-specific variant.
This feature can be combined with the AMP feature. You can nest an amp view subdirectory inside a site subdirectory.
Renaming a Site
If you rename a site handle, you'll need to update a few folders and config settings along with it. Replace {old_handle} with the new handle in these locations:
Content Folders
-
content/collections/{old_handle}/ -
content/globals/{old_handle}/ -
content/trees/{old_handle}/
Collection Config YAML Files
# content/collections/{collection}.yamlsites:- {old_handle}- de- frTemplate Snippets
Here are a few common features you'll likely need to template while building a multi-site.
Site Switcher
This will loop through your sites and indicate the current site as the active one. Check out all the available variables inside the sites loop.
{{ sites }} <a class="{{ site:handle === handle ?= 'active' }}" href="{{ url }}"> {{ handle }} </a>{{ /sites }}Declaring the Page Language
Indicate the current language of the site by setting the lang attribute on your <html> tag (most likely in your layout view), or the container element around translated content if the page mixes and matches languages.
<html lang="{{ site:short_locale }}">
