Sequel plugin to obscure your primary keys with a hashid
Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

Sequel Hash ID

Easily obfuscate your Integer-based primary keys in Sequel models. The anonymity of a UUID without any overhead.

These are commonly used for URL shorteners, but they have other use cases as well. Specifically, they are very handy to prevent nieve crawling / scraping, where your records are known to be incremental.


Add this line to your application's Gemfile:

gem "sequel-hash_id"

And then execute:

$ bundle

Or install it yourself as:

$ gem install sequel-hash_id


This plugin likely only makes sense at the Model level, so configure it for each model you want to have a hashid for. The only required option is the salt you wish to use.

plugin :hash_id, salt: "your-salt".freeze

Once you've done that, you can now access the following methods:

# Get the instance's hashid
instance = YourModel.create

# Lookup using a hashid

# Dataset lookup method
YourModel.where { ... }.with_hashid("the-hashid")


Bug reports and pull requests are welcome on GitHub at

I love pull requests! If you fork this project and modify it, please ping me to see if your changes can be incorporated back into this project.

That said, if your feature idea is nontrivial, you should probably open an issue to discuss it before attempting a pull request.


The gem is available as open source under the terms of the MIT License.