serialize(attr_name, class_name_or_coder = Object, **options) public

If you have an attribute that needs to be saved to the database as an object, and retrieved as the same object, then specify the name of that attribute using this method and it will be handled automatically. The serialization is done through YAML. If class_name is specified, the serialized object must be of that class on assignment and retrieval. Otherwise SerializationTypeMismatch will be raised.

Empty objects as {}, in the case of Hash, or [], in the case of Array, will always be persisted as null.

Keep in mind that database adapters handle certain serialization tasks for you. For instance: json and jsonb types in PostgreSQL will be converted between JSON object/array syntax and Ruby Hash or Array objects transparently. There is no need to use #serialize in this case.

For more complex cases, such as conversion to or from your application domain objects, consider using the ActiveRecord::Attributes API.


  • attr_name - The field name that should be serialized.

  • class_name_or_coder - Optional, a coder object, which responds to .load and .dump or a class name that the object type should be equal to.


default The default value to use when no value is provided. If this option is not passed, the previous default value (if any) will be used. Otherwise, the default will be nil.


# Serialize a preferences attribute.
class User < ActiveRecord::Base
  serialize :preferences

# Serialize preferences using JSON as coder.
class User < ActiveRecord::Base
  serialize :preferences, JSON

# Serialize preferences as Hash using YAML coder.
class User < ActiveRecord::Base
  serialize :preferences, Hash
Show source
Register or log in to add new notes.
September 11, 2012 - (>= v3.1.0)
1 thank

Custom serialization

It is possible to supply a class with own (de)serialization logic to the serialize call. Given object must respond to load and dump calls.

Following example serializes symbols into their string representation and store them in database as raw strings instead of their YAML representation, i.e. :pumpkin would be stored as ‘pumpkin’, and not as ‘--- :pumpkin\n’


clas SomeModel < ActiveRecord::Base
  class SymbolWrapper
    def self.load(string)

    def self.dump(symbol)

  serialize :value, SymbolWrapper