Sqids Encoder
Encode one or more nonnegative integers as a short Sqids identifier using the standard alphabet and blocklist.
Description
Encode one or more nonnegative integers into a short Sqids identifier using the standard alphabet and blocklist.
Sqids turns integer sequences into URL-friendly identifiers without exposing the original decimal representation directly. It is deterministic and reversible, which makes it useful for presentation IDs but fundamentally different from encryption or cryptographic hashing.1
When to use Sqids Encoder
Use Sqids when a public-facing route or label should be shorter and less predictable-looking than a raw integer while remaining reversible by the same configuration.
How Sqids Encoder works
The encoder shuffles a configured alphabet, maps each nonnegative integer into that base, inserts separators for multiple values, and retries with another offset if the result matches a blocked word. The default configuration determines interoperability.1
How the Sqids encoding function processes input
- Validate every input as a nonnegative safe integer.
- Choose an alphabet offset derived from the complete number sequence.
- Encode values in the shuffled alphabet with separators between values.
- Apply the standard blocklist rules and return the resulting identifier.
Limitations and assumptions
- Sqids is reversible obfuscation, not encryption; never place secret information in an identifier.
- Different alphabets, minimum lengths, or blocklists can produce different IDs for the same numbers.
- Changing configuration can affect newly encoded IDs, so applications should pin and document it.
Alternative or Complementary approaches
Use UUIDs when identifiers should not depend on central integer IDs. Use a signature or authenticated token when tamper detection or trust is required.
References
-
Sqids specification — Sqids
Similar or alternative tools
- Sqids Decoder
Recover the integer sequence from a standard Sqids ID.
- Base58 Encoder
Encode text bytes with the Bitcoin Base58 alphabet.
- UUID v7 Generator
Generate time-ordered identifiers without exposing a database integer.