Skip to content


Subversion checkout URL

You can clone with
Download ZIP
This is a fork from the original (and long dead) iso-3166-country-select Rails plugin to make it available as a gem and update it as necessary.
Branch: master
Pull request Compare This branch is 1 commit ahead, 3 commits behind ninkibah:master.

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.


Provides a simple helper to get an HTML select list of countries. The list of countries comes from the ISO 3166 standard. While it is a relatively neutral source of country names, it may still offend some users.

Users are strongly advised to evaluate the suitability of this list given their user base.

This project was forked to have a version of the gem which would use 2 letter ISO-3166 country codes, and allow for internationalization. The translations can be set up under the "countries" key with the ISO-3166 code as the sub-key. Thus: countries.US is the translation key for the United States of America.

Latest Changes


  • Converted COUNTRIES to a hash from default English name to ISO-3166 2 letter code.


  • Fixed incompatibility with Rails 3.2.2 (thanks to jmazzi)


  • Updated the country list to change the name of Libyan Arab Jamahiriya to Libya according to the latest ISO 3166 newsletter
  • A country in the priority list will be selected there and not in the main list (thanks to yyyc514)
  • Removed relics from the pre-gem days


Install as a gem using

gem install country-select

Or put the following in your Gemfile

gem 'country-select'


Simple use supplying model and attribute as parameters:

country_select("user", "country_name")

Supplying priority countries to be placed at the top of the list:

country_select("user", "country_name", [ "United Kingdom", "France", "Germany" ])

Version History

  • 1.0.5 - runtime error raised if any of the user-supplied priority countries do not correlate with those in the main country list.
  • 1.0.4 - updated the country list to match the latest ISO 3166 specification
  • 1.0.3 - changed gem name from 'iso-3166-country-select' to just 'country-select'
  • 1.0.2 - forked the plugin and made it into a gem

Copyright (c) 2008 Michael Koziarski, released under the MIT license

Something went wrong with that request. Please try again.