List custom lists and feeds requirements

Each custom list or feed must be a simple text file no larger than 500 MB. List files must have the .txt extension. Include one entry or comment per line—for example, one IP address, one URL, or one domain name per line.

List and feed formatting

Each custom list or feed must be a simple text file no larger than 500 MB. List files must have the .txt extension. Include one entry or comment per line—for example, one IP address, one URL, or one domain name per line.

Tip

The number of entries is limited by the maximum file size. For example, a URL list with no comments and an average URL length of 100 characters (including Unicode representations and newlines) can support more than 5.24 million entries.

  • In a DNS list entry, you can use an asterisk (*) wildcard character for a domain label. All labels match the wildcard. Example: www.example.* matches www.example.com and www.example.co.

  • Comment lines must start with the pound (#) character.

  • Comments are removed during upload. Files you download contain only the entries, not the comments.

Feed requirements

  • When configuring a feed, specify its location using a URL; the URL cannot be Punycode-encoded.

  • For feed update intervals of 30 minutes or less, you must provide an MD5 URL to prevent frequent downloads of unchanged feeds. If your feed server does not provide an MD5 URL, use a download interval of at least 30 minutes.

  • If you use an MD5 checksum, store it in a simple text file. The file should contain only the checksum. Do not add comments to the file.