mozilla

unicode-slugify: Create Unicode-Friendly Text Slugs

unicode-slugify is a Python library for creating URL-friendly slugs while preserving Unicode characters, with an option to transliterate to ASCII. It suits applications that need readable slugs for multilingual text.

InactivePythonBSD-3-ClauseLibraryText ProcessingSlug Generation
View on GitHub Compare
Stars
326
Forks
53
Stars, last 30 days
+1
Last commit
2.8 years ago
Contributors
12

Our take

Inactiveno commits in over a year

Health score

31/100

How it is scored
Activity
19
Community
62
Issues
21
Pull requests
20

+1 stars in the last 30 days

This is a focused Python utility for Unicode-aware slug generation, but its long period without commits or releases makes ongoing maintenance uncertain.

Good fit if

  • You need Python code that preserves Unicode in generated slugs, with optional ASCII transliteration.
  • Your slug rules need configurable casing, separators, or allowed characters.
  • The BSD-3-Clause license fits your project, and you are comfortable assessing an inactive dependency.

Look elsewhere if

  • You require recent maintenance, releases, or active issue and pull-request handling. The repository has had no commits in over a year and no releases in the past year.
  • Your project needs a documented test suite or continuous integration; neither is indicated in the repository data.
  • You need guarantees about current compatibility or support beyond what the repository provides.
All health signals
Last commit2024-01-27 (2.8 years ago)
Commits, last 90 days0
Releases, last 12 months0
Contributors12 (top contributor: 31% of commits)
Issues closed, last 90 days0
Pull requests merged, last 90 days0
Project age15 years

Checked on 2026-11-02 with the GitHub API.

Project history

Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.

Selected snapshot

Stars

326

Forks

53

Change since Nov 16, 2026: 0 stars·0 forks

Overview

unicode-slugify is a Python slugifier that creates readable slugs from text while retaining Unicode characters. It was originally used for Firefox Add-ons pages, where add-on and collection names could include characters that simple transliteration would not handle well.

You can choose lowercase or preserve capitalization, replace spaces with a selected separator, restrict allowed characters, or request ASCII output. This makes it useful for applications that need slugs to reflect multilingual names rather than discard or flatten their original characters.

Key Features

  • Preserves Unicode characters in slugs by default.
  • Can transliterate non-ASCII text to an ASCII representation with only_ascii=True.
  • Supports lowercase output or preservation of capitalization.
  • Replaces spaces with a configurable allowed character, enabling formats such as snake_case.
  • Lets callers customize the set of characters allowed in the result.
  • Handles punctuation and spacing as part of slug generation.

Use Cases

  • A Python web application can generate readable slugs for multilingual page titles while retaining their original scripts.
  • A content-management system can create ASCII-only URLs when a downstream system or URL policy requires them.
  • A catalogue of add-ons, products, or collections can use names containing Unicode without relying on basic transliteration alone.
  • A developer can adapt the output to a project-specific convention, such as underscore-separated or capitalized slugs.

What you need

Detected in the repository

  • Python (from setup.py)

License in plain words

BSD-3-Clausepermissive

  • Commercial use: yes
  • Modify and redistribute: yes
  • You must keep: the copyright and license notice; the authors' names cannot endorse your product
  • Share your changes: no

A summary, not legal advice: the LICENSE file is what applies.

Getting Started

The README demonstrates importing slugify and SLUG_OK from slugify. See the README for usage examples and options.

Alternatives

  • awesome-slugify: awesome-slugify adds configurable replacements and unique-slug generation alongside Unicode preservation and transliteration.
  • python-slugify: python-slugify offers configurable transliteration and Unicode retention, with output rules that may differ from unicode-slugify.
ProjectLanguageLicenseStarsStatus
unicode-slugifyPythonBSD-3-Clause326Inactive
awesome-slugifyPython–490Inactive
python-slugifyPythonMIT1.6kActive

Considerations

The repository is marked inactive, with no commits in over a year and no recent releases. It has a dozen contributors, and contribution is not concentrated in one person, but the available health data shows no recent issue closures or merged pull requests. Python is the listed runtime; the repository data indicates no CI or tests. Review compatibility and behavior against your own requirements before adopting it.

Found this useful?

Share it with someone who would like unicode-slugify.

Comparisons