Latest commit 44a843b Mar 22, 2013 Caleb Clark updated patch version number to 1.1.1
Failed to load latest commit information.
spec updated tests so they pass Mar 22, 2013
.gitignore updated version to 1.0.0-pre Mar 22, 2013
Gemfile updated version to 1.0.0-pre Mar 23, 2013
README.textile updated version to 1.0.0 and added documentation for Mongoid 2.x vs M… Mar 22, 2013
init.rb initial commit May 7, 2010
mongoid_taggable.gemspec updated patch version number to 1.1.1 Mar 22, 2013


Mongoid Taggable

Mongoid Taggable provides some helpers to create taggable documents.


You can install from rubygems:

gem install mongoid_taggable

or in Gemfile:

gem 'mongoid_taggable'

or as a Rails Plugin:

script/plugin install git://

Mongoid 2 vs Mongoid 3

All gem versions less than 1.x only support Mongoid 2 while versions 1.x and greater support Mongoid 3.

Basic Usage

To make a document taggable you need to include Mongoid::Taggable into your document:

class Post
  include Mongoid::Document
  include Mongoid::Taggable

  field :title
  field :content

And in your form:

<% form_for @post do |f| %>
    <%= f.label :title %><br />
    <%= f.text_field :title %>
    <%= f.label :content %><br />
    <%= f.text_area :content %>
    <%= f.label :tags %><br />
    <%= f.text_field :tags %>
    <button type="submit">Send</button>
<% end %>

In this case, the text fields for tags should receive the list of tags separated by comma (See below for how to change the separator).

Then your document will have the tags and tags_array getter and setter. tags is as a plain string with tags separated by comma, and tags_array an array representation.

Finding Objects by Tag

Tagged models get a scope called tagged_with, tagged_with_all, and tagged_with_any:

MyModel.tagged_with_all('foo', 'bar')
MyModel.tagged_with_all(['foo', 'bar'])
MyModel.tagged_with_any('foo', 'bar')
MyModel.tagged_with_any(['foo', 'bar'])

Tags Indexing

This module will automatically create an index of tags and their counts for you after saving the document. This can be used for a tag cloud. See the following example to understand how to use it:

Post.create!(:tags => "food,ant,bee")
Post.create!(:tags => "juice,food,bee,zip")
Post.create!(:tags => "honey,strip,food")

Post.tags # will retrieve ["ant", "bee", "food", "honey", "juice", "strip", "zip"]
Post.tags_with_weight # will retrieve:
# [
#   ['ant', 1],
#   ['bee', 2],
#   ['food', 3],
#   ['honey', 1],
#   ['juice', 1],
#   ['strip', 1],
#   ['zip', 1]
# ]

The tags index is unaffected by default_scopes. If enabled, all tags will be indexed regardless of other attribute values.
p. If you don’t want to use this feature, it is good to disable it to improve performance:

class Post
  include Mongoid::Document
  include Mongoid::Taggable

  disable_tags_index! # will disable index creation

  field :title
  field :content

Changing default separator

To change the default separator you may call the tags_separator class method:

class Post
  include Mongoid::Document
  include Mongoid::Taggable

  tags_separator ';' # will change tags separator to ;

  field :title
  field :content