---
title: Using the DeliveryStatusCodes.list File
description: The DeliveryStatusCodes.list file is an optional configuration file that can be created in the Hurricane Server global config directory. This file can be used to control how Hurricane Server interpret
---
[Skip to content](https://help.socketlabs.com/docs/using-the-deliverystatuscodeslist-file#main-content)
English
Show submenu for translations
[Contact us](https://help.socketlabs.com/docs/kb-tickets/new?hsLang=en)
[](https://www.socketlabs.com/)
Open main navigation
Close main navigation
- English
Show submenu for translations
- [Contact us](https://help.socketlabs.com/docs/kb-tickets/new)
SocketLabs is here to help!
- There are no suggestions because the search field is empty.
1. [Help Center](https://help.socketlabs.com/docs?hsLang=en)
2. [Hurricane MTA](https://help.socketlabs.com/docs/hurricane-mta?hsLang=en)
3. [Advanced Hurricane Usage](https://help.socketlabs.com/docs/hurricane-mta?hsLang=en#advanced-hurricane-usage)
# Using the DeliveryStatusCodes.list File
The DeliveryStatusCodes.list file is an optional configuration file that can be created in the Hurricane Server global config directory. This file can be used to control how Hurricane Server interprets the failure responses that it receives from remote ISPs and can optionally be used to fire an alert for specific responses. This functionality is available in Hurricane Server version 1.0.0.734 and later. Each line in the file can consist of up to three values, delimited with the "~*~" character pattern.* The first value is a regular expression that will be compared to each server response received by Hurricane Server when a delivery attempt fails. If a match is made, the remaining values of the line will be used and Hurricane Server will stop processing the file for the specific failure response. For this reason you will achieve better performance by putting the most popular responses toward the top of the file. \[Response Regex\]~~\[Temporary, Permanent\]~~\[Alert\] The second value determines whether Hurricane Server considers the response an indication of a permanent or temporary error. Valid values are "Temporary" or "Permanent". Any other value, including no value at all, will cause Hurricane Server to treat the response as permanent if it begins with a "5". Temporary responses will cause Hurricane Server to defer the message (put it into the deferral queue to be retried again later).
In the event of a temporary failure response for a message which is older than the expiration time specified in the Hurricane Server deferral settings, the response will still be considered temporary. The message will fail, however, and no further delivery attempts will be made. Permanent responses will cause the message to fail and no further delivery attempts will be made. In addition to controlling the deferral processing, the Temporary/Permanent status will be reported in the type parameter of the OnFail() plugin API event. The third value may contain the word "Alert" which will cause Hurricane Server to fire a Hurricane Server Delivery Alert for the response. Hurricane Server Delivery Alert mechanisms can be modified through the Hurricane Server web console alerts configuration. Any other value, including no value at all, will not cause an alert to be fired. The "#" character can be placed at the beginning of any line in this file to comment it out. Here is a sample file: #\[Response Regex\]~~\[Temporary, Permanent\]~~\[Alert\] # complaints~~Temporary~~Alert Policy~~~\*~Alert
- [Fundamentals](https://help.socketlabs.com/docs/fundamentals?hsLang=en#main-content)
- [StreamScore](https://help.socketlabs.com/docs/fundamentals?hsLang=en#streamscore)
- [Reports](https://help.socketlabs.com/docs/fundamentals?hsLang=en#reports)
- [Frequently Asked Questions](https://help.socketlabs.com/docs/fundamentals?hsLang=en#frequently-asked-questions)
- [Advanced](https://help.socketlabs.com/docs/advanced?hsLang=en#main-content)
- [Security](https://help.socketlabs.com/docs/advanced?hsLang=en#security)
- [DNS Authentication](https://help.socketlabs.com/docs/dns-authentication?hsLang=en#main-content)
- [DKIM](https://help.socketlabs.com/docs/dns-authentication?hsLang=en#dkim)
- [SPF and Custom Bounce Domain](https://help.socketlabs.com/docs/dns-authentication?hsLang=en#spf-and-custom-bounce-domain)
- [Deliverability](https://help.socketlabs.com/docs/deliverability?hsLang=en)
- [For Developers](https://help.socketlabs.com/docs/for-developers?hsLang=en#main-content)
- [Event Webhooks](https://help.socketlabs.com/docs/for-developers?hsLang=en#event-webhooks)
- [Integrations](https://help.socketlabs.com/docs/integrations?hsLang=en#main-content)
- [Languages and Frameworks](https://help.socketlabs.com/docs/integrations?hsLang=en#languages-and-frameworks)
- [Mail Servers](https://help.socketlabs.com/docs/integrations?hsLang=en#mail-servers)
- [Web Clients and Plug-ins](https://help.socketlabs.com/docs/integrations?hsLang=en#web-clients-and-plug-ins)
- [Mail Clients](https://help.socketlabs.com/docs/integrations?hsLang=en#mail-clients)
- [Marketing Tools](https://help.socketlabs.com/docs/marketing-tools?hsLang=en#main-content)
- [Tips and Tricks](https://help.socketlabs.com/docs/marketing-tools?hsLang=en#tips-and-tricks)
- [Troubleshooting](https://help.socketlabs.com/docs/troubleshooting?hsLang=en#main-content)
- [SocketLabs Inbound SMTP Gateway Errors](https://help.socketlabs.com/docs/troubleshooting?hsLang=en#socketlabs-inbound-smtp-gateway-errors)
- [SocketLabs Outbound SMTP Errors](https://help.socketlabs.com/docs/troubleshooting?hsLang=en#socketlabs-outbound-smtp-errors)
- [Spotlight Email Analytics](https://help.socketlabs.com/docs/spotlight-email-analytics?hsLang=en)
- [Hurricane MTA](https://help.socketlabs.com/docs/hurricane-mta?hsLang=en#main-content)
- [Advanced Hurricane Usage](https://help.socketlabs.com/docs/hurricane-mta?hsLang=en#advanced-hurricane-usage)
- [Upgrading Hurricane](https://help.socketlabs.com/docs/hurricane-mta?hsLang=en#upgrading-hurricane)
- [Troubleshooting](https://help.socketlabs.com/docs/hurricane-mta?hsLang=en#troubleshooting)
- [Hurricane Maintenance](https://help.socketlabs.com/docs/hurricane-mta?hsLang=en#hurricane-maintenance)
- [Getting Started with Hurricane](https://help.socketlabs.com/docs/hurricane-mta?hsLang=en#getting-started-with-hurricane)
- [Basic Hurricane Usage](https://help.socketlabs.com/docs/hurricane-mta?hsLang=en#basic-hurricane-usage)
- [Complex Sender](https://help.socketlabs.com/docs/complex-sender?hsLang=en)
[](https://www.socketlabs.com)
Copyright © 2026, SocketLabs LLC