Site settings
Every setting a site can carry, by setting plugin. The key is what drush sites:info, settings.php and the agent tools use.
| Column | Meaning |
|---|---|
| Env | The value can differ per environment. |
| Transl. | The value can differ per language. |
| Always available | A site type cannot switch the setting off. |
| Site only | The site type has no default for it; each site sets its own. |
| Sensitive | Output (dashboard, Drush, logs) shows it redacted. |
Identity¶
Plugin sites, Sites (sites). The site's name, hostname and aliases, structure (main site or sub-site), hreflang region and canonical link mode.
| Key | Label | Default | Env | Transl. | Notes |
|---|---|---|---|---|---|
id |
Site ID | Always available | |||
title |
Title | Always available | |||
site_type |
Structure | default |
Always available | ||
main_site_id |
Main site | Site only | |||
inherit_parent_settings |
Inherit settings from the main site | false |
Site only | ||
main_site_participation |
Run by the main site's people | false |
Site only | ||
hostname |
Hostname | yes | Always available | ||
hostname_aliases |
Hostname aliases | yes | Always available | ||
region_key |
Region | ||||
weight |
Weight | 100 |
Site only | ||
canonical_tag |
Canonical link | canonical_site |
Overridable fields¶
Plugin content_overrides, Sites content overrides (sites_content_overrides). The fields of shared content this site may override.
| Key | Label | Default | Env | Transl. | Notes |
|---|---|---|---|---|---|
content_overrides_field_names__{entity_type} |
Fields a site may override |
Site information¶
Plugin system_site, Sites (sites). Site name, email address, slogan, front page and error pages, edited on the Site information page.
| Key | Label | Default | Env | Transl. | Notes |
|---|---|---|---|---|---|
site_name |
Site name | yes | yes | Always available; Config system.site:name |
|
site_slogan |
Slogan | yes | yes | Config system.site:slogan |
|
site_mail |
Email address | yes | Config system.site:mail |
||
site_frontpage |
Default front page | / |
yes | Config system.site:page.front |
|
site_403 |
Default 403 (access denied) page | yes | Config system.site:page.403 |
||
site_404 |
Default 404 (not found) page | yes | Config system.site:page.404 |
Appearance¶
Plugin appearance, Sites (sites). Theme, admin theme, thumbnail, logo and favicon, edited on the Appearance page.
| Key | Label | Default | Env | Transl. | Notes |
|---|---|---|---|---|---|
theme |
Theme | olivero |
yes | Config system.theme:default |
|
admin_theme |
Admin theme | gin |
yes | Config system.theme:admin |
|
thumbnail |
Thumbnail | ||||
logo_path |
Logo | ||||
favicon_path |
Favicon |
Assignable content¶
Plugin content, Sites (sites). Which content can be assigned to the site, and how many sites a content entity may belong to.
| Key | Label | Default | Env | Transl. | Notes |
|---|---|---|---|---|---|
content:{entity_type}:{bundle} |
Whether content of a type may belong to the site | -1 |
yes |
Auto-assigned content¶
Plugin content_defaults, Sites (sites). Which new content is assigned to the site by default.
| Key | Label | Default | Env | Transl. | Notes |
|---|---|---|---|---|---|
default_content_types |
Default content types | ||||
canonical_by_weight |
Canonical site by weight | false |
Site filtering¶
Plugin site_filtering, Sites (sites). Whether listings and entity references show only the content of this site.
| Key | Label | Default | Env | Transl. | Notes |
|---|---|---|---|---|---|
filter_views |
Filter listings by the active site | false |
|||
filter_references |
Filter references by the active site | false |
Per-site menus¶
Plugin menus, Sites menu (sites_menu). Which menus this site gets its own version of.
| Key | Label | Default | Env | Transl. | Notes |
|---|---|---|---|---|---|
per_site_menu:{menu} |
Whether the site has its own links in a menu | false |
Assignable roles¶
Plugin roles, Sites (sites). Which roles can be assigned to users within the site.
| Key | Label | Default | Env | Transl. | Notes |
|---|---|---|---|---|---|
per_site_role:{role} |
Whether the role can be assigned on the site | false |
Languages¶
Plugin language, Sites language (sites_language). The languages this site speaks and its default language.
| Key | Label | Default | Env | Transl. | Notes |
|---|---|---|---|---|---|
languages |
Enabled languages | {"en":true,"fr":true,"de":true} |
|||
default_language |
Default language | en |
Path prefix¶
Plugin path_prefix, Sites path prefix (sites_path_prefix). The path prefix that addresses a sub-site under its main site's hostname.
| Key | Label | Default | Env | Transl. | Notes |
|---|---|---|---|---|---|
prefix |
Path prefix | Site only |
Language detection¶
Plugin language_negotiation, Sites language (sites_language). Which methods detect the language, in what order, and their settings.
| Key | Label | Default | Env | Transl. | Notes |
|---|---|---|---|---|---|
detection |
Detection methods | Config language.types:configurable,negotiation |
|||
url_source |
URL language source | ||||
url_prefixes |
URL path prefixes | Config language.negotiation:url.prefixes |
|||
url_domains |
URL language domains | yes | |||
session_parameter |
Session parameter | Config language.negotiation:session.parameter |
|||
selected_langcode |
Selected language | Config language.negotiation:selected_langcode |
Cloning rules¶
Plugin cloning, Sites clone (sites_clone). What a clone of this site is given: a method per kind of content, and the links of its menus.
| Key | Label | Default | Env | Transl. | Notes |
|---|---|---|---|---|---|
clone_menu_links |
Copy menu links | true |
|||
cloning:{entity_type}:{bundle} |
Clone method for content of a type | ignore_content |
Password protection¶
Plugin sites_shield, Sites Shield (sites_shield). A user name and password visitors enter before the site shows any page.
| Key | Label | Default | Env | Transl. | Notes |
|---|---|---|---|---|---|
sites_shield |
User name and password | {"user":"","pass":""} |
yes | Sensitive |
robots.txt¶
Plugin sites_robotstxt, Sites RobotsTxt (sites_robotstxt). Gives a site its own robots.txt.
| Key | Label | Default | Env | Transl. | Notes |
|---|---|---|---|---|---|
robotstxt |
robots.txt content | yes | Config robotstxt.settings:content |
Analytics¶
Plugin sites_analytics, Sites analytics (sites_analytics). The site's own Matomo and Google Tag ids, or tracking switched off.
| Key | Label | Default | Env | Transl. | Notes |
|---|---|---|---|---|---|
disable_tracking |
Disable tracking | false |
yes | ||
matomo_site_id |
Matomo site ID | yes | |||
matomo_url |
Matomo URL | yes | Always available | ||
google_tag_container |
Google Tag container | sites_analytics |
yes | Always available | |
ga4_measurement_id |
Google Analytics 4 measurement ID | yes | |||
gtm_container_id |
Google Tag Manager container ID | yes |
Sitemap¶
Plugin simple_sitemap, Sites Simple XML Sitemap (sites_simple_sitemap). Which content the site's sitemap lists, with priority and change frequency.
| Key | Label | Default | Env | Transl. | Notes |
|---|---|---|---|---|---|
simple_sitemap:bundle_settings:{variant}:{entity_type}:{bundle} |
Sitemap settings of a content type | {"index":false,"priority":0.5,"changefreq":"","include_images":false} |
Config simple_sitemap.bundle_settings.sites__site_id.node.article |