Created: 2008-07-11 19:52
Updated: 2018-04-05 21:40


Radiant Paginate Extension


An extension by Aissac that provides pagination support to Radiant CMS.

Tested on Radiant 0.7.1, 0.8 and 0.9 RC1


Uses will_paginate plugin to iterate over children of a Page with pagination options:

  • Specify number children per page
  • Ordering by a specific page attribute and order direction
  • Conditionally render content for first page
  • Render pagination links customizable from the Radius tag (specify next/prev label, DOM class, inner and outer window etc.)


The Radiant Paginate Extension has one dependency: the 'will_paginate' gem/plugin

git clone git://github.com/mislav/will_paginate.git vendor/plugins/will_paginate


sudo gem install mislav-will_paginate --source http://gems.github.com

Then install the Radiant Paginate Extension:

git clone git://github.com/Aissac/radiant-paginate-extension.git vendor/extensions/paginate


Because the archived pages urls may not be processed properly, it is recommended to set Radiant::Config['paginate.url_route'] to something like page-

Radiant['paginate.url_route'] = 'page-'


###Available Tags

  • See the "available tags" documentation built into the Radiant page admin for more details.
  • Use the <r:paginate:each> / to render the content for each child of the current page.
  • Use the <r:paginate:each:if_first /> to expand when this is the first child
  • Use the <r:paginate:each:unless_first /> to expand when this is not the first child
  • Use the <r:paginate:pages /> to render the pagination links with will_paginate.


  • Istvan Hoka (@ihoka)
  • Benny Degezelle
  • Jim Gay
  • Andrew Neil
  • Michael Kessler
  • Cristi Duma (@cristi_duma)
Cookies help us deliver our services. By using our services, you agree to our use of cookies Learn more