Skip to content
Fetching contributors…
Cannot retrieve contributors at this time
54 lines (36 sloc) 1.34 KB


will_paginate v2.3 is a pagination plugin for Rails and Active Record.


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

See installation instructions on the wiki for more info.

Basic will_paginate use

## perform a paginated query:
@posts = Post.paginate(:page => params[:page])

# or, use an explicit "per page" limit:
Post.paginate(:page => params[:page], :per_page => 30)

## render page links in the view:
<%= will_paginate @posts %>

And that's it! You're done. You just need to add some CSS styles to make those pagination links prettier.

You can customize the default "per_page" value:

# for the Post model
class Post
  self.per_page = 10

# set per_page globally
WillPaginate.per_page = 10

See the wiki for more documentation. Ask on the group if you have usage questions. Report bugs on GitHub.

Happy paginating.

Jump to Line
Something went wrong with that request. Please try again.