Skip to content


Subversion checkout URL

You can clone with
Download ZIP


Kunal Shah edited this page · 12 revisions



To change the tag list delimiter, do this in your config/initializers/acts_as_taggable_on.rb:

ActsAsTaggableOn.delimiter = ' ' # use space as delimiter

If you would like to remove unused tag objects after removing taggings, add

ActsAsTaggableOn.remove_unused_tags = true

If you want force tags to be saved downcased:

ActsAsTaggableOn.force_lowercase = true

If you want tags to be saved parametrized (you can redefine to_param as well):

ActsAsTaggableOn.force_parameterize = true

If you want tags to be matched case-sensitively:

ActsAsTaggableOn.strict_case_match = true

Counter Cache

ActsAsTaggableOn updates a counter cache on tagging operations between the Tag and Tagging model. If you are encountering deadlocks, perhaps while tagging many ActiveRecord objects in a queue, you can turn disable the tag counter cache:

ActsAsTaggableOn.tags_counter = false 

and reset counters afterward with:

ActsAsTaggableOn::Tag.pluck(:id).each do |id|
   ActsAsTaggableOn::Tag.reset_counters(id, :taggings)

An alternate solution is calculating the counter cache less often and asynchronously using a queue.

Something went wrong with that request. Please try again.