{"record":{"id":"701fb49520e9a262","repo":"octobercms/october","slug":"unable-to-find-the-specified-settings","errorCode":null,"errorMessage":"Unable to find the specified settings.","messagePattern":"Unable to find the specified settings\\.","errorType":"exception","errorClass":"ApplicationException","httpStatus":null,"severity":"error","filePath":"modules/system/controllers/Settings.php","lineNumber":88,"sourceCode":"    }\n\n    //\n    // Generated Form\n    //\n\n    /**\n     * update action\n     */\n    public function update($author, $plugin, $code = null)\n    {\n        SettingsManager::setContext($author.'.'.$plugin, $code);\n\n        $this->vars['parentLink'] = Backend::url('system/settings');\n        $this->vars['parentLabel'] = __('Settings');\n\n        try {\n            if (!$item = $this->findSettingItem($author, $plugin, $code)) {\n                throw new ApplicationException(__('Unable to find the specified settings.'));\n            }\n\n            $this->pageTitle = $item->label;\n            $this->pageSize = Backend::sizeToPixels($item->size) ?: null;\n\n            if ($item->context == 'mysettings') {\n                $this->vars['parentLink'] = Backend::url('system/settings/mysettings');\n                $this->vars['parentLabel'] = Lang::get('backend::lang.mysettings.menu_label');\n            }\n\n            $model = $this->createModel($item);\n\n            $this->initWidgets($model);\n        }\n        catch (Exception $ex) {\n            $this->handleError($ex);\n        }\n    }","sourceCodeStart":70,"sourceCodeEnd":106,"githubUrl":"https://github.com/octobercms/october/blob/b608633a7e8922487d91a8161499020121c3b3bf/modules/system/controllers/Settings.php#L70-L106","documentation":"Settings controller update($author, $plugin, $code) renders a settings form after resolving the requested item through findSettingItem() against SettingsManager registrations. When no plugin or module registered a matching settings item (context author.plugin plus optional code), it throws 'Unable to find the specified settings.' before any model or widget is built.","triggerScenarios":"Requesting backend/system/settings/update/<author>/<plugin>[/<code>] where the providing plugin is not installed or disabled (its registerSettings() items are never registered), or where the code segment does not match any registered item's code (e.g. mysettings items).","commonSituations":"Bookmarked settings page of a plugin that was later uninstalled or disabled; wrong third segment in the URL; plugin boot failure preventing registration.","solutions":["Verify the plugin is installed and enabled (Settings > System > Plugins)","Check the plugin's registerSettings() declares an item whose context and code match the URL segments exactly","Navigate from the settings index instead of a stale bookmark so the URL is regenerated from registered items"],"exampleFix":"// before: nothing registers the 'acme.shop' settings context, URL 404s with the error\n\n// after: in acme/shop/Plugin.php\npublic function registerSettings()\n{\n    return [\n        'settings' => [\n            'label' => 'Shop Settings',\n            'description' => 'Manage shop settings',\n            'category' => 'Shop',\n            'icon' => 'icon-cog',\n            'class' => 'Acme\\Shop\\Models\\Settings',\n            'order' => 500,\n        ],\n    ];\n}","handlingStrategy":"validation","validationCode":"$items = \\System\\Classes\\SettingsManager::instance()->listItems();\n// render settings links only for items present in $items;\n// never hardcode backend/system/settings/update/... URLs","typeGuard":null,"tryCatchPattern":null,"preventionTips":["Link to settings pages via SettingsManager-derived URLs, never hardcoded bookmarks","When uninstalling a plugin, remove or redirect its settings links","Test settings URLs after disabling plugins in staging"],"tags":["settings","backend","plugin","registration","not-found"],"backgroundTag":"resource-not-found","analyzedSha":"b608633a7e8922487d91a8161499020121c3b3bf","analyzedAt":"2026-08-21T04:24:57.515Z","schemaVersion":2},"datasetVersion":"2026-08-21T11:28:35.574Z"}