{"record":{"id":"1ff27159ec3e20cb","repo":"railsadminteam/rails_admin","slug":"the-sidescroll-configuration-option-was-removed-i-1ff271","errorCode":null,"errorMessage":"The sidescroll configuration option was removed, it is always enabled now.","messagePattern":"The sidescroll configuration option was removed, it is always enabled now\\.","errorType":"console","errorClass":null,"httpStatus":null,"severity":"warning","filePath":"lib/rails_admin/config/sections/list.rb","lineNumber":50,"sourceCode":"\n        register_instance_option :search_help do\n          nil\n        end\n\n        register_instance_option :sort_by do\n          parent.abstract_model.primary_key\n        end\n\n        register_instance_option :scopes do\n          []\n        end\n\n        register_instance_option :row_css_class do\n          ''\n        end\n\n        register_deprecated_instance_option :sidescroll do\n          ActiveSupport::Deprecation.warn('The sidescroll configuration option was removed, it is always enabled now.')\n        end\n\n        def fields_for_table\n          visible_fields.partition(&:sticky?).flatten\n        end\n\n        register_deprecated_instance_option :sort_reverse do\n          ActiveSupport::Deprecation.warn('The sort_reverse configuration option is deprecated and has no effect.')\n        end\n      end\n    end\n  end\nend\n","sourceCodeStart":32,"sourceCodeEnd":64,"githubUrl":"https://github.com/railsadminteam/rails_admin/blob/0690a5e62f8d99bc00495a3754f5189b23124387/lib/rails_admin/config/sections/list.rb#L32-L64","documentation":"Same removal as the global config.sidescroll= (lib/rails_admin/config.rb:291), but at the per-model list-section level: sections/list.rb:49 registers sidescroll as a deprecated option whose block only prints this ActiveSupport::Deprecation warning. Sidescrolling of the list table is always enabled in the 3.x UI, so the value (true or false) is ignored.","triggerScenarios":"A per-model config block containing `list { sidescroll false }` (or true), e.g. `RailsAdmin.config do |c| c.model Player do list { sidescroll false } end end`. The warning prints the first time that model's config is evaluated — typically the first admin request to its index page — and the table still sidescrolls.","commonSituations":"Model configs migrated unchanged from rails_admin 2.x, where disabling sidescroll restored the old wide-table layout; bulk find-and-replace during upgrades that caught the global setter but missed per-model blocks; deprecation-as-error CI setups failing admin page specs.","solutions":["Delete the `sidescroll` line from the model's list block — there is no replacement and the behavior cannot be turned off.","To shorten the table instead, hide columns: `list { field :long_description { visible false } }` — fewer visible columns means less horizontal scrolling.","While there, check the same block for sort_reverse (sections/list.rb:57), which is deprecated in the same place."],"exampleFix":"# before\nRailsAdmin.config do |config|\n  config.model Player do\n    list do\n      sidescroll false # warns: removed, always enabled\n    end\n  end\nend\n\n# after\nRailsAdmin.config do |config|\n  config.model Player do\n    list do\n      field :bio { visible false } # narrow the table instead of disabling sidescroll\n    end\n  end\nend","handlingStrategy":"validation","validationCode":"#_initializer audit covering the per-model variant\nDir[Rails.root.join('config/initializers/*.rb')].each do |path|\n  File.readlines(path).each_with_index do |line, i|\n    puts \"#{path}:#{i + 1} remove `sidescroll`\" if line =~ /\\bsidescroll\\b/\n  end\nend","typeGuard":null,"tryCatchPattern":null,"preventionTips":["Upgrade rails_admin major versions in a dedicated PR whose only diff is initializer/config migration, reviewed against the CHANGELOG.","Automated grep in CI for known-removed option names (sidescroll, total_columns_width, sort_reverse inside list blocks) keeps them from creeping back.","Exercise each model's index page in a request spec after upgrades — deprecated section options fire only when that section config evaluates."],"tags":["rails-admin","deprecation","configuration","ruby","list-view","upgrade"],"backgroundTag":"deprecated-config-option","analyzedSha":"0690a5e62f8d99bc00495a3754f5189b23124387","analyzedAt":"2026-08-21T18:31:19.382Z","schemaVersion":2},"datasetVersion":"2026-08-21T23:17:16.201Z"}