system.schema.yml

Same filename and directory in other branches
  1. 10 core/modules/system/config/schema/system.schema.yml
  2. 9 core/modules/system/config/schema/system.schema.yml
  3. 8.9.x core/modules/system/config/schema/system.schema.yml
  4. main 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. path:
  337. type: mapping
  338. label: 'Path settings'
  339. deprecated: "The 'path' config schema is deprecated in drupal:11.2.0 and will be removed from drupal 12.0.0. Use 'file_temp_path' key in settings.php instead. See https://www.drupal.org/node/3039255."
  340. temporary_maximum_age:
  341. type: integer
  342. label: 'Maximum age for temporary files'
  343. constraints:
  344. PositiveOrZero: ~
  345. system.image:
  346. type: config_object
  347. label: 'Image settings'
  348. constraints:
  349. FullyValidatable: ~
  350. mapping:
  351. toolkit:
  352. type: string
  353. label: 'Toolkit'
  354. constraints:
  355. PluginExists:
  356. manager: 'image.toolkit.manager'
  357. interface: '\Drupal\Core\ImageToolkit\ImageToolkitInterface'
  358. system.image.gd:
  359. type: config_object
  360. label: 'Image settings'
  361. constraints:
  362. FullyValidatable: ~
  363. mapping:
  364. jpeg_quality:
  365. type: integer
  366. label: 'JPEG quality'
  367. constraints:
  368. # @see \Drupal\system\Plugin\ImageToolkit\GDToolkit::buildConfigurationForm()
  369. Range:
  370. min: 0
  371. max: 100
  372. system.mail:
  373. type: config_object
  374. label: 'Mail system'
  375. constraints:
  376. FullyValidatable: ~
  377. mapping:
  378. interface:
  379. type: sequence
  380. label: 'Interfaces'
  381. sequence:
  382. type: string
  383. label: 'Interface'
  384. constraints:
  385. PluginExists:
  386. manager: plugin.manager.mail
  387. interface: 'Drupal\Core\Mail\MailInterface'
  388. mailer_dsn:
  389. type: mailer_dsn
  390. label: 'Symfony mailer transport DSN'
  391. system.theme.global:
  392. type: theme_settings
  393. label: 'Theme global settings'
  394. system.advisories:
  395. type: config_object
  396. label: 'Security advisory settings'
  397. constraints:
  398. FullyValidatable: ~
  399. mapping:
  400. enabled:
  401. type: boolean
  402. label: 'Display critical security advisories'
  403. interval_hours:
  404. type: integer
  405. label: 'How often to check for security advisories, in hours'
  406. # Minimum can be set to 0 as it just means the advisories will be retrieved on every call.
  407. # @see \Drupal\system\SecurityAdvisories\SecurityAdvisoriesFetcher::getSecurityAdvisories
  408. constraints:
  409. PositiveOrZero: ~
  410. block.settings.system_branding_block:
  411. type: block_settings
  412. label: 'Branding block'
  413. constraints:
  414. FullyValidatable: ~
  415. mapping:
  416. use_site_logo:
  417. type: boolean
  418. label: 'Use site logo'
  419. use_site_name:
  420. type: boolean
  421. label: 'Use site name'
  422. use_site_slogan:
  423. type: boolean
  424. label: 'Use site slogan'
  425. block.settings.system_menu_block:*:
  426. type: block_settings
  427. label: 'Menu block'
  428. constraints:
  429. FullyValidatable: ~
  430. IgnoreActiveTrail: ~
  431. mapping:
  432. level:
  433. type: integer
  434. label: 'Starting level'
  435. constraints:
  436. MenuLinkDepth:
  437. min: 0
  438. depth:
  439. type: integer
  440. label: 'Maximum number of levels'
  441. nullable: true
  442. constraints:
  443. MenuLinkDepth:
  444. baseLevel: '[%parent.level]'
  445. min: 1
  446. expand_all_items:
  447. type: boolean
  448. label: 'Expand all items'
  449. ignore_active_trail:
  450. type: boolean
  451. label: 'Ignore active trail'
  452. requiredKey: false
  453. block.settings.local_tasks_block:
  454. type: block_settings
  455. label: 'Tabs block'
  456. constraints:
  457. FullyValidatable: ~
  458. mapping:
  459. primary:
  460. type: boolean
  461. label: 'Whether primary tabs are shown'
  462. secondary:
  463. type: boolean
  464. label: 'Whether secondary tabs are shown'
  465. condition.plugin.request_path:
  466. type: condition.plugin
  467. mapping:
  468. pages:
  469. type: string
  470. condition.plugin.response_status:
  471. type: condition.plugin
  472. constraints:
  473. FullyValidatable: ~
  474. mapping:
  475. status_codes:
  476. type: sequence
  477. sequence:
  478. type: integer
  479. constraints:
  480. # @see \Drupal\system\Plugin\Condition\ResponseStatus::buildConfigurationForm()
  481. Choice:
  482. # HTTP 200 OK, HTTP 403 FORBIDDEN, HTTP 404 NOT FOUND.
  483. choices: [200, 403, 404]
  484. system.feature_flags:
  485. type: config_object
  486. label: 'System Feature Flags'
  487. constraints:
  488. FullyValidatable: ~
  489. mapping:
  490. linkset_endpoint:
  491. type: boolean
  492. label: 'Enable the menu linkset endpoint'
  493. condition.plugin.current_theme:
  494. type: condition.plugin
  495. mapping:
  496. theme:
  497. type: string
  498. label: Theme

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