Last update: 2023-10-05
  • Created for:
  • Beginner

FedEx is one of the world’s largest shipping service companies, providing air, freight, and ground shipping services with several levels of priorities.

FedEx Shipping Options at Checkout

FedEx can use dimensional weight to determine some shipping rates. However, Adobe Commerce and Magento Open Source support only weight-based shipping cost calculation.

Step 1: Register for FedEx Web Services Production

A FedEx merchant account and registration for FedEx Web Services Production Access is required. After creating a FedEx account, read through the production account information page, then click the Obtain Production Key link at the bottom of the page to register and obtain a key.


Make sure to copy or write down the authentication key. It is required to set up FedEx in your Commerce shipping settings.

Step 2: Enable FedEx for Your Store


2.4.7-beta2 There are updates included in the 2.4.7-beta2 release that provide enhancements to the described functionality. If you are using this release version, review the release notes for detailed information about the changes.

  1. On the Admin sidebar, go to Stores > Settings > Configuration.

  2. In the left panel, expand Sales and choose Delivery Methods.

  3. Expand Expansion selector the FedEx section.

  4. Set Enabled for Checkout to Yes.

  5. For Title, enter a title that identifies the FedEx shipping method during checkout.

  6. Enter the following information from your FedEx account:

    • Account ID
    • Meter Number
    • Key
    • Password
  7. If you have set up a FedEx sandbox and want to work in the testing environment, set Sandbox Mode to Yes.


    Remember to set Sandbox Mode to No when you are ready to offer FedEx as a shipping method to your customers.

    FedEx Account Settings

Step 3: Package description and handling fee

  1. Select the Packages Request Type to the option that best describes your preference when splitting an order into multiple shipments:

    • Divide to equal weight (one request)
    • Use origin weight (few requests)
  2. Select the type of Packaging typically used to ship products from your store.

  3. Set Dropoff to the pick-up method used for delivery.

    • Regular Pickup - If you have a high volume of shipments, it can be cost effective to make arrangements with FedEx for regular pickups.

    • Request Courier - You must call and request a FedEx courier to pick up shipments.

    • Drop Box - You must drop off shipments at your nearby FedEx drop off box.

    • Business Service Center - You must drop off shipments at your local FedEx business service center.

    • Station - You must drop off shipments at your local FedEx station.

  4. Set Weight Unit to the unit of measurement that is used in your locale.

    • Pounds
    • Kilograms
  5. Enter the Maximum Package Weight allowed for FedEx shipments.

    The default FedEx maximum weight is 150 lbs. Consult your shipping carrier for more information. The default value is recommended, unless you have made special arrangements with FedEx. See Dimensional weight for more information.

    FedEx Package Settings
  6. Configure the handling fee options according to your requirements.

    The handling fee is optional and is not visible during checkout. If you want to include a handling fee, do the following:

    • Set Calculate Handling Fee:

      • Fixed Fee
      • Percentage
    • For Handling Applied, choose one of the following methods for managing handling fees:

      • Per Order
      • Per Package
    • Enter the Handling Fee as either a fixed amount or percentage, depending on the method of calculation.

  7. Set Residential Delivery to one of the following, depending on whether you sell Business-to-Consumer (B2C) or Business-to-Business (B2B).

    • Yes - For B2C residential deliveries.
    • No - For B2B residential deliveries.
    FedEx Handling Fee Settings

Step 4: Allowed methods and applicable countries

  1. Set Allowed Methods to each method of shipment that you want to offer.

    When choosing methods, consider your FedEx account, the frequency and size of your shipments, and if you allow international shipments. You can offer as many or as few methods as you want, such as:

    • Europe First Priority
    • Delivery day options: 1 Day Freight, 2 Day Freight, 2-Day, 2-Day AM, 3 Day Freight
    • Domestic options–Express Saver, Ground, First, Overnight, Home Delivery, Standard Overnight
    • International options–International Economy, Intl Economy Freight, International First, International Ground, International, Priority Intl
    • Priority options–Freight, Priority Overnight
    • Smart Post–If offering the Smart Post method (enter the Hub ID)
    • Freight options–Freight, National Freight
  2. If you want to provide a Free Shipping option through FedEx, set the free shipping options.

    • Set Free Method to the method you want to use for free shipping. If you do not want to offer free shipping through FedEx, choose None.

    • To require a minimum order amount that qualifies an order for free shipping with FedEx, set Enable Free Shipping Threshold to Enable. Then, enter the minimum value in Free Shipping Amount Threshold.

    This setting is similar to the one for the standard Free Shipping method, but appears in the FedEx section during checkout, so customers know which method is used for their order.

  3. If needed, change the Displayed Error Message.

    This text box is preset with a default message, but you can enter a different message that you want to appear if FedEx becomes unavailable.

    FedEx Allowed Delivery Methods
  4. Set Ship to Applicable Countries:

    • All Allowed Countries - Customers from all countries specified in your store configuration can use this delivery method.

    • Specific Countries - When you choose this option, the Ship to Specific Countries list appears. Select each country in the list where this delivery method can be used.

  5. If you want to keep a log of all communication between your store and the FedEx system, set Debug to Yes.

  6. Set Show Method if Not Applicable:

    • Yes - Shows all FedEx shipping methods to customers, regardless of their availability.
    • No - Shows only the FedEx shipping methods that apply to the order.
  7. For Sort Order, enter a number to determine the sequence in which FedEx appears when listed with other delivery methods during checkout.

    0 = first, 1 = second, 2 = third, and so on.

  8. Click Save Config.

    FedEx Applicable Countries

Commerce always declares the full order price to FedEx when calculating shipping charges. This behavior cannot be changed.

On this page