440

Where can I find a list of data types that can be used in Ruby on Rails 4? Such as

  • text
  • string
  • integer
  • float
  • date

I keep learning about new ones and I'd love to have a list I could easily refer to.

4
  • 1
    possible duplicate of Where is the documentation page for ActiveRecord data types? Commented Mar 29, 2014 at 1:51
  • 1
    @MarkThomas: Not a duplicate. My question here is specifically for Rails 4. Commented Mar 30, 2014 at 1:51
  • The accepted answer in that question is essentially the same as your accepted answer. Both point to the Rails 4 docs. Also, it's a moot point because ActiveRecord datatypes didn't change from Rails 3 to Rails 4. Commented Mar 30, 2014 at 19:00
  • 10
    I for one did not know AR datatypes didn't change between rails 3 and 4 so I'm thankful this question/answer is here.
    – Dty
    Commented Apr 12, 2014 at 22:49

5 Answers 5

727

Here are all the Rails 4 (ActiveRecord migration) datatypes:

  • :binary
  • :boolean
  • :date
  • :datetime
  • :decimal
  • :float
  • :integer
  • :bigint
  • :primary_key
  • :references
  • :string
  • :text
  • :time
  • :timestamp

Source: http://api.rubyonrails.org/classes/ActiveRecord/ConnectionAdapters/SchemaStatements.html#method-i-add_column
These are the same as with Rails 3.

If you use PostgreSQL, you can also take advantage of these:

  • :hstore
  • :json
  • :jsonb
  • :array
  • :cidr_address
  • :ip_address
  • :mac_address

They are stored as strings if you run your app with a not-PostgreSQL database.

More PostgreSQL data types

7
  • 1
    I believe these are the datatypes that are supported across all databases. However as Peter de Ridder mentions there are some datatypes like hstore which are still supported. Commented Jul 29, 2013 at 8:10
  • Question: postgres documentation doesn't seem to have text data type. Yet, rails can still handle it? What goes on in the background?
    – ahnbizcad
    Commented Aug 20, 2014 at 9:46
  • PostgreSQL does have a text datatype. Under the hood all varchar/text fields are variable length arrays. postgresql.org/docs/9.3/interactive/datatype-character.html
    – makhan
    Commented Aug 22, 2014 at 4:59
  • 1
    I'd like to add that if you're using a non-postgres database and your application schema_format is not set to use :sql, then your schema.rb file wont be able to dump the table that uses types like :json. The schema will still be dumped for the tables that use default types but you'll see a comment for the table with special types like, "could not dump table...". Look here to set the schema_format. Commented Feb 18, 2015 at 19:19
  • 1
    Also, those columns will have type nil in a non-postgres database. You can inspect the type in the console with Model.columns_hash["column_name"].type. These are just things that I've run into when using :json column type, I may be wrong and this may not happen to everyone but I thought I'd let future readers know in case they have troubles. Regardless, +1 for this answer because it really helped me. Commented Feb 18, 2015 at 19:26
268

You might also find it useful to know generally what these data types are used for:

There's also references used to create associations. But, I'm not sure this is an actual data type.

New Rails 4 datatypes available in PostgreSQL:

  • :hstore - storing key/value pairs within a single value (learn more about this new data type)
  • :array - an arrangement of numbers or strings in a particular row (learn more about it and see examples)
  • :cidr_address - used for IPv4 or IPv6 host addresses
  • :inet_address - used for IPv4 or IPv6 host addresses, same as cidr_address but it also accepts values with nonzero bits to the right of the netmask
  • :mac_address - used for MAC host addresses

Learn more about the address datatypes here and here.

Also, here's the official guide on migrations: http://edgeguides.rubyonrails.org/migrations.html

6
  • 14
    Applause. +1 for thoroughness, and anticipation of usage. That's UX mentality right there.
    – ahnbizcad
    Commented Aug 20, 2014 at 9:47
  • 5
    Absolutely terrific answer - many thanks for this. The links to the articles on differences literally took the questions right out of my mouth.
    – nlh
    Commented Sep 11, 2014 at 0:07
  • 3
    For Postgres there is additionally a uuid type which can be used as normal field like t.uuid :name... or as primary key like create_table :users, id: :uuid do... or e.g. t.primary_key :id, :uuid, :default => 'uuid_generate_v1()'
    – TNT
    Commented Jul 28, 2015 at 11:33
  • 1
    Additional PostgreSQL types supported by Rails listed in the API docs for ActiveRecord::ConnectionAdapters::PostgreSQL::ColumnMethods. Highlights include money, json, xml, daterange Commented Aug 21, 2015 at 15:09
  • 1
    Yes, uuid was added for Postgres, but it is not returned with an Active Record create(). Has that issue been fixed with Rails 5? Commented Jul 12, 2017 at 22:04
167

It is important to know not only the types but the mapping of these types to the database types, too:

enter image description here

enter image description here


Source added - Agile Web Development with Rails 4

4
  • 1
    I would be interested to see the json type in this table, if you feel up to it Commented Jan 22, 2015 at 19:08
  • 3
    You can always check the NATIVE_DATABASE_TYPES for the adapter you need - github.com/rails/rails/blob/master/activerecord/lib/…
    – gotqn
    Commented Jan 22, 2015 at 21:11
  • 1
    Is there a spot on the guides or a single source of truth for these things over time?
    – Hugo
    Commented Jun 26, 2015 at 18:12
  • date and datetime are mapped to date for oracle database. How does active record determine to which data type it should map when fetching?
    – Ali Akbar
    Commented Jan 3, 2023 at 11:14
89

You can access this list everytime you want (even if you don't have Internet access) through:

rails generate model -h
1
  • at 'Available field types:' section
    – yohanes
    Commented Jun 24, 2020 at 4:30
5

Rails4 has some added datatypes for Postgres.

For example, railscast #400 names two of them:

Rails 4 has support for native datatypes in Postgres and we’ll show two of these here, although a lot more are supported: array and hstore. We can store arrays in a string-type column and specify the type for hstore.

Besides, you can also use cidr, inet and macaddr. For more information:

https://blog.engineyard.com/2013/new-in-rails-4

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.