How to Setup UPS Carrier in Your Magento 2 store


United Parcel Service (UPS) is a popular multinational supply chain management and package delivery company headquartered in the United States of America. It’s reliable global logistics company that specializes in retail packaging, shipping, and package delivery. UPS shipping methods support 220+ countries across the globe, making this service a flexible option to deliver goods anywhere in the world.

Setting up UPS Carrier in your Magento 2 store provides incredible credentials that help you correlate any delivery address in both domestic and international scope. This guide will help you configure the UPS Carrier to boost the delivery of your Magento 2 store.


  • UPS shipping account
  • A fully functional Magento 2 store

Step 1:
Applying UPS

Log in to the Admin Panel of your Magento 2 store. Click Stores, then Settings and select the Configuration option.

How to Setup UPS Carrier in Your Magento 2 store

This will take you to a new page. Expand the SALES option and select Shipping Method.

How to Setup UPS Carrier in Your Magento 2 store

Expand the UPS section and select your options as follows:

  • Set Enabled for Checkout option to YES.
  • Select the desired UPS Type. Here you have two options: United Parcel Service and United Parcel Service XML.

If you select United Parcel Service theproceed as follows:

  • Pick your desired options in the Live Account field; Yes instructs UPS to run in mode and present the service as a shipping option for all customers. On the other hand, NO lets UPS to run in test mode.
  • The Gateway URL is ready to use and should not be changed.

How to Setup UPS Carrier in Your Magento 2 store

If you select the United Parcel Service XML, proceed as follows:

  • Enter details for your UPS XML account, that is; User ID, Password, and Access License Number.
  • Set the Mode to Live to allow the sending of information to the UPS shipping system.
  • Next, authenticate the Gateway XML URL to permit the sending of XML files.
  • In the Origin of the Shipment section, select where you want the shipment to initiate. There are numerous options, and it should be easy to find one that complements your store operations.
  • Set the Enable Negotiated Rates to Yes.  This will allow you to use customized rates with the UPS service. Consequently, enter the six-character value in the Shipper Number section.

How to Setup UPS Carrier in Your Magento 2 store

  • Once you set the UPS Type, enter the name of your shipping method in the Title field. The title is displayed during the checkout, if this field is omitted, United Parcel Service will manifest as the default title.

How to Setup UPS Carrier in Your Magento 2 store

Step 2:
Setting Up The Container Description

To complete the container description, do the following:

  • In the Packages Request Type, select one of the following options: Divide to equal weight (one request) or Use Origin weight (few quotes).
  • Next, pick the typical packaging options for the shipment in the Container field.
  • Select the Weight Unit, the weight can either be LBS or KGS.
  • Pick the preferred Destination Type. Residential is perfect if most of the shipment are B2C, and Commercial is ideal for shipments that are mostly B2B.
  • Consult UPS carrier for the maximum supported shipping weight before picking a value for the Maximum Package Weight.
  • Next set the Pickup Method, this can be Customer Counter, Letter Center, One Time Pickup,On Call Air, or Regular Daily Pickup.
  • Set the Minimum Package Weight, to complete the description.

How to Setup UPS Carrier in Your Magento 2 store

Step 3:
Setting Up The Handling Fees

Scroll down to the Calculate Handling Fee field. The handling fees can be calculated either as Fixed or Percent fees.

Next, in the Handling Applied field,  set how you want the fees to be applied. The fees can be applied Per Order or Per Package. Finally, in the Handling Fee, input a value for the fee.

How to Setup UPS Carrier in Your Magento 2 store

Step 4:
Assigning Allowed Methods

  • Magento 2 provides a host of allowed UPS methods offered to online shoppers. Select your preferred option from the Allowed Method list.
  • Scroll down to the Free Method option and set the desired UPS service to be applied for free shipping.
  • Next, in the Displayed Error Message field, enter a customized message to be displayed when the UPS shipping method is not available.

How to Setup UPS Carrier in Your Magento 2 store

To complete the configuration, you need to set the applicable countries. Scroll down to the Ship to Applicable Countries field and set it to either All Allowed Countries Or Specific Countries. If you pick the Specific Countries option, select the applicable country in the Ship to Specific Countries field.

Finally, set the Debug to Yes. This will make it easy to fashion a log file featuring all the details of the UPS shipments. Complete the setup by choosing the Sort Order on your checkout page.

Click Save Config to implement the changes.

How to Setup UPS Carrier in Your Magento 2 store


That is it! You have successfully configured United Parcel Service (UPS) carrier in your Magento 2 store. You can now leverage the power of this incredible service to ship products to the specified destinations.

Check out the top 3 Magento hosting services:

Was this article helpful?