Skip to content
Unobtrusive flash messages for Rails
Ruby JavaScript
Find file
New pull request
Pull request Compare This branch is 4 commits ahead, 4 commits behind jurgens:master.
Fetching latest commit...
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Unobtrusive flash messages for Rails

Ever got tired of pages that can't be cached because they contain flash messages?

Ever got tired of writing custom code to handle flash messages passed in AJAX responses?

Here comes the solution.

unobtrusive_flash takes your flash messages for the backend and automagically passes them to the frontend via HTTP cookies. This works with both regular page loads and AJAX requests, does not tamper with the page body and requires about 3 extra lines of code in your app - how's that for unobtrusive?

You can pass up to 4K of text into flash this way, and you don't need to worry about cookie size since they are cleared immediately upon rendering.

Tested and fully functional in:

  • Internet Explorer 8
  • Firefox 4b7
  • Chrome 7
  • Safari 5
  • Opera 10.6
  • please let me know if it works in firefox 3 and ie 6, 7


  • Rails 2.3 or 3
  • jQuery (maybe I'll make it agnostic in the future)


  1. Add the gem to your Rails app.
  2. Run script/generate unobtrusive_flash or rails g unobtrusive_flash:install
  3. Add the following to the controllers that generate flash messages (or better, to the ApplicationController):

    after_filter :prepare_unobtrusive_flash
  4. Include unobtrusive_flash.css and unobtrusive_flash.js in your layouts. No custom markup is needed.

  5. Remove existing flash rendering code from your layouts.
  6. That's all! You can also edit the generated CSS/JS to your liking.

© 2010 Leonid Shevtsov, released under the MIT license

Something went wrong with that request. Please try again.