system.schema.yml

Same filename and directory in other branches
  1. 11.x core/modules/system/config/schema/system.schema.yml
  2. 10 core/modules/system/config/schema/system.schema.yml
  3. 9 core/modules/system/config/schema/system.schema.yml
  4. 8.9.x core/modules/system/config/schema/system.schema.yml
core/modules/system/config/schema/system.schema.yml
2 string references to 'system.schema'
UpdateHookRegistry::__construct in core/lib/Drupal/Core/Update/UpdateHookRegistry.php
Constructs a new UpdateHookRegistry.
UpdateHookRegistryTest::setUp in core/tests/Drupal/Tests/Core/Update/UpdateHookRegistryTest.php

File

core/modules/system/config/schema/system.schema.yml

View source
  1. # Schema for the configuration files of the System module.
  2. system.site:
  3. type: config_object
  4. label: 'Site information'
  5. mapping:
  6. uuid:
  7. type: uuid
  8. label: 'Site UUID'
  9. constraints:
  10. Uuid: []
  11. NotNull: []
  12. name:
  13. type: label
  14. label: 'Site name'
  15. mail:
  16. type: email
  17. label: 'Email address'
  18. slogan:
  19. type: label
  20. label: 'Slogan'
  21. page:
  22. type: mapping
  23. label: 'Pages'
  24. mapping:
  25. 403:
  26. type: path
  27. label: 'Default 403 (access denied) page'
  28. 404:
  29. type: path
  30. label: 'Default 404 (not found) page'
  31. front:
  32. type: path
  33. label: 'Default front page'
  34. admin_compact_mode:
  35. type: boolean
  36. label: 'Compact mode'
  37. weight_select_max:
  38. type: integer
  39. label: 'Weight element maximum value'
  40. default_langcode:
  41. type: langcode
  42. label: 'Site default language code'
  43. mail_notification:
  44. type: string
  45. label: 'Notification email address'
  46. system.maintenance:
  47. type: config_object
  48. label: 'Maintenance mode'
  49. constraints:
  50. FullyValidatable: ~
  51. mapping:
  52. message:
  53. type: text
  54. label: 'Message to display when in maintenance mode'
  55. system.cron:
  56. type: config_object
  57. label: 'Cron settings'
  58. constraints:
  59. FullyValidatable: ~
  60. mapping:
  61. threshold:
  62. type: mapping
  63. label: 'Thresholds'
  64. mapping:
  65. requirements_warning:
  66. type: integer
  67. label: 'Requirements warning period'
  68. constraints:
  69. # @see \Drupal\system\Hook\SystemRequirementsHooks
  70. Range:
  71. min: 60
  72. requirements_error:
  73. type: integer
  74. label: 'Requirements error period'
  75. constraints:
  76. # @see \Drupal\system\Hook\SystemRequirementsHooks
  77. Range:
  78. min: 300
  79. logging:
  80. type: boolean
  81. label: 'Detailed cron logging'
  82. system.date:
  83. type: config_object
  84. label: 'Date settings'
  85. constraints:
  86. FullyValidatable: ~
  87. mapping:
  88. first_day:
  89. type: integer
  90. label: 'First day of week'
  91. constraints:
  92. Range:
  93. # @see \Drupal\system\Form\RegionalForm::buildForm()
  94. min: 0
  95. max: 6
  96. country:
  97. type: mapping
  98. label: 'Country'
  99. mapping:
  100. default:
  101. nullable: true
  102. type: string
  103. label: 'Default country'
  104. constraints:
  105. # @see \Drupal\system\Form\RegionalForm::buildForm()
  106. CountryCode: []
  107. timezone:
  108. type: mapping
  109. label: 'Time zone settings'
  110. mapping:
  111. default:
  112. type: string
  113. label: 'Default time zone'
  114. nullable: true
  115. constraints:
  116. # @see \Drupal\system\Form\RegionalForm::buildForm()
  117. Choice:
  118. callback: 'DateTimeZone::listIdentifiers'
  119. user:
  120. type: mapping
  121. label: 'User'
  122. mapping:
  123. configurable:
  124. type: boolean
  125. label: 'Users may set their own time zone'
  126. default:
  127. type: integer
  128. label: 'Time zone for new users'
  129. constraints:
  130. # Time zone for new users can have one of the following values:
  131. # - UserInterface::TIMEZONE_DEFAULT
  132. # - UserInterface::TIMEZONE_EMPTY
  133. # - UserInterface::TIMEZONE_SELECT
  134. # @see \Drupal\user\UserInterface::TIMEZONE_*
  135. # @todo Update this to use enum in https://www.drupal.org/project/drupal/issues/3402178
  136. Choice:
  137. choices: [0, 1, 2]
  138. warn:
  139. type: boolean
  140. label: 'Remind users at login if their time zone is not set'
  141. system.diff:
  142. type: config_object
  143. label: 'Diff settings'
  144. constraints:
  145. FullyValidatable: ~
  146. mapping:
  147. context:
  148. type: mapping
  149. label: 'Context'
  150. mapping:
  151. lines_leading:
  152. type: integer
  153. label: 'Number of leading lines in a diff'
  154. constraints:
  155. # @see \Drupal\Component\Diff\DiffFormatter
  156. PositiveOrZero: ~
  157. lines_trailing:
  158. type: integer
  159. label: 'Number of trailing lines in a diff'
  160. constraints:
  161. # @see \Drupal\Component\Diff\DiffFormatter
  162. PositiveOrZero: ~
  163. system.logging:
  164. type: config_object
  165. label: 'Logging settings'
  166. constraints:
  167. FullyValidatable: ~
  168. mapping:
  169. error_level:
  170. type: string
  171. label: 'Error messages to display'
  172. # @see core/includes/bootstrap.inc
  173. # @todo Update this to use enum in https://www.drupal.org/project/drupal/issues/2951046
  174. constraints:
  175. Choice:
  176. choices:
  177. - 'hide'
  178. - 'some'
  179. - 'all'
  180. - 'verbose'
  181. system.performance:
  182. type: config_object
  183. label: 'Performance settings'
  184. mapping:
  185. cache:
  186. type: mapping
  187. label: 'Caching'
  188. mapping:
  189. page:
  190. type: mapping
  191. label: 'Page caching'
  192. mapping:
  193. max_age:
  194. type: integer
  195. label: 'Max age'
  196. css:
  197. type: mapping
  198. label: 'CSS performance settings'
  199. mapping:
  200. preprocess:
  201. type: boolean
  202. label: 'Aggregate CSS files'
  203. gzip:
  204. # @see Drupal\Core\Asset\AssetDumper::dumpToUri()
  205. type: boolean
  206. label: 'Compress CSS files'
  207. deprecated: "The 'gzip' config schema is deprecated in drupal:11.4.0 and is removed from drupal:12.0.0. Use the 'compress' config schema instead. See https://www.drupal.org/node/3526344."
  208. compress:
  209. type: boolean
  210. label: 'Compress CSS files'
  211. fast_404:
  212. type: mapping
  213. label: 'Fast 404 settings'
  214. mapping:
  215. enabled:
  216. type: boolean
  217. label: 'Fast 404 enabled'
  218. paths:
  219. type: string
  220. label: 'Regular expression to match'
  221. exclude_paths:
  222. type: string
  223. label: 'Regular expression to not match'
  224. html:
  225. type: string
  226. label: 'Fast 404 page html'
  227. js:
  228. type: mapping
  229. label: 'JavaScript performance settings'
  230. mapping:
  231. preprocess:
  232. type: boolean
  233. label: 'JavaScript preprocess'
  234. gzip:
  235. # @see Drupal\Core\Asset\AssetDumper::dumpToUri()
  236. type: boolean
  237. label: 'Compress JavaScript files'
  238. deprecated: "The 'gzip' config schema is deprecated in drupal:11.4.0 and is removed from drupal:12.0.0. Use the 'compress' config schema instead. See https://www.drupal.org/node/3526344."
  239. compress:
  240. type: boolean
  241. label: 'Compress JavaScript files.'
  242. system.theme:
  243. type: config_object
  244. label: 'Theme settings'
  245. mapping:
  246. admin:
  247. type: string
  248. label: 'Administration theme'
  249. default:
  250. type: string
  251. label: 'Default theme'
  252. system.menu.*:
  253. type: config_entity
  254. label: 'Menu'
  255. mapping:
  256. id:
  257. type: machine_name
  258. label: 'ID'
  259. # Menu IDs are specifically limited to 32 characters, and allow dashes but not
  260. # underscores.
  261. # @see \Drupal\menu_ui\MenuForm::form()
  262. constraints:
  263. Regex:
  264. pattern: '/^[a-z0-9-]+$/'
  265. message: "The %value machine name is not valid."
  266. Length:
  267. max: 32
  268. label:
  269. type: required_label
  270. label: 'Label'
  271. description:
  272. type: label
  273. label: 'Menu description'
  274. # @see \Drupal\menu_ui\MenuForm::form()
  275. nullable: true
  276. constraints:
  277. Length:
  278. max: 512
  279. locked:
  280. type: boolean
  281. label: 'Locked'
  282. constraints:
  283. FullyValidatable: ~
  284. system.action.*:
  285. type: config_entity
  286. label: 'System action'
  287. constraints:
  288. FullyValidatable: ~
  289. mapping:
  290. id:
  291. type: machine_name
  292. label: 'ID'
  293. constraints:
  294. # Action IDs also allow periods.
  295. # @see user_user_role_insert()
  296. Regex:
  297. pattern: '/^[a-z0-9_\.]+$/'
  298. message: "The %value machine name is not valid."
  299. label:
  300. type: required_label
  301. label: 'Label'
  302. type:
  303. type: string
  304. label: 'Type'
  305. # Action can be specified without type.
  306. # @see \Drupal\action_test\Plugin\Action\NoType
  307. nullable: true
  308. constraints:
  309. NotBlank:
  310. allowNull: true
  311. plugin:
  312. type: string
  313. label: 'Plugin'
  314. constraints:
  315. PluginExists:
  316. manager: plugin.manager.action
  317. interface: 'Drupal\Core\Action\ActionInterface'
  318. configuration:
  319. type: action.configuration.[%parent.plugin]
  320. system.file:
  321. type: config_object
  322. label: 'File system'
  323. constraints:
  324. FullyValidatable: ~
  325. mapping:
  326. allow_insecure_uploads:
  327. type: boolean
  328. label: 'Allow insecure uploads'
  329. default_scheme:
  330. type: string
  331. label: 'Default download method'
  332. constraints:
  333. ClassResolver:
  334. classOrService: 'stream_wrapper_manager'
  335. method: 'isValidScheme'
  336. temporary_maximum_age:
  337. type: integer
  338. label: 'Maximum age for temporary files'
  339. constraints:
  340. PositiveOrZero: ~
  341. system.image:
  342. type: config_object
  343. label: 'Image settings'
  344. constraints:
  345. FullyValidatable: ~
  346. mapping:
  347. toolkit:
  348. type: string
  349. label: 'Toolkit'
  350. constraints:
  351. PluginExists:
  352. manager: 'image.toolkit.manager'
  353. interface: '\Drupal\Core\ImageToolkit\ImageToolkitInterface'
  354. system.image.gd:
  355. type: config_object
  356. label: 'Image settings'
  357. constraints:
  358. FullyValidatable: ~
  359. mapping:
  360. jpeg_quality:
  361. type: integer
  362. label: 'JPEG quality'
  363. constraints:
  364. # @see \Drupal\system\Plugin\ImageToolkit\GDToolkit::buildConfigurationForm()
  365. Range:
  366. min: 0
  367. max: 100
  368. system.mail:
  369. type: config_object
  370. label: 'Mail system'
  371. constraints:
  372. FullyValidatable: ~
  373. mapping:
  374. interface:
  375. type: sequence
  376. label: 'Interfaces'
  377. sequence:
  378. type: string
  379. label: 'Interface'
  380. constraints:
  381. PluginExists:
  382. manager: plugin.manager.mail
  383. interface: 'Drupal\Core\Mail\MailInterface'
  384. mailer_dsn:
  385. type: mailer_dsn
  386. label: 'Symfony mailer transport DSN'
  387. system.theme.global:
  388. type: theme_settings
  389. label: 'Theme global settings'
  390. system.advisories:
  391. type: config_object
  392. label: 'Security advisory settings'
  393. constraints:
  394. FullyValidatable: ~
  395. mapping:
  396. enabled:
  397. type: boolean
  398. label: 'Display critical security advisories'
  399. interval_hours:
  400. type: integer
  401. label: 'How often to check for security advisories, in hours'
  402. # Minimum can be set to 0 as it just means the advisories will be retrieved on every call.
  403. # @see \Drupal\system\SecurityAdvisories\SecurityAdvisoriesFetcher::getSecurityAdvisories
  404. constraints:
  405. PositiveOrZero: ~
  406. block.settings.system_branding_block:
  407. type: block_settings
  408. label: 'Branding block'
  409. constraints:
  410. FullyValidatable: ~
  411. mapping:
  412. use_site_logo:
  413. type: boolean
  414. label: 'Use site logo'
  415. use_site_name:
  416. type: boolean
  417. label: 'Use site name'
  418. use_site_slogan:
  419. type: boolean
  420. label: 'Use site slogan'
  421. block.settings.system_menu_block:*:
  422. type: block_settings
  423. label: 'Menu block'
  424. constraints:
  425. FullyValidatable: ~
  426. IgnoreActiveTrail: ~
  427. mapping:
  428. level:
  429. type: integer
  430. label: 'Starting level'
  431. constraints:
  432. MenuLinkDepth:
  433. min: 0
  434. depth:
  435. type: integer
  436. label: 'Maximum number of levels'
  437. nullable: true
  438. constraints:
  439. MenuLinkDepth:
  440. baseLevel: '[%parent.level]'
  441. min: 1
  442. expand_all_items:
  443. type: boolean
  444. label: 'Expand all items'
  445. ignore_active_trail:
  446. type: boolean
  447. label: 'Ignore active trail'
  448. requiredKey: false
  449. block.settings.local_tasks_block:
  450. type: block_settings
  451. label: 'Tabs block'
  452. constraints:
  453. FullyValidatable: ~
  454. mapping:
  455. primary:
  456. type: boolean
  457. label: 'Whether primary tabs are shown'
  458. secondary:
  459. type: boolean
  460. label: 'Whether secondary tabs are shown'
  461. condition.plugin.request_path:
  462. type: condition.plugin
  463. mapping:
  464. pages:
  465. type: string
  466. condition.plugin.response_status:
  467. type: condition.plugin
  468. mapping:
  469. status_codes:
  470. type: sequence
  471. sequence:
  472. type: integer
  473. system.feature_flags:
  474. type: config_object
  475. label: 'System Feature Flags'
  476. constraints:
  477. FullyValidatable: ~
  478. mapping:
  479. linkset_endpoint:
  480. type: boolean
  481. label: 'Enable the menu linkset endpoint'
  482. condition.plugin.current_theme:
  483. type: condition.plugin
  484. mapping:
  485. theme:
  486. type: string
  487. label: Theme

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.