Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Gem providing simple Contact Form functionality with a Rails 3+ Engine.
Ruby JavaScript HTML
Latest commit f3ee682 @JDutil Bump to 1.1.0
Failed to load latest commit information.
app Configurable parent mailer.
config Create contact_us.zh-TW.yml
lib Bump to 1.1.0
spec Rspec 3.
.gitignore Configurable parent mailer.
.rspec Rspec 3.
.travis.yml Update travis. Bump to 1.1.0
Gemfile Rails 4.2 updates. Fixes #50
MIT-LICENSE initial commit Bump version.
Rakefile initial commit
contact_us.gemspec Rspec 3.

Contact Us Build Status Dependency Status Click here to lend your support to: ContactUs and make a donation at !

A Rails 3+ Engine providing a basic contact form.

There is also a demo application showing how the ContactUs form works:


Contact Us requires:

  • Ruby >= 1.9.3
  • Rails >= 3.0.0

It is also recommended to use Formtastic or SimpleForm (see configuration) in order to hook into your apps custom form builders.


In your Gemfile, add the following dependencies:

gem 'contact_us', '~> 1.0.1'

From Rails.root in your Terminal run:

bundle exec rake contact_us:install

In config/initializers/contact_us.rb modify:

config.mailer_to = ""

Change to the email address you would like to receive the form submissions at for example:

config.mailer_to = ""

By default the emails from field will be the email entered by the user to easily reply, but this may not be allowed if your required to verify your sending email addresses. You may also specify an email address for the notification emails from field:

config.mailer_from = ""


If you would like to add a name or subject field to the form you may simply set the options to true within the contact_us initializer located at config/initializers/contact_us.rb:

config.require_name = true
config.require_subject = true

To redirect to a specific URL after a successful form submission:

config.success_redirect = '/contact-success'


To copy the view files to app/views/contact_us, and customize them to suit your needs run:

bundle exec rake contact_us:copy_views


To copy the locale files to config/locales/contact_us.*.yml, and customize them to suit your needs run:

bundle exec rake contact_us:copy_locales

Please feel free to submit your own locales so that other users will hopefully find this gem more useful in your language.


In order to use a Formtastic compatible template to hook into your custom form styles configure config/initializers/contact_us.rb:

config.form_gem = 'formtastic'
  • By default the HTML should match that produced by Formtastic, but to ensure it is up to date you should set Formtastic.


In order to use a SimpleForm compatible template to hook into your custom form styles configure config/initializers/contact_us.rb:

config.form_gem = 'simple_form'


When upgrading from 0.1.x to 0.2.x you should rerun the install generator to install the new settings, views, and locale updates:

bundle exec rake contact_us:install

Or you may run the generators for each specific component you would like to update, which is quite useful when upgrading during patch releases for example from 0.2.0 to 0.2.1:

bundle exec rake contact_us:copy_locales
bundle exec rake contact_us:copy_views


Visit your website and navigate to /contact-us to see the form in action.


Contact Us has 100% test coverage, and provides simple integration specs you can drop directly into your apps test suite if you use RSpec & Capybara.

Simply copy the spec/integration/contact_us_lint_spec.rb file, and add it to your integration specs.


Please report any bugs or feature requests to the Github issues page @


In order to run the spec suite:

bundle exec rspec spec


  • Add new language translations.


In the spirit of free software, everyone is encouraged to help improve this project.

Here are some ways you can contribute:

  • by using prerelease versions
  • by reporting bugs
  • by suggesting new features
  • by translating to a new language
  • by writing or editing documentation
  • by writing specifications
  • by writing code (no patch is too small: fix typos, add comments, clean up inconsistent whitespace)
  • by refactoring code
  • by resolving issues
  • by reviewing patches


Bitcoin donations may be sent to: 1Jz1rWG6HSWb6eBGgTyhANrkVxmzY4YPKS

Copyright (c) 2011-2013 Jeff Dutil, released under the MIT license.

Something went wrong with that request. Please try again.