{"record":{"id":"3774968556ac9424","repo":"RocketChat/Rocket.Chat","slug":"the-default-value-of-the-setting-has-changed-plea","errorCode":null,"errorMessage":"The default value of the setting has changed. Please review your settings.","messagePattern":"The default value of the setting has changed\\. Please review your settings\\.","errorType":"console","errorClass":null,"httpStatus":null,"severity":"info","filePath":"apps/meteor/server/startup/migrations/v317.ts","lineNumber":73,"sourceCode":"\n\t\tawait LoginServiceConfiguration.createOrUpdateService(serviceKey, data);\n\t}\n}\n\naddMigration({\n\tversion: 317,\n\tname: 'Change default color of OAuth login services buttons',\n\tasync up() {\n\t\t// TODO: audit\n\t\tconst promises = settingsToUpdate\n\t\t\t.map(async ({ key, defaultValue, newValue }) => {\n\t\t\t\tconst oldSettingValue = await getSettingValue(key);\n\n\t\t\t\tif (!oldSettingValue || oldSettingValue !== defaultValue) {\n\t\t\t\t\treturn;\n\t\t\t\t}\n\n\t\t\t\tSystemLogger.warn({ msg: 'The default value of the setting has changed. Please review your settings.', key, newValue });\n\n\t\t\t\treturn Settings.updateOne({ _id: key }, { $set: { value: newValue } });\n\t\t\t})\n\t\t\t.filter(isTruthy);\n\n\t\tawait Promise.all(promises);\n\n\t\tconst customOAuthButtonColors = await Settings.find({\n\t\t\t_id: { $regex: /^Accounts_OAuth_Custom-[a-zA-Z0-9_-]+-button_color$/ },\n\t\t}).toArray();\n\t\tconst customOAuthButtonLabelColors = await Settings.find({\n\t\t\t_id: { $regex: /^Accounts_OAuth_Custom-[a-zA-Z0-9_-]+-button_label_color$/ },\n\t\t}).toArray();\n\n\t\tconst buttonColorPromises = customOAuthButtonColors\n\t\t\t.map(({ _id, value, packageValue }) => {\n\t\t\t\tif (packageValue !== value) {\n\t\t\t\t\treturn;","sourceCodeStart":55,"sourceCodeEnd":91,"githubUrl":"https://github.com/RocketChat/Rocket.Chat/blob/b2c16d5842cbe6b69b59bdf6fc5e5f1afcd1f0b0/apps/meteor/server/startup/migrations/v317.ts#L55-L91","documentation":"Logged by migration 317 ('Change default color of OAuth login services buttons'). Rocket.Chat moved from blue (#1d74f5 / #0082c9) filled buttons to a neutral gray style: new background #e4e7ea, new label #1f2329. For the four built-in background keys and four label keys in settingsToUpdate (SAML_Custom_Default_button_color, CAS_button_color, Accounts_OAuth_Nextcloud_button_color, Accounts_OAuth_Dolphin_button_color, and their *_label_color counterparts), the migration checks getSettingValue(key): if the value still equals the OLD default, it warns (including key and newValue) and updates the DB value to the new default. Customized values are left alone.","triggerScenarios":"Migration 317 runs on startup after upgrading from a pre-317-version release, and for one of the eight listed keys the current value equals the old default ('#1d74f5' or '#0082c9'). Each such key produces one warning and one Settings.updateOne({$set: {value: newValue}}).","commonSituations":"Any workspace upgrading across the release that introduced the neutral login-button redesign while never having customized CAS/SAML/Nextcloud/Dolphin button colors. Admins notice login buttons turned gray after upgrade; the warning is purely informational and cosmetic — no functionality breaks.","solutions":["No action required if the new gray look is acceptable — this is an intentional design change.","To restore the old blue, set the affected *_button_color / *_button_label_color settings back (e.g. #1d74f5 background, #ffffff label) in Admin -> Login options.","To keep custom branding permanently, set explicit values BEFORE upgrading — the migration only rewrites settings still equal to the old defaults.","Then call updateOAuthServices() (or restart) so login service configurations reflect the new colors."],"exampleFix":"// restore pre-317 blue button after the migration\nawait Settings.updateOne({ _id: 'CAS_button_color' }, { $set: { value: '#1d74f5' } });\nawait Settings.updateOne({ _id: 'CAS_button_label_color' }, { $set: { value: '#ffffff' } });","handlingStrategy":"validation","validationCode":"// Pre-upgrade: find built-in button settings still at old defaults (migration will recolor them)\nconst watched = [\n  ['SAML_Custom_Default_button_color', '#1d74f5'],\n  ['CAS_button_color', '#1d74f5'],\n  ['Accounts_OAuth_Nextcloud_button_color', '#0082c9'],\n  ['Accounts_OAuth_Dolphin_button_color', '#1d74f5'],\n  ['SAML_Custom_Default_button_label_color', '#1d74f5'],\n  ['CAS_button_label_color', '#1d74f5'],\n  ['Accounts_OAuth_Nextcloud_button_label_color', '#0082c9'],\n  ['Accounts_OAuth_Dolphin_button_label_color', '#1d74f5'],\n];\nfor (const [key, oldDefault] of watched) {\n  if ((await Settings.getValueById(key)) === oldDefault) {\n    console.log(`${key} is at old default and will be changed by migration 317`);\n  }\n}","typeGuard":null,"tryCatchPattern":null,"preventionTips":["Set explicit brand colors for every login button setting you care about BEFORE upgrading — migration 317 only rewrites values still equal to the old defaults.","After upgrade, visually check the login page; the new defaults are a gray background (#e4e7ea) with label #1f2329.","Keep a documented list of theme-related setting ids per provider so redesigns are easy to audit."],"tags":["migration","oauth","saml","cas","ui-theming","settings","upgrade"],"backgroundTag":"default-value-changed","analyzedSha":"b2c16d5842cbe6b69b59bdf6fc5e5f1afcd1f0b0","analyzedAt":"2026-08-18T15:26:39.429Z","contentChangedAt":"2026-08-18T15:26:39.429Z","schemaVersion":2},"datasetVersion":"2026-09-14T00:17:10.932Z"}