Skip to content

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