MX Guarddog provides the ability to upload CSV formatted blocklisting instructions, allowing a domain admin to manage their email and domain blocklist. In addition to adding to the blocklist there are a few additional actions that can be performed, this document will explain available commands and how to use them.

Adding To Your Blocklist

• Adding email addresses or domains can be done by uploading a list, with one entry per line. Adding to your blocklist is the default action so no additional command is required.
• Sample CSV format:

  ---

  [email protected]
  example.com
  *.example.com
  *.cn

  ---

• The above will add four new entries to your blocklist.
  • Block all email from email address [email protected]
  • Block all email coming from any email address at the domain example.com
  • Block all email coming from subdomain under example.com, such as mailing.example.com
  • Block all email coming from the China TLD. This would include any domain such as example.cn or example.gov.cn

Deleting From Your Blocklist

• If you already have items in your blocklist, you can remove them with the delete command.
• Sample CSV format:

  ---

  [email protected]
  example.com,delete
  *.example.com
  *.cn

  ---

• The above will add three new entries to your blocklist and delete example.com because the delete command has been included at the end of the domain name.

Marking A Domain To Be Vanished

• When you blocklist a domain name, you have the option to vanish any mail from the domain. A domain that has the vanish option will not appear in quarantine, it simply goes away never to be seen again.
• Sample CSV format:

  ---

  [email protected]
  example.com,vanish
  *.example.com
  *.cn

  ---

• The vanish command in the above CSV file will make all email coming from example.com vanish, it will not be saved to quarantine. The vanish option is available for domain names only, it does not apply to email addresses.

Removing The Vanish Option

• If you have a domain in your blocklist with the vanish option enabled, it is possible to remove the option with CSV as well.
• Sample CSV format:

  ---

  [email protected]
  example.com
  *.example.com
  *.cn

  ---

• We have previously blocklisted the domain example.com, with the vanish option. If we wanted to remove the vanish option but keep the domain blocklisted we can do that by including the domain in the CSV content but leaving out the vanish option.