diff --git a/app/views/rails_admin/main/index.html.erb b/app/views/rails_admin/main/index.html.erb
index dad7c9ab5c..c5bee0dfe5 100644
--- a/app/views/rails_admin/main/index.html.erb
+++ b/app/views/rails_admin/main/index.html.erb
@@ -83,6 +83,9 @@
+ <% if @model_config.list.search_help.present? %>
+
<%= @model_config.list.search_help %>
+ <% end %>
<% if export_action %>
diff --git a/lib/rails_admin/config/sections/list.rb b/lib/rails_admin/config/sections/list.rb
index 5db655291e..ae5893ac7e 100644
--- a/lib/rails_admin/config/sections/list.rb
+++ b/lib/rails_admin/config/sections/list.rb
@@ -30,6 +30,10 @@ class List < RailsAdmin::Config::Sections::Base
nil
end
+ register_instance_option :search_help do
+ nil
+ end
+
register_instance_option :sort_by do
parent.abstract_model.primary_key
end
diff --git a/spec/integration/actions/index_spec.rb b/spec/integration/actions/index_spec.rb
index 53c61ac3cd..13d8ad0ff0 100644
--- a/spec/integration/actions/index_spec.rb
+++ b/spec/integration/actions/index_spec.rb
@@ -321,6 +321,16 @@
},
]
end
+
+ it 'shows the help text below the search box' do
+ RailsAdmin.config Player do
+ list do
+ search_help 'Use this box to search!'
+ end
+ end
+ visit index_path(model_name: 'player')
+ is_expected.to have_css('.form-text', text: /Use this box/)
+ end
end
describe 'fields' do