{"record":{"id":"3a488068fbe913f5","repo":"MagicMirrorOrg/MagicMirror","slug":"warning-your-config-for-module-element-module","errorCode":null,"errorMessage":"WARNING! Your config for module ${element.module} is using deprecated option(s): ${usedDeprecatedModuleOptions.join(\", \")}. Check README and Documentation for more up-to-date ways of getting the same functionality.","messagePattern":"WARNING! Your config for module (.+?) is using deprecated option\\(s\\): (.+?)\\. Check README and Documentation for more up-to-date ways of getting the same functionality\\.","errorType":"console","errorClass":null,"httpStatus":null,"severity":"warning","filePath":"js/utils.js","lineNumber":92,"sourceCode":" * @param {object} userConfig The user config\n */\nconst checkDeprecatedOptions = (userConfig) => {\n\tconst deprecated = require(`${global.root_path}/js/deprecated`);\n\n\t// check for deprecated core options\n\tconst deprecatedOptions = deprecated.configs;\n\tconst usedDeprecated = deprecatedOptions.filter((option) => userConfig.hasOwnProperty(option));\n\tif (usedDeprecated.length > 0) {\n\t\tLog.warn(`WARNING! Your config is using deprecated option(s): ${usedDeprecated.join(\", \")}. Check README and Documentation for more up-to-date ways of getting the same functionality.`);\n\t}\n\n\t// check for deprecated module options\n\tfor (const element of userConfig.modules) {\n\t\tif (deprecated[element.module] !== undefined && element.config !== undefined) {\n\t\t\tconst deprecatedModuleOptions = deprecated[element.module];\n\t\t\tconst usedDeprecatedModuleOptions = deprecatedModuleOptions.filter((option) => element.config.hasOwnProperty(option));\n\t\t\tif (usedDeprecatedModuleOptions.length > 0) {\n\t\t\t\tLog.warn(`WARNING! Your config for module ${element.module} is using deprecated option(s): ${usedDeprecatedModuleOptions.join(\", \")}. Check README and Documentation for more up-to-date ways of getting the same functionality.`);\n\t\t\t}\n\t\t}\n\t}\n};\n\n/**\n * Loads the config file. Combines it with the defaults and returns the config\n * @returns {object} an object holding full and redacted config\n */\nconst loadConfig = () => {\n\tLog.log(\"Loading config ...\");\n\tconst defaults = require(\"./defaults\");\n\tif (global.mmTestMode) {\n\t\t// if we are running in test mode\n\t\tdefaults.address = \"0.0.0.0\";\n\t}\n\n\t// For this check proposed to TestSuite","sourceCodeStart":74,"sourceCodeEnd":110,"githubUrl":"https://github.com/MagicMirrorOrg/MagicMirror/blob/4b4a59534f7da01e4030e46029fe9dd649a7675e/js/utils.js#L74-L110","documentation":"The same deprecation check as for core options, but applied per module: for each entry in config.modules whose module name has a deprecation entry in js/deprecated.js, any of its listed options found in element.config produces this warning identifying the module and the offending option names.","triggerScenarios":"A module entry in config.modules sets an option flagged in deprecated.js for that module (e.g. old calendar/newsfeed options renamed upstream), after a core upgrade that deprecated them.","commonSituations":"Upgrading MagicMirror core while keeping module configs from an older install; copying old module config examples from the forum.","solutions":["Note the module and deprecated option names in the message.","Check the module's (new) README or the core module documentation for the renamed/replacement options.","Update element.config for that module accordingly and restart."],"exampleFix":"// before\n{ module: \"calendar\", position: \"top_left\", config: { fetchInterval: 60000 } } // option renamed upstream\n// after\n{ module: \"calendar\", position: \"top_left\", config: { fetchInterval: 60000 } } // with option name per current docs","handlingStrategy":"validation","validationCode":"// check module configs against the deprecation list:\nconst deprecated = require(\"./js/deprecated\");\nfor (const m of config.modules) {\n  if (Array.isArray(deprecated[m.module]) && m.config) {\n    const bad = deprecated[m.module].filter((o) => m.config.hasOwnProperty(o));\n    if (bad.length) console.error(`Module ${m.module}: deprecated options ${bad}`);\n  }\n}","typeGuard":null,"tryCatchPattern":null,"preventionTips":["Run `npm run config:check` after upgrades","Re-read each module's README after core updates","Avoid copying module configs older than your MagicMirror version","Test each module's rendering after config changes"],"tags":["config","deprecation","modules"],"backgroundTag":"deprecated-config-option","analyzedSha":"4b4a59534f7da01e4030e46029fe9dd649a7675e","analyzedAt":"2026-08-31T21:49:42.591Z","schemaVersion":2},"datasetVersion":"2026-08-31T22:30:34.772Z"}