jQuery qTip2 for Rails

qTip2 packaged for the Rails 3.1+ asset pipeline. Check qTip2 project home page.


Add this line to your application's Gemfile:

gem 'jquery-qtip2-rails'

And then execute:

$ bundle

Or install it yourself as:

$ gem install jquery-qtip2-rails


qTip2 can be customized to fit your own needs. This gem works in a similar manner.

"Full" version of qTip2

The full version of qTip2 includes all its plugins. This is the recommended version.

Add the following JavaScript file to app/assets/javascripts/application.js:

//= require jquery.qtip.js

Add the following stylesheet file to app/assets/stylesheets/application.css:

*= require jquery.qtip.css

Basic version of qTip2

The basic version of qTip2 does not include any plugin.

File app/assets/javascripts/application.js:

//= require jquery.qtip.basic.js

File app/assets/javascripts/application.css:

//= require jquery.qtip.basic.css

Customized version of qTip2

You can also create your own app/assets/javascripts/jquery.qtip.js file:

//= include jquery-qtip/src/intro.js
//= include jquery-qtip/src/core.js
//= include jquery-qtip/src/svg/svg.js
//= include jquery-qtip/src/ajax/ajax.js
//= include jquery-qtip/src/tips/tips.js
//= include jquery-qtip/src/modal/modal.js
//= include jquery-qtip/src/viewport/viewport.js
//= include jquery-qtip/src/imagemap/imagemap.js
//= include jquery-qtip/src/ie6/ie6.js
//= include jquery-qtip/src/outro.js

And app/assets/stylesheets/jquery.qtip.css file:

 *= include jquery-qtip/src/core.css
 *= include jquery-qtip/src/basic.css
 *= include jquery-qtip/src/css3.css
 *= include jquery-qtip/src/tips/tips.css
 *= include jquery-qtip/src/modal/modal.css
 *= include jquery-qtip/src/ie6/ie6.css

This allows you to enable only the plugins that you need and thus reduce qTip2 size. This is possible thanks to the asset pipeline preprocessor include directive. Files jquery.qtip.js and jquery.qtip.basic.js provided with this gem work the exact same way.


This gem does not include minified and compressed version of qTip2 since there is no need of. This is done automatically by Rails asset pipeline.

qTip2 Twitter Bootstrap theme

qTip2 includes a Twitter Bootstrap theme.

Bootstrap theme

How to use:

  content: 'Hello World!'
  style: {
    classes: 'qtip-bootstrap'

Rails test/dummy

jquery-qtip2-rails comes with a dummy Rails application that you can run:

Development mode:

  • bundle
  • cd test/dummy && rails s

Production mode:

  • bundle
  • cd test/dummy && rake assets:precompile: generates .js and .css files inside test/dummy/public/assets/ + test/dummy/tmp/
  • cd test/dummy && rails s -e production


qTip2 is being developed by Craig Thompson and is dual-licensed under the open source MIT and GPLv2 licenses.

This gem is licensed under MIT license.