big-list-of-naughty-strings README

The project's README from github.com/minimaxir/big-list-of-naughty-strings. As one markdown file: README.md.

Big List of Naughty Strings

The Big List of Naughty Strings is an evolving list of strings which have a high probability of causing issues when used as user-input data. This is intended for use in helping both automated and manual QA testing; useful for whenever your QA engineer walks into a bar.

Why Test Naughty Strings?

Even multi-billion dollar companies with huge amounts of automated testing can't find every bad input. For example, look at what happens when you try to Tweet a zero-width space (U+200B) on Twitter:

Although this is not a malicious error, and typical users aren't Tweeting weird unicode, an "internal server error" for unexpected input is never a positive experience for the user, and may in fact be a symptom of deeper string-validation issues. The Big List of Naughty Strings is intended to help reveal such issues.

Usage

blns.txt consists of newline-delimited strings and comments which are preceded with #. The comments divide the strings into sections for easy manual reading and copy/pasting into input forms. For those who want to access the strings programmatically, a blns.json file is provided containing an array with all the comments stripped out (the scripts folder contains a Python script used to generate the blns.json).

Contributions

Feel free to send a pull request to add more strings, or additional sections. However, please do not send pull requests with very-long strings (255+ characters), as that makes the list much more difficult to view.

Likewise, please do not send pull requests which compromise manual usability of the file. This includes the EICAR test string, which can cause the file to be flagged by antivirus scanners, and files which alter the encoding of blns.txt. Also, do not send a null character (U+0000) string, as it changes the file format on GitHub to binary and renders it unreadable in pull requests. Finally, when adding or removing a string please update all files when you perform a pull request.

Disclaimer

The Big List of Naughty Strings is intended to be used for software you own and manage. Some of the Naughty Strings can indicate security vulnerabilities, and as a result using such strings with third-party software may be a crime. The maintainer is not responsible for any negative actions that result from the use of the list.

Additionally, the Big List of Naughty Strings is not a fully-comprehensive substitute for formal security/penetration testing for your service.

Library / Packages

Various implementations of the Big List of Naughty Strings have made it to various package managers. Those are maintained by outside parties, but can be found here:

Library Link
Node https://www.npmjs.com/package/blns
Node https://www.npmjs.com/package/big-list-of-naughty-strings
.NET https://github.com/SimonCropp/NaughtyStrings
PHP https://github.com/mattsparks/blns-php
C++ https://github.com/eliabieri/blnscpp

Please open a PR to list others.

Maintainer/Creator

Max Woolf (@minimaxir)

Social Media Discussions

License

MIT

big-list-of-naughty-strings (minimaxir/big-list-of-naughty-strings)

Searching Database…

What is this?It is a curated collection of strings with a high probability of breaking software when used as user input, meant to help QA testing of input validation.
Is this a testing tool or just a plain data file?It is just data, not a tool: a human-readable blns.txt with comments and sections, plus a stripped-down blns.json array for programmatic use.
How do I actually use these strings in my tests?Copy/paste strings from blns.txt into input forms for manual QA, or load blns.json into your automated test suite to feed as inputs.
Are there any rules about what can be added to the list?Contributors are asked to avoid very-long strings (255+ characters), the EICAR antivirus test string, and null characters, since these break manual readability or corrupt the file on GitHub.
Who is this list meant for?QA engineers and developers who need to stress-test input validation, encoding handling, and unicode edge cases in their applications.
Are there packages for other programming languages?Yes, community-maintained implementations exist for Node, .NET, PHP, and C++ package managers, linked from the README.
Why does testing with naughty strings matter in practice?Even large companies miss edge cases; the README cites tweeting a zero-width space (U+200B) on Twitter causing an internal server error, showing how unexpected input breaks real systems.
Is the list still being updated?Yes, it is described as an evolving list, and the maintainer (Max Woolf) accepts pull requests adding new strings or sections.
Creator
minimaxir
Size
0.3 MB
Stars
47.7K
Updated
CommitApr 17
Age
11y
Commits · 90 Days