Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP


Mislav Marohnić edited this page · 6 revisions

To install will_paginate in Rails 3+ or other frameworks:

## Gemfile for Rails 3+, Sinatra, or Merb
gem 'will_paginate', '~> 3.0.5'

Then run bundle install. It will automatically hook into Rails or Merb on application boot.

A Sinatra app needs a couple of extra requires:

## Sinatra app:
require 'will_paginate'
require 'will_paginate/active_record'  # or data_mapper/sequel

For Padrino apps you need to manually register the Sinatra extension:

## app/app.rb
register WillPaginate::Sinatra

## config/boot.rb
Padrino.before_load do
  require 'will_paginate/view_helpers/sinatra'
  require 'will_paginate/data_mapper'

Padrino.after_load do

Alternatively, you can avoid manual will_paginate install by using Padrino recipes:

$ padrino g plugin will_paginate

Rails 2.3.x or older

will_paginate 3.0+ will not work on Rails 2. In an older version of Rails, you'll have to use will_paginate 2.3:

## Rails 2.1 - 2.3: environment.rb do |config|
  config.gem 'will_paginate', :version => '~> 2.3.16'

Then run rake gems:install.

For Rails 2.0 or older, a simple require will suffice:

## Rails 1.2 - 2.0: environment.rb
require 'will_paginate'
Something went wrong with that request. Please try again.