Add world flags to your web project by a two letter country code, all html and css, no dependencies, simple.
Switch branches/tags
Nothing to show
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Add world flags to your web project by a two letter country code, all html and css, no dependencies, simple. Available in 4 sizes: 16, 24, 32 and 48 pixels.

Sample flags usecase


Inspired by, and in fact, all image assets and style-sheets were extracted from there.

I have found I needed to call up flags in an intuitive and programmable way, specifically, I was looking for a way to call up country flag images by their respective country codes. Which led me to extract this project from a more complex gem.


  1. Add the style-sheet and images folder to your project in their proper place. The style-sheets assume images are available under this path: /images/flags/flags16.png; for example. If you need to move the assets or change the paths, feel free to do so for each CSS files you use. Include the stylesheets/common.css file for good luck.
  2. Simply attach the .f16 class (or any of the other size options) to the wrapper of your target flag nodes.
  3. Then add a tag that will become your flag node, either a span, li, div, or i will do. Add the flag class to this element, and the two letter country code name also as a class name.


<div class="f16">
	<i class="flag ca"></i>

Check out the example.html file to see a simple example.

Country codes... are the key

You can get country codes from various utilities, for example, in Rails and Ruby there are gems which will readily assist you in extracting country codes from country names, IP numbers, Geo location information, etc. I leave it up to you how you get your country codes in there.

Here is a more complex example within a project which already has country codes available and is providing them as a ruby hash to the view:

Using the gem 'countries', to extract the full country name from the provided country code. Imagine a hash of county codes and views as such: {"CA"=>7385, "US"=>98, "DE"=>12, "RO"=>20, "CN"=>3, "IN"=>8, "FR"=>3, "GB"=>19, "ES"=>1, "UA"=>2, "HK"=>1, ...}

<div class="f16">
	<% for cc in @country_codes %>
		<span class="tag">
			<i class="flag <%= cc[0].downcase %>"></i> <%= "#{Country.find_country_by_alpha2(cc[0]).name}: #{cc[1]}" %>
	<% end %>