Automatically slugifies a source field.

Downloads in past


3.1.05 years ago6 years agoMinified + gzip package size for objection-slugify in KB


Build Status Coverage Status
Slugged models for Objection.js
This plugin will automatically generate slugs for your model based on a source field and a slug field. It will also generate unique slugs by checking to see if the slug already exists in the model's table.


npm install objection-slugify --save


// Import the plugin.
const slugifyPlugin = require('objection-slugify');
const { Model } = require('objection');

// Mixin the plugin.
const slugify = slugifyPlugin({
  sourceField: 'title',
  slugField: 'slug'

// Create your model.
class Post extends slugify(Model) {
  // ...code

const post = await Post.query().insert({
  title: 'How to Fry an Egg'

// how-to-fry-an-egg


sourceField (required)

The source of the slugged content.

slugField (defaults to slug)

The field to store the slug on.

update (defaults to true)

Specifies whether the slug is updated when the source field is updated.

unique (defaults to false)

Checks to see if the generated slug is unique in the table. If not, it will append a UUID to the end of the slug.

generateUniqueSuffix (Function: String)

A custom function that returns a string. Can be used to generate a custom suffix to the end of the slug. If unique is true and this is not specified, a random UUID will be appended to the slug.

slugifyOptions (defaults to { lower: true } )

A set of options for the internal slugify library, options available here.