Username policy
Rules for user, organization, and bot handles on Trylle.
Trylle uses one synchronized handle for your dashboard profile, Forgejo account, repository owner path, and Git URLs. Organization handles and bot slugs follow the same syntax.
Allowed usernames
A username must:
- Be 1–40 characters long.
- Use only ASCII letters (
A–Z,a–z), numbers (0–9), hyphens (-), and underscores (_). - Contain at least one letter or number.
- Use no more than three consecutive hyphens or underscores in a mixed separator run.
Leading and trailing separators are allowed. Dots, spaces, and other symbols are not accepted in free-form username fields.
Trylle preserves the capitalization you choose. Uniqueness is case-insensitive, however, so Alice, alice, and ALICE all refer to the same unavailable name.
Generated usernames
When a username comes from a new social sign-in or another automatic source, Trylle normalizes it before creating the account:
- Each sequence of unsupported characters becomes one underscore.
- Separator runs longer than three characters become three underscores.
- Values longer than 40 characters are truncated.
- A deterministic suffix is added when the normalized name is already occupied.
For example, kyo$shi.@.ma becomes kyo_shi_ma.
Connecting a social provider to an existing Trylle account never changes its established handle.
Renames
A rename updates the Forgejo account, repository owner namespace, dashboard identity, and authentication profile together. Existing repository links redirect from the old owner path, while the bare repositories are moved to the new owner namespace on the Git host.
If one part of a rename cannot be committed, Trylle reports the failure and keeps an idempotent reconciliation path for an administrator. A partially completed rename is never reported as successful.
Reserved names
Trylle reserves names needed by application routes, static assets, Forgejo internals, deleted-user sentinels, and system automation.
The following trust-role names are also protected case-insensitively: administrator, help, moderator, official, root, security, staff, support, system, and verified.
trylle, names beginning with trylle-, and names beginning with trylle_ are reserved for official identities provisioned by Trylle administrators. A different capitalization does not bypass a reservation.