ruby
27 lines · 7 steps
How URL slugs work in Rails
An Article generates a unique, URL-safe slug before validation and uses it in route helpers.
Explained by
highlit
1class Article < ApplicationRecord
2 before_validation :generate_slug, on: :create
3
4 validates :slug, presence: true, uniqueness: true,
5 format: { with: /\A[a-z0-9]+(?:-[a-z0-9]+)*\z/ }
6
7 def to_param
8 slug
9 end
10
11 private
12
13 def generate_slug
14 return if slug.present? || title.blank?
15
16 base = title.parameterize
17 candidate = base
18 suffix = 2
19
20 while self.class.where(slug: candidate).exists?
21 candidate = "#{base}-#{suffix}"
22 suffix += 1
23 end
24
25 self.slug = candidate
26 end
27end
01 / 01
STEP 01
‹ swipe to step through ›
Walkthrough
Space play
←→ step
click any line
Three takeaways
- 1A before_validation callback lets you derive a field before the same field's validations run.
- 2Looping while a uniqueness query matches guarantees a collision-free slug at generation time.
- 3Overriding to_param makes Rails route helpers use a readable identifier instead of the numeric id.
Related explainers
ruby
require "csv" class SalesReport def initialize(path)
Aggregating CSV sales data in Ruby
data-aggregation
memoization
group_by
Intermediate
6 steps
ruby
module DurationFormatter UNITS = [ ['week', 604_800], ['day', 86_400],
Turning seconds into human-readable durations in Ruby
greedy-decomposition
modular-arithmetic
formatting
Intermediate
7 steps
javascript
const express = require('express'); const v1 = express.Router();
Versioning an API with Express Routers
api versioning
routing
modularity
Intermediate
10 steps
ruby
class Comment < ApplicationRecord belongs_to :post belongs_to :author, class_name: "User"
Live-updating comments with Turbo in Rails
turbo-streams
callbacks
associations
Intermediate
8 steps
ruby
require 'json' require 'set' class SensitiveScrubber
Recursively scrubbing secrets from JSON
recursion
data-masking
pattern-matching
Intermediate
7 steps
ruby
class ReportBatcher BATCH_SIZE = 500 def initialize(account)
Batching monthly email summaries in Rails
batching
service-object
background-jobs
Intermediate
7 steps
Share this explainer
Here's the card — post it anywhere.
Made with highlit — turn any snippet into a walkthrough like this in about a minute.
Explain your code
Embed this explainer
Drop the interactive walkthrough into a blog or docs. Views never cost a credit.
<iframe src="https://highlit.co/explainers/how-url-slugs-work-in-rails-explained-ruby-9e0f/embed?autoplay=1" width="100%" height="520" loading="lazy" style="border:0"></iframe>
Autoplay is on by default — add ?autoplay=0 to start paused.