> ## Documentation Index
> Fetch the complete documentation index at: https://support.blackbirdsec.eu/llms.txt
> Use this file to discover all available pages before exploring further.

# Upload Custom Wordlists

> Learn how to upload a custom wordlist to use within BLACKBIRD for fuzzing.

## Upload a Custom Wordlist

Let's walk through the process of uploading a custom wordlist on your BLACKBIRD Web App Pentesting Suite:

<Steps>
  <Step title="Navigate to New Wordlist Section">
    Navigate to the Wordlists section: [/wordlists](https://app.blackbirdsec.eu/wordlists) and click on "New Wordlist"

    <img src="https://mintcdn.com/novasecurity/bnD-0b9ht-jotL_z/images/wordlists/upload-custom-wordlists-step-1.png?fit=max&auto=format&n=bnD-0b9ht-jotL_z&q=85&s=6c9f25c6ff5e96fb184f1d0c406dba7a" width="1785" height="886" data-path="images/wordlists/upload-custom-wordlists-step-1.png" />
  </Step>

  <Step title="Provide a Wordlist Name">
    Provide a name for your wordlist, this will help you identify it later on.

    <img src="https://mintcdn.com/novasecurity/O1hDkRPKGCDsFL8U/images/wordlists/upload-custom-wordlists-step-2.png?fit=max&auto=format&n=O1hDkRPKGCDsFL8U&q=85&s=29818de0c7eb35d54973c522b9c70d28" width="1877" height="885" data-path="images/wordlists/upload-custom-wordlists-step-2.png" />
  </Step>

  <Step title="Upload Your Wordlist">
    Finally, click on "Upload Wordlist" to select the wordlist file you'd want to upload and click on "Upload".

    <Warning>
      Depending on how big your wordlist file is, it may take a while to upload it. **Do NOT navigate away from the page while uploading.**
    </Warning>

    [Read and follow the best practices](/wordlists/upload-custom-wordlists#best-practices) mentioned below for more information regarding the specific formats your wordlist must adhere to.

    <img src="https://mintcdn.com/novasecurity/O1hDkRPKGCDsFL8U/images/wordlists/upload-custom-wordlists-step-3.png?fit=max&auto=format&n=O1hDkRPKGCDsFL8U&q=85&s=26cbf937111f0d88ea35d676cec38e67" width="1879" height="883" data-path="images/wordlists/upload-custom-wordlists-step-3.png" />
  </Step>
</Steps>

### Best Practices

* Make sure your wordlist is in plain text format (.txt and UTF-8 encoding)
* Separate each word or entry with a new line
* Comments in wordlist files are automatically ignored

### Limitations

Currently, every customer is only allowed to **upload wordlists of up to 500 MB.** Exceeding this limit will throw a warning and instruct you to delete unused wordlists to free up space.

## Using A Custom Wordlist

Once you've uploaded your custom wordlist, you can now start using it. Learn more about [how to use your custom wordlist](/wordlists/wordlists#using-a-wordlist).