slugify

Slugify

Generate PocketBase slugs from one or more record fields.

The plugin combines configured input fields in order, normalizes the text to lowercase alphanumeric segments separated by hyphens, truncates the result to the configured length, and adds numeric suffixes when needed to keep slugs unique.

Installation

Build PocketBase with the plugin:

xpb build --with github.com/mjadobson/pb-plugin-slug@latest

Setup

Add the plugin config to your pocketbuilds.toml:

[slugify]

[[slugify.configs]]
collection_name = "posts"
input_fields = ["title", "subtitle"]
output_field = "slug"
length = 64

[[slugify.configs]]
collection_name = "pages"
input_fields = ["title"]
output_field = "slug"
length = 32

Then make sure each collection has:

• the fields listed in input_fields
• a text or editor field matching output_field
• a single-column UNIQUE index on output_field (recommended with WHERE output_field != '')

The plugin runs after successful record create and update operations.

Unique Index Requirement

output_field must have its own single-column unique index.

This plugin checks for existing slugs before saving, but concurrent writes can still race unless the database also enforces uniqueness. The unique index is what guarantees two records cannot end up with the same slug.

For SQLite-backed PocketBase collections, a good pattern is:

CREATE UNIQUE INDEX `idx_posts_slug_unique` ON `posts` (`slug`) WHERE `slug` != ''

Replace posts and slug with your collection and field names.

Plugin Config

configs

An array of slug rules.

configs[].collection_name

The PocketBase collection name to watch.

configs[].input_fields

The fields to combine, in order, before generating the slug.

configs[].output_field

The text or editor field where the slug should be written.

configs[].length

The maximum slug length.

Behaviour

• Input field values are joined with spaces in config order.
• Accents are removed where possible.
• Non-alphanumeric characters become hyphens.
• Repeated separators are collapsed and trimmed.
• Slugs are lowercased and truncated to length.
• If the slug already exists in the same collection, -1, -2, and so on are appended while staying within length.
• If all configured inputs are blank, the output slug is cleared.
• The output field must have its own unique index so concurrent writes cannot create duplicate slugs.

Development

go mod tidy
GOCACHE=/tmp/go-build go test ./...
GOCACHE=/tmp/go-build go build ./...