Skip to content

Slugify

Slugify (slugify)

Generate stable slugs from one or more fields.

Transform json

Minimal example

actions:
- slugify: {}
JSON
{
"actions": [
{
"slugify": {}
}
]
}

Contents

Fields

FieldTypeRequiredDescription
descriptionstringdescribe this step.
conditionlua-expression (string)Only run this action if the specified condition is met.
Examples: 2 * count()
source-fieldsstring[]Ordered list of fields whose values will be concatenated.
output-fieldfield (string)Field that receives the resulting slug (defaults to ‘slug’).
Examples: data_field
separatorstringString inserted between tokens (defaults to ’-’).
caseCaseCase transformation applied before slugification.
Allowed values: lower, upper, title, preserve
max-lengthnumber (integer)Maximum slug length; longer slugs are truncated.
Examples: 42, 1.2e-10
stop-wordsstring[]Tokens removed before slugification (case-insensitive).
collision-strategyCollision StrategyStrategy used when the slug collides with an existing value.
Allowed values: error, append-counter, append-hash

Schema

Case Options

ValueDescription
lowerLower
upperUpper
titleTitle
preservePreserve

Collision Strategy Options

ValueDescription
errorError
append-counterAppend Counter
append-hashAppend Hash