FedEx – General Settings

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


In order to offer your customers the available FedEx shipping services based on the order details, you will need to create a FedEx account first and fill the fields below with the credentials acquired during the registration process.

It is required to establish the connection with the FedEx shipping system and make the plugin work. If you have not created a FedEx account yet, check how to obtain FedEx credentials →.

If you want to use credentials from the test FedEx account, add the following filter to your functions.php file: add_filter('flexible_shipping_fedex_testing','__return_true');

API Status

After you enter your login credentials and Save changes, the API Status should change to OK.

If the plugin is not able to connect to the FedEx’s API, you will see a specific error message.

In this case, check your login credentials. If they are entered correctly, and you still get error, please contact FedEx support. 

Method Settings

Shipping Method Type

– select if you want to use the Standard shipping methods and add the ‘FedEx Live Rates’ shipping method within specific shipping zones, or choose the Global shipping method to enable the FedEx Live Rates for all the shipping zones in your store at once.Please mind that If you are using the FedEx Live Rates free version or Shipping Method Type: Global shipping method was selected, adding the standard single FedEx Live Rates shipping method within a shipping zone will not be possible until the Shipping Method Type is changed or plugin upgraded to its PRO version.

Please mind that if the aforementioned Shipping Method Type: Standard shipping methods was selected, the Method Title, Fallback and Custom Services options as well as the settings available in the Rates Adjustments and Dates & Time sections will be moved to the FedEx Live Rates shipping method configuration screen in the shipping zone it was added within.Learn how to add FedEx Live Rates shipping method within specific shipping zone step by step →

Method Title

– set method title that will be displayed in the checkout page when fallback will be enabled.


– tick this checkbox to enable the flat rate fallback cost if the FedEx API response won’t return any services available. The FedEx services may be unavailable for several reasons e.g. missing or incorrect order data (weight, sender’s / recipient’s addresses) but also the FedEx API connection issues. After the checkbox is ticked the following Fallback Cost field will appear:

Custom Services

– tick this checkbox if you want to manage which FedEx services should be available for your customers to choose from. You may also change their names here and set the order how they are displayed at the checkout.

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

Available FedEx services’ list

  • FedEx 2Day A.M.
  • FedEx 2Day
  • FedEx Express Saver
  • FedEx Ground
  • FedEx Ground Home Delivery
  • FedEx Ground Economy (Formerly known as SmartPost)
  • FedEx International Connect Plus
  • FedEx International Economy
  • FedEx International Ground
  • FedEx Europe First International Priority
  • FedEx Overnight
  • FedEx Priority Overnight
  • FedEx Standard Overnight
  • FedEx Regional Economy
  • FedEx International First
  • FedEx International Priority
  • FedEx Distance Deferred
  • FedEx Next Day Afternoon
  • FedEx Next Day Early Morning
  • FedEx Next Day End of Day
  • FedEx Next Day Freight
  • FedEx Next Day Mid Morning

Ground Home Delivery service is the equivalent of the FedEx Ground service for Residential address type. If you want to offer FedEx Ground service, change your Destination Address Type to BusinessFedEx Home Delivery is available only in the USA. 


PRO Custom Origin

By default, the plugin gets the origin from the WooCommerce settings. You can change this address using a dedicated option.

Please be advised that each shipping method that uses FedEx plugin can have its own Custom Origin. To learn more about Multiple Custom Origins feature – read this article →

Rates Adjustments


– If you want to include shipment insurance in the shipment amount, check this option. The insurance will be included only for services where the insurance option is available.

Rate Type

– define which rates type should be used choosing from  All possible rates (default), List rates or Account rates.

In order to obtain the Account rates on your FedEx account please contact FedEx support to activate them first.

If you already have the Account rates assigned and activated on your FedEx user account but want to display the standard ones (List rates) to your customers, please choose the Rate Type: All possible rates option.

PRO Rate Currency

Select this option if you sell in other currency then it is set on your FedEx account. FedEx account’s currency is used by default.

PRO Handling Fees

This option allows you to add a commission or rebate to rates collected from FedEx. The setting is global, which means that commissions will apply to all bids on the order page. To add a rebate just enter negative value. 

Possible ways to calculate fees:

  • Fixed,
  • Percentage.

Destination Address Type – choose which type of destination address –  Business or Residential should be used by default.

Please mind that our plugins uses the domestic FedEx Ground Home Delivery services.Mind that not every service visible here may be available to pick by the customer every time depending on the package weight, origin and destination.

PRO One Rate Pricing 

This option will only appear in the plugin configuration window if the store’s origin is in the United States. Tick the checkbox next to  Enable to get One Rate Pricing if you want to display the One Rate Pricing to your U.S. customers.

PRO Parcel packing method

Possible options to choose from:

  • Pack into one box by weight – this is the default method for calculating bids. Allows you to choose your packaging or one of the FedEx standard packages. To ship using FedEx One Rate, you must select one of the FedEx packagings.
  • Pack items separately – each product is a separate box in one shipping. Allows you to choose your packaging or one of the FedEx standard packages. To ship using FedEx One Rate, you must select one of the FedEx packagings.  
  • Pack into custom boxes – allows you to choose which packages you want to use. You can choose one of standard FedEx package or set your own custom box. It also allows you to set box weight and padding, that will be deducted from max weight and dimensions of the package. The products in the basket will be adjusted in order from the smallest to the largest to the selected package types. If a product exceeds the size of the package, the plug will return the fallback if it has been set.

The products packing algorithm will automatically choose the most optimal combination of packagings used for shipping in order to offer your customers the lowest possible shipping cost.

If you have defined your own custom boxes and you use them in combination with the FedEx standard packagings to ship your products, the used package type will be passed as the PackagingType attribute’s property if there is only one package or several packages of the same type. However, if there are several packages and their types vary YOUR_PACKAGING will be used as the PackagingType instead.

To make it clear let’s take a look at the example – if you have selected the default FedEx 10kg Box and FedEx 25kg Box in the Shipping boxes table to pack and ship the ordered products:

and the ordered products fit into one FedEx 10kg Box or the several boxes of the same type, it will be passed to FedEx API as PackagingType: FEDEX_10KG_BOX:

However, if two different types of default FedEx packagings were used for shipping, e.g. FedEx 10kg Box and FedEx 25kg Box or a custom box you’ve defined on your own, the PackagingType value sent in the API request will be changed to YOUR_PACKAGING:

Dates & Time

PRO 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:

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 Tuesday and Wednesday, the order placed on Monday will be first processed the following Friday.The estimated delivery time will be displayed as a FedEx shipping method description in the cart/checkout below its title.

Please mind that if Saturday and Sunday were not excluded from the Lead Time by selecting them in the Blackout Lead Days field and the order processing time falls on a weekend, the FedEx API will not display the estimated delivery time in such case.

Advanced Options

Debug Mode

– Enabling the Debug Mode will let you identify and analyse the problems with FedEx services price calculation. After turning it on, all the requests, responses and the error messages coming back from the FedEx API will be displayed in the cart and on the order summary page.All the notices and data generated by enabling the Debug Mode will be visible only for the Site Administrators and Shop Managers. Your customers, no matter if they are guests or they are logged in, won’t see any unnecessary info in the shop’s frontend.

Measurement Units

– This option allows you to change measurement units for live rates. By default the plugin uses store’s settings. If you switch units, they will be converted to units required by FedEx. Use this option if you get “This measurement system is not valid for the selected country” error. 

Scroll to Top