Browse by Topic

Setting up FedEx for Shipping Quotes

One of the real time shipping quote services provided on BigCommerce is FedEx. In order to display shipping quotes for FedEx services, you need to set up a FedEx developer account and integrate it into your BigCommerce store. If you've negotiated rates with FedEx, you'll have the option to pass these savings on to your shoppers. See Resources for Shipping with FedEx for more information about service limits, rate calculation, and troubleshooting common issues and errors.


Getting your FedEx Account Details

If you don’t have an account, visit to create one.

1. Go to the FedEx Developer Resource Center's Solution Finder and click on FedEx Web Services.  Then, click the Move to Production link and log into your account.

Move to Production button under the Web Services section of the FedEx Solution Finder

2. Click on the Get Production Key that appears under the production menu.

Get Production Key button under the production menu of the FedEx Solution Finder

3. On the following page, you will see a license agreement. Check the boxes indicating that you have read and agree to the terms of service, then click I Accept.

Check that you have read and agree to the terms and conditions in the license agreement, and acknowledge that you will not distribute software with the same functionality.

4. Fill out the application profile on the following screen. Choose:

  • Do you intend to resell your software: No
  • FedEx web services you intend to use: Check FedEx Web Services for Shipping
  • Are you a corporate developer or a consultant: Choose Corporate Developer

Click Continue when you are done.

The Application Profile screen.

5. You will be brought to another license agreement. Read the terms and conditions and click I accept when you are finished.

Accept the terms and conditions outlined in the license agreement

6. Now you will need to fill out your contact information. Please note that you cannot have any special characters within the address fields. Watch out for ".", "#", or other non-number or non-letter characters as it may cause a failure. Click Continue when you are done.

Your Account Number can be found by logging into your FedEx account and going to My ProfileAccount Management.

Fill out the contact information form, avoiding the use of any special characters. Click continue when done.

7. If you wish to update your developer account with the information, check the box on the next screen, and click the Continue button.

If you wish to update your developer account with the information you have just provided, check the box.

8. You will now see your Access confirmation.


This information, which includes the Authentication Key, will not be accessible later unless you contact FedEx support; we recommend that you print this page for your records.

The FedEx Web Services access confirmation screen.

9. After a few moments, you will receive an email from Online Services with the subject line, "Your developer Production Key Registration is complete". It contains your Production Password, FedEx Account Number, and Production Meter Number. Use this production password as your password in the following steps, not the one you created to access the FedEx account.


Enabling FedEx

After following the steps above, you should have the following data:

  • Authentication Key (from Step 8 above)
  • Production Password (from Online Services email)
  • FedEx Account Number (from Online Services email)
  • Production Meter Number (from Step 8 above or Online Services email)

1. Go to Store Settings › Shipping.

2. Click Configure or Edit beside the zone for which you wish to setup FedEx.

Configure highlighted next to a shipping zone in Shipping Manager

3. Turn on the toggle switch beside FedEx.

Fedex enabled in shipping zone details

4. In the Settings tab, you can adjust your Display name, which your shoppers see when selecting the delivery method at checkout and when estimating shipping and tax on the cart page. Configure your settings for Drop-off Type, Packaging Type, Packing Method, Rate Type, Include Package Value and Destination Type. For Delivery Services, check the box next to the services you want to provide quotes for.


Which delivery services should I pick? If you have a packaging type that has the word FedEx in it, then it only applies to Express Services, if you need ground/home delivery, make sure your packaging type is "your packaging".

FedEx Settings

If no package value is declared, FedEx is only liable up to $100 for each package in a shipment.

5. Under the Connection tab, enter your Key, Password, Account Number and Meter Number provided by FedEx.

FedEx Connection Tab

6. Click Submit to save your changes. You can test to see if your settings are working by editing the FedEx shipping method and going to the Quote tab.

FedEx Quote Tab

You should also do some front-end testing so you can see what the quoting process looks like to your shoppers.



FedEx Support

FedEx’s dedicated support site has answers, information, and resources to assist you will all your shipping needs. There you can find service details and contact information.

FedEx Weight, Length, and Girth Limits

ServiceWeight LimitDimensions Limit
FedEx Express US150 lbs119" length; up to 165" length + girth combined
FedEx Express International150 lbs108" length; up to 130" length + girth combined
FedEx Ground150 lbs108" length; up to 165" length + girth combined
FedEx Home Delivery70 lbs108" length; up to 165" length + girth combined
FedEx Express FreightIndividual skids of 150 lbs or moreSkids exceeding 2,200 lbs or 70" height, 119" length, or 80" width require prior approval

FedEx also includes good information on their website regarding general packing and shipping best practices and recommendations.

Service Specifics and Rate Calculation

FedEx details delivery times and service availability areas for all services in their FedEx 2018 Service Guide (PDF).


Ground or Home Delivery? FedEx Ground is for commercial shipments, while FedEx Home Delivery is for residential shipments. Home-based businesses do not qualify as a commercial address.

FedEx also provides a Rate and Transit Time Calculator. Using this in conjunction with the Service Guide can prove useful when trying to find which FedEx services make the most sense for you, your products, and your customers. This tool can also help identify any additional handling fees or surcharges that are being returned with your quotes. These extra charges are not expressly lined out in the control panel or to customers on the storefront.

  • weight
  • length
  • girth (2 x width) + (2 x height)
  • dimensional weight
  • distance traveled (fuel surcharge)
  • declared value (the combined retail value of all the items inside a package)
  • the origin zip code
  • destination type (residential or commercial address)
  • destination zip code (Delivery area surcharge)
  • packaging type (yours or FedEx-supplied)
  • service type (e.g. Ground, Express, Home Delivery)
  • negotiated pricing for your specific FedEx account
  • any additional handling fees or surcharges for shipments exceeding FedEx's limits (see Fees and Other Shipping Information in FedEx's Service Guide)

FedEx Real Time Quotes Common Issues and Errors

Common Issues

Symptom: Returned quotes on the storefront are higher than what is displayed on FedEx's Rates and Transit Times Calculator.

Possible causes:

  • The package calculated by BigCommerce is heavier or larger than the dimensions you've entered into FedEx's Rates and Transit Times Calculator for comparison.
  • One or more of the dimensions of the package is exceeding FedEx's limits and has additional handling fees or surcharges included in the returned quote. These charges are lined out on FedEx's calculator but are not explicit when returning a quote on the BigCommerce's storefront or control panel. (See Fees and Other Shipping Information in FedEx's Service Guide)
  • Declared value isn't enabled in your FedEx control panel settings.
    • Some merchants who sell small yet expensive products, like jewelry, prefer to use cost instead of price for package value. Disabling Include Package Value may result in more accurate quotes in this case.
    • Some Canadian merchants prefer to use USD as their default currency. Shipping from Canada to Canada will cause an error and prevent the quote from being generated. Disabling Package Value can solve for this.
  • The Packing Method in your FedEx settings is set to "Each item in its own package".

Symptom: Certain services completely fail to return a quote.

Possible causes:

  • The package may exceed FedEx's maximum serviceable length for that particular service. Minor overages will trigger additional handling fees and surcharges as mentioned above, but extreme overages may render the package completely incompatible, thus failing to return a quote at all.
  • The destination address or country may fall outside of that particular service's specific service area.
  • The origin zip code may be wrong or incomplete. Where possible, use the full nine-digit zip code for your origin address in the Shipping Manager.

Common causes for errors include:

  • Incorrect credentials
  • No service selected or a setting not selected
  • Using FedEx Ground instead of Ground Home Delivery
  • Trying to send to an unserved country

For a complete list of FedEx errors, see FedEx's Appendix O: Error Codes.


Was this article helpful?