DHL Express - General Settings

You can reach the plugin settings by choosing the WooCommerce → Settings → Shipping → DHL Express from the sidebar.


In order to offer your customers the available DHL Express services for international shipping, you need to own a DHL Express account and enter your credentials (Site ID and Password) in the plugin settings.

If you do not have a DHL Express account yet, check how to create it step by step →.

DHL Express - General Settings - Credentials

API Status

Once your login credentials were entered and Save changes button hit, the API Status should change to OK and turn green.

DHL Express - General Settings - API Status OK

If for some reason the plugin is not able to establish the connection with the DHL Express API, you will see the error message coming from the API with the detailed information on the cause of the problem, e.g.:

DHL Express - General Settings - API Status Authentication Failed

In case you've encountered any problems with authentication and want to learn more about the specific API errors visit the dedicated DHL Express - Common problems and troubleshooting documentation.

Method Settings

DHL Express - General Settings - Method settings

Enable/Disable - tick/untick this option to turn on/off the DHL Express global shipping method. Once it is checked the DHL Express live rates will be displayed for your customers.

Method Title - define the shipping method title which should be used in the cart/checkout when the fallback option was triggered.

Fallback - enable the flat rate fallback cost displayed if the DHL Express API won't return any available services. The DHL Express services may be unavailable for several reasons e.g. missing or incorrect order data (weight, sender's or/and recipient's addresses) but also the DHL Express connection issues. Once the checkbox is ticked the following Fallback Cost field will appear:

DHL Express - General Settings - Method settings - Fallback

Custom Services - tick this checkbox to manage which DHL Express services should be available for your customers to choose from. You may also change their names here and set the order of how they are displayed at the checkout.

If the checkbox is not selected all the services will be available by default.

DHL Express - General Settings - Method settings - Custom Services

PRO Custom Origin - check this option if you want to change the sender's address used to calculate the live rates where the products are shipped from. It's especially useful e.g. when you ship the products directly from the warehouse located in a different place than your shop's address.

The plugin gets the origin from the WooCommerce settings by default ( WooCommerce → Settings → General → Store Address).

Once the Custom Origin option is checked the following fields will appear and you will be able to define the custom sender's address:

DHL Express - General Settings - Method settings - Custom Origin

Rates Adjustments

DHL Express - General Settings - Rates Adjustments

Discounted Rates - enable this option if you want to use the Discounted Rates assigned to your account. If not selected the standard rates will be used by default. Ticking this checkbox will result in displaying the Payment Account Number field required to fill in with your individual PAN identifier:

DHL Express - General Settings - Rates Adjustments - Discounted Rates

Insurance - tick it if you want the insurance to be included in the DHL Express rates. The insurance will be included only for services which it is available for.

PRO Handling Fees - use this option if you want to charge your customers with the handling fees automatically added to the DHL Express live rates:

DHL Express - General Settings - Rates Adjustments - Handling Fees

You can choose if the handling fee should have the Fixed or the Percentage value. Once one of these options is selected the Fee value field allowing to enter the fee's amount will appear below.

Please mind that you can also use the Handling Fees option to offer your customers the discounted DHL Express live rates by entering the negative value, e.g. -10 in the Fee value field.

Parcel Packing Method - define the way how the products should be packed:

DHL Express - General Settings - Rates Adjustments - Parcel Packing Method

  • Pack into one box by weight - a default live rates calculation method. Weight of all the ordered products is summed up and they are considered as shipped together in the one package.
  • Pack items separately - each product is considered as if it was shipped in a separate box. If selected the plugin uses the products' weight and dimensions to calculate their volume and return the shipping rates.
  • PRO Pack into custom boxes - this option gives you a choice which packages to use. You can choose from the standard DHL Express packagings or precisely define your own custom boxes:

DHL Express - General Settings - Rates Adjustments - Pack into custom boxes

It allows not only to set the box dimensions (Length x Width x Height) and maximum weight but also the packaging's (e.g. cardbox') weight and padding which will be substracted from the package max weight and dimensions. The ordered products will be automatically matched to the defined boxes to offer their most optimal setup. If any product exceeds the defined maximum package size the plugin will return the fallback if set.

Some DHL Express services might have a maximum weight limit for the shipped packages. You can find more information including the complete table of DHL Express Weight & Dimensions restrictions here.

Duties & Taxes

DHL Express - General Settings - Duties & Taxes

Dutiable shipment - define when the shipment you send should be considered as dutiable by choosing one of the following options:

  • Never
  • Always (except domestic shipping)
  • Only for selected countries
  • Always, except selected countries and domestic shipping

Once the Only for selected countries or Always, except selected countries and domestic shipping option has been chosen the Selected countries field will appear below:

DHL Express - General Settings - Duties & Taxes - Selected countries field

Use it to point the countries which the option selected in the Dutiable shipment field will be applied to.

Please mind that some DHL Express services' availability may vary depending on whether the country the shipment is addressed to was defined as dutiable or not, e.g. when shipping from Poland to UK, provided that UK has been defined as the country of dutiable shipment, the DHL EXPRESS 12:00, DHL EXPRESS WORLDWIDE and DHL ECONOMY SELECT services are available, however if it hasn't - the DHL EXPRESS 12:00 and DHL EXPRESS WORLDWIDE (DOCUMENTS) become available instead.

Dates & Time PRO

DHL Express - General Settings - Dates and Time

Estimated delivery - a feature allowing to display to your customers the estimated delivery time for the ordered products. You can choose from three options here:

  • None - the estimated delivery time won't be displayed at all.
  • Show estimated days to delivery date - display the amount of days of how long it should take to deliver the ordered products.
  • Show estimated delivery date - display the exact date the ordered products will be delivered.

Once the 2nd or the 3rd option is selected the following additional fields will appear below:

DHL Express - General Settings - Dates and Time - Estimated Delivery options

Maximum Time in Transit - define the maximum amount of days the products can remain in transit. Especially useful for the perishable goods.

Lead Time - define the amount of days required to prepare an order to be shipped. The estimated delivery date or time will be updated according to the value entered here.

Cutoff Time - select the hour after which the date of preparing the shipment will be set for the next day. It can be used only when the Lead Time's value was set to 0.

Blackout Lead Days - choose the days of the week when the orders are not being processed in your shop. The days you select here will be excluded from the lead time, e.g. if your lead time is defined as 2 days and the chosen Blackout Days are Saturday and Sunday, the order placed on Friday will be first processed the following Tuesday.

The estimated delivery time will be displayed as a DHL Express shipping method description in the cart/checkout below its title.

Advanced Options

DHL Express - General Settings - Advanced Options

Debug Mode - enabling the Debug Mode will let you identify and analyze the problems with DHL Express services price calculation. All the requests, responses and the error messages coming back from the DHL Express API will be displayed in the cart and on the order summary page:

DHL Express - General Settings - Advanced Options - Debug Mode

All the notices and data coming from enabled Debug Mode will be visible only for the Site Administrators and Shop Managers. Your customers, no matter if they are guests or logged in, won't see any unnecessary info on the shop's front.

Measurement Units - this option allows you to change the measurement units used to calculate the DHL Express live rates. The plugin uses the units selected in the WooCommerce settings by default. (WooCommerce → Settings → Products → Measurements). Once the measurement units are changed, they will be automatically converted by the plugin to the ones defined here.

Use this option if you get "This measurement system is not valid for the selected country" error.