CookieAlert (beta)

CookieAlert will add an alert to your webpage informing your visitor that your website uses Cookies. It can be configured to display the Alert for a fixed number of views, or display it constantly until the visitor 'accepts' the alert. It:

  • Will work 'straight out the box' without any additional configuration
  • Is fully customisable, including views, javascript response and number of displays.
  • Aims to be a simple way to address the EU Cookie Law requiring websites to notify their visitors that they use Cookies.


  1. Update Gemfile to add

      gem "cookie_alert"
  2. Run bundle

    bundle install
  3. Install the configuration & view files

    rails g cookie_alert:install
  4. Update your app/helpers/application_helper.rb file to include the CookieAlert module:

      include CookieAlert
  5. Update your config/routes.rb file to add the CookieAlert route:

      mount CookieAlert::Engine => "/cookie-alert"
  6. Update your Asset Manifest files to add the JavaScript and CSS files:

  • in application.js add

    //= require cookie_alert
  • in application.css add

    *= require cookie_alert


To remove the installed files run rails g cookie_alert:uninstall

Displaying Alerts

To display the Cookie Alerts, simply call the following method from your layout <%= display_cookie_alert %>

How It Works

When a visitor first comes to your site CookieAlert will set an encrypted Cookie that keeps track of how many pages the visitor has viewed and display a Primary Alert notifying the visitor that your site uses Cookies. By default this Primary Alert is a large banner fixed at the foot of the screen.

After the Primary Alert has been displayed a number of times (5 by default) it is replaced by a Secondary Alert. By default this is a smaller box fixed to the bottom-left of the screen which transforms back to the the large banner when moused-over.

The visitor can click a link to 'hide the banner', thereby accepting the notice, and the Alerts will no longer be displayed for the remainder of the session.


CookieAlert can be configured to:

  • Display a Primary Alert message until the visitor clicks the 'accept' link.
  • Display a Primary Alert message which, after a number of views, changes to a Secondary Alert message until the visitor clicks the 'accept' link.
  • Display a Primary Alert message then, after a number of views, stop showing any alert messages at all.

Please check the WIKI for a full list of the configuration options available.


The default Alerts use JQuery to allow a server-side response and to add effects. You can easily change this to use a different JavaScript framework (or none at all!). Check the WIKI to see how.


If you are using CookieAlert to address the EU Cookie Law, then within the Alert message you should also include a link to a Cookie Policy page where your visitors can view a description of the cookies used by your site. See for an example.

Note that CookieAlert is designed to allow you to display alerts - the content and wording of the alert is entirely your own responsibility. KatanaCode do not warrant in any way that the default message, operation or usage of this Gem will make you compliant with the EU Cookie Law. It is up to you to ensure compliance!

All we can say is that we use it ourselves.


If you discover a problem with CookieAlert, please let us know about it.

Remember to search the issues list first in case your issue has already been raised by another Githuber


Full documentation is available here:


You're welcome to contribute to CookieAlert. Please consult the contribution guidelines for more info.

Legal Stuff

Copyright 2013 Katana Code Ltd.

See MIT-LICENSE for full details.


Developed by CodeMeister at Katana Code Ltd

About Katana Code

Katana Code are iPhone app and Ruby on Rails Developers in Edinburgh, Scotland.