Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

YOURLS .POT Listed in Awesome YOURLS! YOURLS Logo

This is the official YOURLS .pot file to generate and maintain your own translations.

Current version : for YOURLS 1.9

(Check the release archives for older versions)

Awesome! How do I create my own translations?

To create your translation :

  1. Download the translation file template YOURLS.pot
  2. Rename it to [your-locale].po, where [your-locale] is typically language code, underscore, country code (for instance in Portugal that would be pt_PT, while in Brazil it’d be pt_BR).
  3. Install a translation software: it’s nothing more than a text editor capable of reading .po files, showing you the untranslated string and a text box where you type in the translation, and saving a .mo file which is what PHP needs. A cross platform, simple yet complete editor is Poedit.
  4. Translate all the strings. You'll have a fully translated pt_BR.po and the generated

To check your translation and load it in YOURLS:

  1. Install the latest YOURLS release
  2. Drop your pt_BR.po and files in user/languages
  3. Add define( 'YOURLS_LANG', 'pt_BR' ) to your config.php
  4. That’s it! Play with YOURLS to check everything is fine

For more details, tips and screenshots, see the related blog post

Awesome! How do I update my translation file?

When the YOURLS.pot template file is updated with new or modified strings to translate, you don't have to start over your translation file.

  1. Download the translation file template YOURLS.pot
  2. Put it in the same directory as your translation file, eg pt_BR.po
  3. In Poedit select Catalogue then Update from POT file. Now translate only the new strings.

Awesome! How do I make my translation available to all?

When your translation file is all fine, make sure others can benefit from you hard work!

  1. Upload your two PO and MO files somewhere on the interweb.
    It's best to use a source control service, such as Github or GitLab: this will make your changes easy to track, your files easy to maintain, and others' contributions easy to implement. If you don’t want to use SVN or Git, a regular hosting (your blog) will be OK
  2. Make it clear for users: a directory with clearly labelled files ( for instance) so they know what to pick.
  3. Open a pull request on and get your translation listed!

What are the available languages already?


Credits and license

Thanks to LeoColomb - L10n was a low priority feature but he threw his patch at my face :)

License is "Do whatever the hell you want with it".


🌍 Official YOURLS .pot file to create and maintain your own YOURLS translation



Code of conduct

Security policy





No packages published